For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/features/create/pages/pagbank-checkout-block.md.
  • Português

      • Como vender pela PagBank direto na minha página

      Adicione o bloco Checkout PagBank à página no editor, escolha a conta PagBank e o que será vendido. Na página publicada, o comprador preenche o formulário de pagamento dentro da própria página e paga com cartão, Pix ou boleto. Os dados do cartão são criptografados no navegador do comprador antes de seguirem para a PagBank. A venda chega pela sua integração PagBank, ligada à página.

      O bloco vende produtos de pagamento único. Assinaturas não são vendidas pelo bloco.

      Antes de começar

      • Você precisa ter acesso de edição à página.
      • O workspace precisa ter uma integração PagBank ativa. Para criá-la, cole só o token da PagBank, como em Integrar PagBank. Não há chave pública para copiar: a Clickmax obtém a chave sozinha a partir do token.
      • Confirme no painel da PagBank que Pix e boleto estão habilitados na conta, se for oferecê-los. Se a PagBank recusar um meio, o bloco avisa (veja Avisos no painel do bloco).
      • Para testar sem cobranças reais, use um token de teste (sandbox) e confira uma compra de ponta a ponta. Depois troque pela integração com o token de produção.

      Passo a passo

      1. Abra a página no editor, abra a lista de elementos para adicionar e, na categoria Checkout, arraste o bloco Checkout PagBank para a página.

      2. Clique no bloco para abrir o painel dele à direita. O painel tem as etapas Conta, O que vender e Pagamento; cada número vira um check quando a etapa está pronta.

      3. Em Conta, escolha a conta PagBank. Com uma só conta conectada, ela já vem escolhida. Se a integração estiver desativada, aparece Esta conta PagBank está desativada: reative-a em Integrações ou escolha outra conta. Se faltar informação na integração, aparece Falta informação nesta integração dizendo o que falta, com o botão Completar integração. Abra Antes de publicar para relembrar o que conferir na PagBank.

      4. Em O que vender, abra o campo Produto (Escolha um produto) e escolha um produto da lista. Digite no campo Buscar por nome ou código para filtrar e, se a lista tiver mais produtos, carregue mais. A lista mostra os produtos da conta PagBank escolhida em Conta; sem conta escolhida, aparece Escolha a conta acima para ver seus produtos. O nome de cada produto na lista acompanha o nome usado na venda mais recente. Se o produto ainda não existe, clique em Criar produto e preencha:

        • Nome;
        • Preço, maior que zero;
        • Código (SKU): vem sugerido a partir do nome e identifica o produto nas vendas. Use só letras, números, ponto, hífen ou sublinhado. Um código que já existe é recusado (Esse código já existe. Escolha o produto na lista ou use outro código.): escolha o produto existente na lista ou use outro código.

        Clique em Criar produto para salvar. O produto já fica na lista e escolhido no bloco. Depois de escolher, Nome, Preço e Descrição continuam editáveis. A Descrição é opcional, tem até 300 caracteres e aparece no resumo da compra. O preço do produto só vem preenchido: o valor que o checkout cobra é o do bloco e pode ser diferente do preço cadastrado do produto. Mudar o valor no bloco não altera o produto. Se o produto não tem preço cadastrado, aparece Este produto não tem preço no cadastro. Informe o valor para este checkout. Abaixo aparece o Resumo com o nome e o preço.

      5. Para oferecer order bumps, clique em Adicionar order bump, escolha ou crie o produto do mesmo jeito, confira nome, preço e, se quiser, descrição, e clique em Adicionar. São até 5 itens, que o comprador marca no próprio checkout. O mesmo código não pode ser usado duas vezes no bloco (Este código já está em uso neste checkout.). Para tirar um, clique no X ao lado dele.

      6. Em Pagamento, ligue os meios que o checkout oferece. As opções de cada meio aparecem logo abaixo dele:

        • Cartão de crédito: Parcelas, de Só à vista até 12x sem juros. O total não muda com as parcelas e você assume os juros. A PagBank exige um valor mínimo por parcela: se o comprador escolher parcelas demais para o valor da compra, a página pede que escolha menos parcelas;
        • Pix: Validade do Pix (minutos), de 5 a 1440;
        • Boleto: Vencimento do boleto (dias), de 1 a 30.

      7. Se quiser, abra Aparência e ajuste:

        • Cor de destaque: a cor do botão, do meio de pagamento escolhido e dos campos em foco. Escolha uma das cores prontas (a primeira é o verde da PagBank) ou digite um código como #1BB99A;
        • Cor do texto do botão: em Automático, o texto fica branco ou preto, o que for mais legível sobre a cor de destaque. Você também pode escolher branco, preto ou digitar um código. A amostra logo abaixo mostra o botão como o comprador vai ver, com um aviso se o texto ficar difícil de ler;
        • Fonte: a fonte do checkout. O padrão é Inter; escolha outra da lista ou Fonte da página para usar a mesma fonte do restante da página;
        • Texto do botão: o padrão é Finalizar compra;
        • Nome na fatura do cartão: até 17 letras ou números, sem acento.

      8. Publique a página. O que a página cobra é o que estava configurado na última publicação. Ao publicar, os produtos do bloco (o principal e os order bumps) também são registrados na sua lista de produtos da PagBank.

      Os produtos criados aqui já aparecem no filtro de produto dos gatilhos de automação da PagBank, sem precisar esperar a primeira venda. Veja Integrar PagBank.

      No editor, o bloco mostra uma prévia do checkout. Na prévia não dá para pagar.

      O que o comprador vê

      O checkout tem duas colunas. À esquerda fica o resumo: o nome do produto (e a descrição, se houver), o preço em destaque, os order bumps com o botão Adicionar e o Total a pagar. No celular, o resumo vira a barra Resumo da compra no topo, que abre ao tocar.

      À direita fica o formulário, que pede:

      • E-mail;
      • Forma de pagamento: uma lista para escolher entre Cartão de crédito, Pix e Boleto. As opções do meio escolhido aparecem logo abaixo dele;
      • Dados pessoais: nome, CPF ou CNPJ (o comprador escolhe qual no seletor ao lado do número) e celular com DDD;
      • Endereço: só no boleto, que exige o endereço completo do comprador. O CEP preenche o resto do endereço. Cartão e Pix não pedem endereço.

      O resultado de cada meio:

      • Cartão: número, nome impresso, validade e CVV, com a escolha de parcelas sem juros. Com o pagamento aprovado, o funil avança.
      • Pix: ao finalizar, aparece o QR Code e o botão Copiar código, com a contagem até o código expirar. A página acompanha o pagamento e o funil avança assim que o Pix é pago.
      • Boleto: ao finalizar, aparece a linha digitável e o botão Abrir boleto. O boleto leva até 3 dias úteis para compensar, então o funil não avança pela página; a venda chega quando o boleto é pago.
      • Pagamento em análise: a página avisa que o comprador recebe a confirmação por e-mail.
      • Pagamento recusado: a página mostra Pagamento recusado. Confira os dados ou use outro cartão. e deixa o comprador tentar de novo, com os dados do cartão digitados outra vez.

      O pixel da página recebe a compra aprovada com o valor total pago e a moeda.

      Compra com 1 clique

      A compra com 1 clique é automática, não há nada para ligar. Quem acabou de ter uma compra com cartão aprovada neste domínio, na mesma conta PagBank e há até 30 minutos vê no topo do checkout o cartão Compra rápida, com dois botões:

      • Comprar com 1 clique: cobra o cartão salvo, à vista, sem o comprador digitar nada de novo;
      • Usar outro meio de pagamento: mostra o formulário completo.

      Funciona em qualquer página com o bloco, inclusive nas etapas de upsell e downsell de um funil. Quem chega direto na página, comprou com Pix ou boleto, comprou em outro domínio ou há mais de 30 minutos vê só o formulário. Se a PagBank recusar o cartão salvo, aparece o formulário completo para pagar de outro jeito.

      O bloco não tem botão de recusa. Para o caminho de quem não quer a oferta, adicione à página um botão com Ao clicar > Recusar oferta do funil: o clique segue o caminho de recusa do funil. Veja Como usar o checkout da PagBank como etapa do meu funil.

      Onde a venda aparece

      Toda compra feita pelo bloco chega pela sua integração PagBank, entra nas vendas externas e cria ou atualiza o contato pelo e-mail do comprador. A venda fica ligada à página em que o comprador pagou e dispara os gatilhos de automação da PagBank. A venda entra na receita quando a PagBank avisa o pagamento, e não pelo que o comprador vê no navegador. Você não precisa cadastrar nenhum webhook na PagBank.

      Quando a página é etapa de um funil, essas vendas entram em Receita e Compras no Modo Analytics do funil. Veja Quais vendas entram na receita do funil.

      Avisos no painel do bloco

      Quando um comprador tenta pagar e a PagBank recusa o meio de pagamento por configuração da conta, o painel do bloco passa a mostrar o aviso A PagBank recusou vendas desta página, com o motivo Habilite Pix na sua conta PagBank (ou Boleto, ou Cartão de crédito, conforme o meio recusado). Habilite o meio na PagBank ou desligue-o no bloco e publique de novo. Enquanto isso, o comprador vê Este meio de pagamento não está disponível. Tente outro. e pode usar outro meio.

      Se não funcionou

      • O checkout não aparece na página publicada: a integração PagBank escolhida no bloco precisa ser do seu workspace, estar ativa e ter o token. Complete a integração e publique a página de novo.
      • O comprador vê Não foi possível carregar o pagamento.: a página foi publicada com o bloco incompleto. O bloco precisa de produto e de ao menos um meio de pagamento. Complete o painel do bloco e publique de novo.
      • Dupliquei a página ou ela veio de um template ou funil compartilhado: se a conta PagBank do bloco é de outro workspace, o editor limpa a conta do bloco e a página publicada não mostra o checkout. Escolha a sua conta PagBank e publique de novo.
      • Aparece Este meio de pagamento não está disponível. Tente outro.: o meio não está habilitado na sua conta PagBank. Habilite-o na PagBank.
      • Aparece Essas parcelas não estão disponíveis para este valor. Escolha menos parcelas.: o valor de cada parcela ficou abaixo do mínimo da PagBank. O comprador escolhe menos parcelas, ou você reduz o máximo de Parcelas no bloco.
      • Aparece Pagamento indisponível no momento. Tente novamente em instantes.: a PagBank não respondeu ou não foi possível preparar o cartão no navegador. O comprador tenta de novo em instantes; Pix e boleto não dependem da preparação do cartão.
      • O comprador pagou e a venda não apareceu: confira se a integração está ativa em Integrações e se a página foi publicada depois de você adicionar o bloco.
      • O comprador pagou o boleto e o funil não avançou: boleto não avança o funil pela página. Use os gatilhos de automação da PagBank para reagir ao pagamento.
      • O comprador não viu a Compra rápida: a compra anterior foi em outro domínio, com Pix ou boleto, em outra conta PagBank ou há mais de 30 minutos, ou o bloco não oferece cartão de crédito.
      • Mudei o preço e o comprador ainda viu o antigo: a mudança vale depois que você publica a página de novo.

      Relacionados