Logo | API Docs
Entrar

Checkout Builder

O Checkout Builder permite que merchants criem paginas de pagamento personalizadas diretamente pelo painel. Cada checkout gera uma URL publica no formato {{APP_URL}}/pay/{{slug}}, onde o cliente final pode realizar pagamentos de forma segura e rapida.

Principais Recursos

  • Metodos de pagamento: PIX, Boleto e Cartao de Credito
  • Personalizacao completa: logo, cores, produtos, ofertas adicionais (upsells)
  • Tracking pixels: Facebook Pixel, TikTok Pixel, Google Ads
  • Pagina de obrigado: redirecione para uma URL ou exiba uma mensagem personalizada
  • Entrega digital: links de download automaticos apos confirmacao de pagamento
  • Postback: notificacao automatica ao merchant quando o pagamento e confirmado

Criando um Checkout

Siga o passo a passo abaixo para criar seu primeiro checkout:

1. Acesse o painel e navegue ate Checkout

Apos fazer login, clique no menu Checkout na barra lateral do painel do merchant.

2. Clique em "Novo Checkout"

O botao esta localizado no canto superior direito da listagem de checkouts. Voce sera direcionado ao formulario de criacao.

3. Configure as informacoes basicas

  • Nome: nome interno do checkout (visivel apenas para voce)
  • Slug: identificador unico na URL (ex: meu-produto gera /pay/meu-produto)
  • Descricao: texto exibido na pagina de checkout para o cliente
  • Logo: imagem da sua marca exibida no topo do checkout
  • Cores: cor primaria e cor de fundo para personalizar o visual

4. Adicione produtos

Configure um ou mais produtos com os seguintes campos:

  • Nome do produto
  • Preco (em R$)
  • Imagem (opcional)
  • URL de conteudo digital (opcional, para entrega digital)

5. Configure upsells (opcional)

Upsells sao ofertas adicionais exibidas apos o cliente selecionar o produto principal. Otimo para aumentar o ticket medio.

6. Configure metodos de pagamento aceitos

Selecione quais metodos serao exibidos no checkout: PIX, Boleto e/ou Cartao de Credito.

7. Adicione tracking pixels (opcional)

Insira os IDs dos seus pixels de rastreamento para acompanhar conversoes. Veja a secao abaixo para detalhes.

8. Configure a pagina de obrigado

Escolha entre redirecionar o cliente para uma URL externa ou exibir uma mensagem personalizada diretamente na pagina.

9. Ative o checkout

Apos configurar tudo, ative o checkout para que ele fique acessivel publicamente pela URL gerada.

Integrando Tracking Pixels

O Checkout Builder suporta tracking pixels das principais plataformas de anuncios. Configure os IDs no formulario de criacao do checkout ou envie no formato JSON abaixo:

{
  "facebook": "FB_PIXEL_ID",
  "tiktok": "TIKTOK_PIXEL_ID",
  "google_ads": "AW-CONVERSION_ID"
}
Os pixels serao disparados automaticamente nos eventos de PageView (abertura do checkout) e Purchase (pagamento confirmado).

Eventos Disparados

Plataforma Evento de Visualizacao Evento de Compra
Facebook Pixel PageView Purchase
TikTok Pixel ViewContent CompletePayment
Google Ads page_view conversion

Entrega Digital

Para produtos digitais (ebooks, cursos, softwares, etc.), configure a entrega automatica:

  • No cadastro do produto, preencha o campo digital_content_url com a URL do arquivo ou pagina de acesso
  • Defina o limite de downloads por compra para evitar compartilhamento indevido
  • Apos a confirmacao do pagamento, o link de download fica disponivel automaticamente na pagina de obrigado
  • O cliente tambem recebe o link por e-mail (se configurado)
Certifique-se de que a URL de conteudo digital esteja acessivel publicamente ou utilize links com token de acesso temporario.

Fluxo de Pagamento

O fluxo completo de um pagamento via checkout segue as seguintes etapas:

  1. Acesso: O cliente acessa a URL /pay/{{slug}}
  2. Selecao: Escolhe o produto desejado e o metodo de pagamento (PIX, Boleto ou Cartao)
  3. Dados: Preenche nome, e-mail e CPF/CNPJ
  4. Cobranca: O sistema gera a cobranca automaticamente:
    • PIX: QR Code e codigo copia e cola
    • Boleto: Linha digitavel e PDF
    • Cartao: Processamento em tempo real
  5. Pagamento: O cliente realiza o pagamento
  6. Confirmacao: O webhook do adquirente confirma o pagamento
  7. Redirecionamento: O cliente e redirecionado para a pagina de obrigado (com link de download, se aplicavel)
  8. Notificacao: O postback notifica o merchant sobre o pagamento confirmado
Para pagamentos via PIX, a confirmacao e praticamente instantanea. Boletos podem levar ate 3 dias uteis para compensacao.