Checkout

Parâmetros da URL

A URL do checkout é uma API de marketing: pré-preenche o formulário, aplica cupom, escolhe o parcelamento, esconde métodos de pagamento e carrega a origem do tráfego pra dentro da venda.

Formato

Todo parâmetro é opcional e entra como query string normal. Valor inválido é ignorado em silêncio — a URL nunca quebra o checkout.

text

https://devexpay.com.br/checkout/{slug}?name=Maria&email=maria@email.com&coupon=BLACK50&utm_source=facebook

Sempre passe os valores codificados (encodeURIComponent). Espaço vira %20, arroba pode ir literal.

Pré-preenchimento

Corta campos do formulário pra quem veio de uma lista, de um formulário de captura ou de um link de recuperação de carrinho. As máscaras (CPF, telefone, CEP) são aplicadas automaticamente.

Parâmetro	O que faz	Exemplo
name nome	Nome completo do comprador. Máx. 80 caracteres.	name=Maria%20Silva
email mail	E-mail. Ignorado se o formato for inválido.	email=maria@email.com
doc cpf · cnpj · document	CPF (11 dígitos) ou CNPJ (14). Com ou sem máscara — a máscara é aplicada sozinha.	doc=12345678909
phone telefone · celular · whatsapp	DDD + número (10 ou 11 dígitos).	phone=11988887777
zip cep · zipcode	CEP com 8 dígitos. Dispara o autocompletar de endereço via ViaCEP.	zip=01310930

Oferta e pagamento

Parâmetro	O que faz	Exemplo
coupon cupom	Aplica o cupom sozinho ao abrir o checkout. Só A-Z, 0-9, hífen e underline.	coupon=BLACK50
split parcelas · installments	Nº de parcelas pré-selecionado (1 a 24). Ainda respeita o máximo da oferta.	split=12
hidePix hide_pix	Esconde o Pix do seletor de método.	hidePix=1
hideCard hide_card	Esconde o cartão de crédito.	hideCard=1
hideBoleto hide_boleto	Esconde o boleto.	hideBoleto=1

Os hide* aceitam 1, true, sim — ou a chave sozinha (?hidePix). Existe uma trava: se a URL tentar esconder todos os métodos, o pedido é ignorado e a oferta aparece como está configurada.

text

# Só Pix, com cupom aplicado
https://devexpay.com.br/checkout/curso?hideCard=1&hideBoleto=1&coupon=PIX10

# Cartão em 12x já selecionado
https://devexpay.com.br/checkout/curso?hidePix=1&hideBoleto=1&split=12

Origem do tráfego

As UTMs são capturadas na abertura do checkout e persistidas na venda (coluna sales.utm), junto com o referrer e a landing. É o que permite responder “qual criativo pagou essa venda”.

Parâmetro	O que faz	Exemplo
utm_source	Origem do tráfego. Gravada na venda.	utm_source=facebook
utm_medium	Mídia. Gravada na venda.	utm_medium=cpc
utm_campaign	Campanha. Gravada na venda.	utm_campaign=black-friday
utm_content	Criativo/anúncio. Gravado na venda.	utm_content=criativo-07
utm_term	Termo/palavra-chave. Gravado na venda.	utm_term=curso-ingles
src sck · origem	Origem curta livre — usada por afiliado e gestor de tráfego.	src=lista-quente
ref	Código do afiliado. Atribui a comissão da venda.	ref=joaosilva

json

// sales.utm
{
  "utm_source": "facebook",
  "utm_medium": "cpc",
  "utm_campaign": "black-friday",
  "utm_content": "criativo-07",
  "utm_term": "curso-ingles",
  "src": "lista-quente",
  "referrer": "https://www.facebook.com/",
  "landing": "/checkout/curso?utm_source=facebook&..."
}

Pixels da oferta

Independente da URL, cada oferta pode ter Meta Pixel, TikTok Pixel e GA4 configurados em Painel → Ofertas → editar. Sem ID configurado, nenhum script de terceiro é carregado.

Momento	Meta	TikTok	GA4
Abriu o checkout	PageView	Pageview	page_view
Viu a oferta	ViewContent	ViewContent	view_item
Começou a preencher	InitiateCheckout	InitiateCheckout	begin_checkout
Pagamento aprovado	Purchase	CompletePayment	purchase

Receitas prontas

text

# Anúncio no Meta, atribuição completa
?utm_source=facebook&utm_medium=cpc&utm_campaign=bf26&utm_content=video-a

# Link pra lista de e-mail (nome e e-mail já preenchidos)
?name={{nome}}&email={{email}}&utm_source=email&utm_campaign=reativacao

# Recuperação de carrinho no WhatsApp
?name=Maria&email=maria@email.com&doc=12345678909&phone=11988887777&coupon=VOLTA10

# Link de afiliado com origem própria
?ref=joaosilva&src=stories&utm_source=instagram&utm_medium=organic

Privacidade

Dado pessoal em URL vira histórico de navegador, log de servidor e referrer. Use pré-preenchimento só em links individuais (e-mail, WhatsApp, recuperação de carrinho) — nunca em anúncio público ou post. Para tráfego pago, use só os parâmetros de origem.