Parâmetros de URL do checkout

Esta é a referência para quem gera links de checkout no código, por exemplo numa página de vendas, num e-mail transacional ou num CRM. O que cada parâmetro faz para o comprador, com exemplos para o lojista, está em Link de pagamento e parâmetros de URL.

O endereço baseCopiar link da seção

https://pay.vipter.com/<slug-ou-id-da-oferta>

Quando o link não pode abrir, o checkout redireciona para /unavailable?reason=<motivo>. O motivo fica no endereço para diagnóstico:

ParâmetrosCopiar link da seção

Todos são opcionais e a ordem não importa. Um parâmetro repetido vale pelo primeiro valor. Parâmetros desconhecidos são ignorados.

Reservados: rec é o token do link de recuperação de checkout abandonado, que vem pronto no recovery_url do evento checkout.abandoned. ctx é de uso interno do Vipter. Não monte links com eles.

O checkout não aceita telefone, documento nem endereço por URL.

Regras de cada parâmetroCopiar link da seção

packCopiar link da seção

Só ofertas de pagamento único têm pacotes. Numa oferta de assinatura, qualquer pack leva à página de link indisponível. Sem o parâmetro, o link vende 1 unidade pelo preço da oferta. O checkout não tem seletor de pacote: um link por pacote.

langCopiar link da seção

O idioma do link vence a regra da loja que vende para um só país, que esconde o seletor e usa o idioma daquele país. O checkout guarda a escolha no cookie pay_locale por um ano, e as visitas seguintes sem lang usam esse cookie. Numa loja de um país só, o cookie não é usado: só o lang do próprio link muda o idioma.

Origem da campanha: UTMs, src e sckCopiar link da seção

Valem como primeiro toque: o primeiro link que trouxe utm_*, src ou sck para aquele navegador nos últimos 30 dias define todos esses valores juntos. Um link posterior com outra campanha não troca nenhum deles. O checkout guarda esses dados no localStorage do domínio do checkout, na chave vpt_attr, e o prazo de 30 dias conta da primeira vez que algo foi guardado.

IDs de clique, cookies e vCopiar link da seção

Valem pelo último valor recebido: um clique novo num anúncio troca o gclid guardado, e o último link de vendedor aberto define o v. Quando chega um fbclid sem fbc, o checkout monta o fbc no formato fb.1.<milissegundos>.<fbclid>. O código v é conferido quando o checkout cria a sessão de pagamento: vale o vendedor ativo naquele momento.

email e nameCopiar link da seção

O endereço de entrada que o Vipter guarda com a venda sai sem email, name, phone, rec e ctx. Mesmo assim, esses dados ficam no histórico do navegador e nos logs de quem serve a página anterior. Use email e name só em links individuais, como num e-mail para um cliente, nunca em anúncios ou páginas públicas.

Para onde os dados vãoCopiar link da seção

• O vendedor (v) fica no pedido e entra nas comissões.
• UTMs, src, sck e IDs de clique ficam na venda, alimentam a origem das vendas e o envio de conversões para as plataformas de anúncio.
• As UTMs vão no campo utm do evento checkout.abandoned. Os eventos de pedido não trazem UTMs nem vendedor.

Montar links no códigoCopiar link da seção

Codifique cada valor. Um + sem codificar, comum em e-mails como ana+loja@example.com, vira espaço. Use as funções da linguagem em vez de concatenar texto:

function checkoutLink(base, params) {
  const url = new URL(base);
  for (const [key, value] of Object.entries(params)) {
    if (value !== undefined && value !== null && value !== '') url.searchParams.set(key, String(value));
  }
  return url.toString();
}

checkoutLink('https://pay.vipter.com/kit-cha', { pack: 3, code: 'BLACK10', v: 'ana', utm_source: 'instagram', utm_campaign: 'black-friday' });
// https://pay.vipter.com/kit-cha?pack=3&code=BLACK10&v=ana&utm_source=instagram&utm_campaign=black-friday

checkoutLink('https://pay.vipter.com/curso-fotografia', { email: 'ana+teste@example.com', name: 'Ana Souza', lang: 'pt' });
// https://pay.vipter.com/curso-fotografia?email=ana%2Bteste%40example.com&name=Ana+Souza&lang=pt

Em Python, urllib.parse.urlencode gera a mesma query:

from urllib.parse import urlencode

"https://pay.vipter.com/curso-fotografia?" + urlencode({"email": "ana+teste@example.com", "name": "Ana Souza", "lang": "pt"})
# https://pay.vipter.com/curso-fotografia?email=ana%2Bteste%40example.com&name=Ana+Souza&lang=pt

+ e %20 valem como espaço no checkout. Se a sua página de vendas já tem UTMs no endereço, o script t.js leva esses valores até o link sem código.

O que fazer a seguirCopiar link da seção

• Veja como o comprador vê o checkout.
• Leve as UTMs da página de vendas até o checkout com o script t.js.