Como usar parâmetros GET para preencher e personalizar o Eduzz Checkout?
Os parâmetros GET (informações adicionadas ao final do link) permitem abrir o Eduzz Checkout com dados já preenchidos e configurações específicas, como número de parcelas, cupom ou afiliado. Para usá-los, basta acrescentar os parâmetros ao link do seu checkout.
Como adicionar parâmetros ao link
- O primeiro parâmetro deve vir depois do símbolo “?”.
- Cada parâmetro seguinte deve vir depois do símbolo “&”.
- Se o link do seu checkout já tiver um “?”, use “&” para todos os parâmetros que adicionar.
- Espaços e caracteres especiais são convertidos automaticamente. Por exemplo, o espaço vira %20.
Formato geral: link-do-checkout?parametro1=valor¶metro2=valor
Exemplos de uso
Clique nos links abaixo para ver a diferença entre os dois exemplos:
Exemplo 1: o checkout abre com o nome do cliente já preenchido.
Exemplo 2: o checkout abre com todos os dados do cliente preenchidos e com o parcelamento em 5x pré-selecionado. Repare que o “?” aparece só uma vez, e os demais parâmetros usam “&”.
Dados utilizados no Exemplo 2:
- Nome: Cliente (
?nome=Cliente) - E-mail: cliente@teste.com (
&email=cliente@teste.com) - Documento: 12345678901 (
&doc=12345678901) - Celular: (15) 99999-9999 (
&cel=15999999999) - Parcelamento: 5x (
&p=5)
Lista completa de parâmetros
Nas colunas de compatibilidade, Sim indica que o parâmetro funciona naquele checkout e Não indica que não funciona.
Dados do cliente
| Parâmetro | O que faz | Exemplo | Checkout Padrão | Checkout Elements |
|---|---|---|---|---|
nome ou name |
Preenche o nome do cliente. | ?nome=Eduzz Tecnologia - LTDA |
Sim | Sim |
email |
Preenche o e-mail do cliente. | ?email=cliente@teste.com |
Sim | Sim |
doc |
Preenche o documento (CPF, CNPJ ou documento estrangeiro). | ?doc=51306227906 ou ?doc=09573540000139 |
Sim | Sim |
cel ou phone |
Preenche o celular ou telefone. Comece pelo DDD (dois dígitos) e use apenas números. | ?cel=15991300567 |
Sim | Sim |
df |
Aceita somente documento de Pessoa Física (CPF). | ?df=1 |
Sim | Não |
dj |
Aceita somente documento de Pessoa Jurídica (CNPJ). | ?dj=1 |
Sim | Não |
Endereço
| Parâmetro | O que faz | Exemplo | Checkout Padrão | Checkout Elements |
|---|---|---|---|---|
cep ou zip |
Preenche o CEP ou ZIP. Use apenas números. O endereço é carregado automaticamente a partir do CEP. | ?cep=18047690 |
Sim | Sim |
state |
Preenche o estado. | ?state=SP |
Sim | Não |
city |
Preenche a cidade. | ?city=São Paulo |
Sim | Não |
street |
Preenche a rua. | ?street=Rua das Flores |
Sim | Não |
district |
Preenche o bairro. | ?district=Centro |
Sim | Não |
num |
Preenche o número do endereço. | ?num=500 |
Sim | Sim |
without_number |
Indica que o endereço não tem número (S/N). | ?without_number=1 |
Não | Sim |
comp |
Preenche o complemento do endereço. | ?comp=24B |
Sim | Sim |
Parcelas e formas de pagamento
| Parâmetro | O que faz | Exemplo | Checkout Padrão | Checkout Elements |
|---|---|---|---|---|
p |
Pré-seleciona o número de parcelas. Com p=2, o valor já vem parcelado em 2x. |
https://sun.eduzz.com/SEU_ID?p=2 |
Sim | Sim |
pf |
Obriga o cliente a escolher o número de parcelas: nenhuma opção vem selecionada. | ?pf=1 |
Sim | Sim |
np |
Define o número máximo de parcelas exibidas no checkout. | ?np=4 |
Sim | Sim |
b |
Exibe ou oculta o boleto. Com b=1 a opção aparece, com b=0 ela não aparece. |
?b=0 ou ?b=1 |
Sim | Sim |
Vencimento da fatura
| Parâmetro | O que faz | Exemplo | Checkout Padrão | Checkout Elements |
|---|---|---|---|---|
dv |
Define o vencimento em número de dias a partir de hoje. Com dv=5, o vencimento será daqui a 5 dias. |
?dv=5 |
Sim | Sim |
dd |
Define uma data específica de vencimento. Formatos aceitos: aaaa-mm-dd, dd-mm-aaaa, aaaa/mm/dd e mm/dd/aaaa. | ?dd=31-12-2026 |
Sim | Sim |
Afiliado, cupom, país e moeda
| Parâmetro | O que faz | Exemplo | Checkout Padrão | Checkout Elements |
|---|---|---|---|---|
a |
Associa a venda a um afiliado, pelo ID dele. | ?a=67177 |
Sim | Sim |
cupom |
Aplica um cupom de desconto, pela chave do cupom. | ?cupom=EDZ130OFF |
Sim | Sim |
country |
Seleciona um país específico (código ISO 3166-1 alpha-3). | ?country=BRA ou ?country=ARG |
Sim | Sim |
currency |
Altera a moeda, o idioma e o país do checkout de acordo com a moeda escolhida. | ?currency=EUR |
Sim | Sim |
Rastreamento (UTM)
| Parâmetro | O que faz | Exemplo | Checkout Padrão | Checkout Elements |
|---|---|---|---|---|
utm_source |
Identifica a origem do tráfego. | ?utm_source=google |
Sim | Sim |
utm_medium |
Identifica a mídia utilizada. | ?utm_medium=e-mail |
Sim | Sim |
utm_campaign |
Identifica o nome da campanha. | ?utm_campaign=CampanhaDeLancamento |
Sim | Sim |
utm_content |
Identifica o conteúdo ou anúncio que gerou o clique. | ?utm_content=bannerPromocao |
Sim | Sim |
Comportamento do checkout
| Parâmetro | O que faz | Exemplo | Checkout Padrão | Checkout Elements |
|---|---|---|---|---|
u |
Ativa a cobrança automática do Upsell One Click. Saiba mais no artigo sobre Upsell One Click. | ?u=1 |
Sim | Sim |
skip |
No template hotsite, pula o preenchimento dos dados pessoais quando eles já foram enviados por parâmetro. O checkout valida os dados: se algum estiver incorreto, permanece na etapa 1 para o cliente corrigir. |
|
Sim | Não |
showDescription |
Exibe a descrição do produto antes do formulário, depois da imagem e do título do conteúdo. | ?showDescription=1 |
Não | Sim |
Ao combinar os parâmetros, você personaliza o checkout para cada campanha, canal e perfil de cliente.