Personalizar o checkout

A página de pagamento é sua, não nossa. Logo, cor, idioma, rastreamento e o caminho de volta pro seu site são configurados por checkout — em cada Offer e em cada QuickLink, não na conta.

Fica no checkout de propósito: numa mesma conta convivem produtos de donos diferentes (coprodução, afiliado, cliente de agência). Quem compra precisa reconhecer a marca de quem vende aquele produto, e quem anuncia precisa medir a campanha daquele produto no pixel dele.

POST /v2/offers          (ou /v2/quick-links)
  checkoutLogoUrl      → logo no topo
  checkoutBrandColor   → botão de pagar e destaques
  checkoutLocale       → idioma da página
  metaPixelId          → conversão na Meta
  googleAdsId + Label  → conversão no Google Ads
  tiktokPixelId        → conversão no TikTok
  successUrl           → volta pro seu site depois de pagar
  failureUrl           → caminho de quando o pagamento é recusado

Marca

checkoutLogoUrl aparece no topo, no lugar do nome da loja. Sem logo, mostramos um selo com as iniciais na cor da marca.

checkoutBrandColor é hex (#RRGGBB) e pinta o botão de pagar e os destaques. O contraste do texto sobre ela é calculado sozinho: cor clara recebe texto escuro, cor escura recebe texto claro — você escolhe a cor sem se preocupar com legibilidade.

O rodapé mostra a razão social e o documento do titular da conta. Isso não é campo: sai do seu cadastro aprovado, porque quem cobra é quem recebe o dinheiro.

Idioma

Por padrão o idioma vem da moeda da conta:

checkoutLocale (pt-BR, es, en) sobrescreve isso. Use só quando você cobra numa moeda e vende para outro público.

Fora do português, os campos de CPF e telefone somem do formulário — quem compra de fora não tem CPF pra digitar. A cobrança é criada normalmente.

Rastreamento de conversão

Informe só o ID, nunca o script inteiro. Sem ID preenchido, nenhum script de terceiro é carregado na sua página de pagamento.

O evento de compra dispara quando o pagamento é confirmado — inclusive no Pix, que confirma depois de o comprador pagar. Ele é contado uma vez por transação: o Pix fica consultando o status, e sem essa trava cada retorno contaria uma venda nova, inflando o número em cima do qual você otimiza a campanha.

No Google Ads os dois campos andam juntos: googleAdsId sozinho não registra nada. E como o rótulo é por ação de conversão — normalmente uma por produto —, ele é do checkout, não da conta.

Depois de pagar

successUrl leva o comprador de volta pro seu site. É onde o pixel registra a venda, e é o que faz o fluxo terminar na sua loja em vez de numa página nossa. Só aceita https.

A troca de página espera alguns segundos depois da confirmação, pra quem pagou ver "pagamento confirmado" antes — sem isso parece que deu errado.

failureUrl é opcional. Sem ela, quem tem o cartão recusado continua na página e pode tentar outro método, que costuma converter melhor do que mandar embora.

Herança

Não existe. O que o checkout define é o que vale; o que ele deixa vazio simplesmente não é usado. Se você tem uma marca só e vários produtos, repita os valores em cada um.

Faturas são a exceção: uma fatura gerada a partir de uma Offer herda a vitrine dela — marca, idioma e pixel. Assim uma assinatura vendida num produto continua com a cara daquele produto. Fatura avulsa, sem Offer, aparece só com o nome do vendedor.