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/stripe-checkout-block.md.
  • Português
  • Como vender pela Stripe direto na minha página

    Adicione o bloco Checkout Stripe à página no editor e, no painel da direita, escolha a Conta Stripe e o Preço. Na página publicada, o comprador paga no checkout da Stripe sem sair da sua página. Quando a Stripe confirma o pagamento, o funil segue para a próxima etapa e a venda chega pela sua integração Stripe, ligada à página.

    Antes de começar

    • Você precisa ter acesso de edição à página.
    • O workspace precisa ter uma integração Stripe ativa com a chave publicável e o segredo de assinatura do webhook. Se ainda não tem, siga Integrar Stripe.
    • O produto e o preço precisam existir na sua conta Stripe. Preços em faixas, por uso ou com valor livre não aparecem na lista.

    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 Stripe para a página.
    2. Clique no bloco para abrir o painel Checkout Stripe à direita.
    3. Em O que será vendido, escolha a Conta Stripe e o Preço. Preços com o selo Assinatura criam uma assinatura; os demais são Pagamento único.
    4. Em Order bumps (opcionais), adicione até 10 itens extras que o comprador pode incluir no próprio checkout. Todos precisam estar na mesma moeda do preço principal, e:
      • com Pagamento único, só entram itens de pagamento único;
      • com Assinatura, entram itens de pagamento único ou assinaturas com a mesma recorrência.
    5. Em Opções do checkout, ligue se quiser:
      • Permitir cupom de desconto: aceita os códigos promocionais criados na Stripe;
      • Pedir telefone: o comprador informa o telefone no checkout.
    6. Salve e publique a página.

    Com um preço escolhido, o editor mostra o checkout real da Stripe dentro do bloco, com a marca Pré-visualização, e atualiza a cada mudança de preço, order bumps ou opções. Na prévia não dá para digitar nem pagar: clicar no checkout só seleciona o bloco. Cada prévia aparece no painel da Stripe como um checkout aberto, que expira sozinho em cerca de 30 minutos e não cobra nada. Cores, logo e fontes vêm das configurações de marca da sua conta Stripe.

    E-mail preenchido

    Quando a página abre com o e-mail do comprador na URL (por exemplo, vindo de um formulário de uma etapa anterior do funil, em ?email=), o checkout já aparece com esse e-mail preenchido. A Stripe não deixa editar um e-mail preenchido: se o comprador quiser usar outro, ele abre a página sem o e-mail na URL. E-mail inválido é ignorado e o campo fica livre.

    Nome e telefone não são preenchidos; o comprador digita no checkout.

    Para onde o comprador vai depois de pagar

    • Cartão aprovado: o comprador não sai da sua página. Se ela faz parte de um funil, ele segue para a etapa ligada ao gatilho Compra Aprovada (ou a Upsell Aceito / Downsell Aceito).
    • Autenticação do banco (3D Secure) ou pagamento que abre outra página: o comprador volta para a sua página e o funil avança assim que a Stripe confirma o pagamento.
    • Boleto, débito bancário e outros pagamentos que confirmam depois: a página mostra que o pedido foi recebido e o funil não avança. A venda chega quando a Stripe confirmar o pagamento.
    • Pagamento recusado: o checkout da Stripe mostra o motivo e deixa o comprador tentar de novo.
    • Sem próxima etapa no funil: a página mostra Pagamento confirmado! no lugar do checkout.

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

    Onde a venda aparece

    Toda compra feita pelo bloco chega pelo webhook da sua integração Stripe e cria ou atualiza o contato pelo e-mail do comprador. Ela fica ligada à página em que o comprador pagou.

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

    Se não funcionou

    • O painel pede para conectar a Stripe: o workspace não tem integração Stripe ativa. Clique em Conectar Stripe, crie a integração e volte ao editor para clicar em Atualizar.
    • Aparece Integração incompleta: falta a chave publicável ou o segredo de assinatura do webhook. Clique em Abrir Integrações e complete a integração. Enquanto isso, o bloco não aparece na página publicada.
    • Aparece que a chave não tem permissão para ler produtos e preços: na Stripe, edite as permissões da chave restrita e use Standard.
    • O bloco mostra Não foi possível carregar a pré-visualização: a mensagem abaixo dela diz o motivo (por exemplo, a chave sem permissão ou a Stripe recusando a configuração). Corrija na Stripe ou no painel do bloco; a prévia tenta de novo a cada mudança.
    • A lista de preços está vazia: a conta não tem preço ativo que o bloco consiga cobrar. Crie um preço fixo para o produto na Stripe e abra a lista de novo.
    • O checkout não aparece na página publicada: um bloco sem preço, com integração incompleta ou desativada não aparece para o comprador. Confira o painel do bloco e publique a página de novo.
    • Dupliquei a página ou o funil (ou ela veio de um template, pack ou funil compartilhado):
      • Se a conta Stripe do bloco é do seu workspace, publique a cópia: as vendas dela passam a ficar ligadas à página nova.
      • Se a conta Stripe é de outro workspace, o painel limpa o preço do bloco e a página publicada não mostra o checkout. Escolha a sua Conta Stripe e o preço e publique de novo. Isso impede que alguém venda para a conta Stripe de outra pessoa por uma página copiada.
    • Mudei o preço e o comprador ainda viu o antigo: a mudança vale depois que você publica a página de novo.
    • O comprador pagou e o funil não avançou: confira se a etapa seguinte está ligada ao gatilho Compra Aprovada. Pagamentos que confirmam depois, como boleto, não avançam o funil pela página.

    Relacionados