
No canvas, cada card representa uma oferta. As saídas "Sim" e "Não" conectam a próxima etapa do percurso.
O que precisa acontecer para o comprador entrar no funil
O funil é armado no instante em que o pagamento é aprovado. Todas as condições abaixo precisam valer ao mesmo tempo:success_url do link. Nenhum problema no funil derruba, atrasa ou desfaz a
venda que já foi aprovada. O funil é sempre um extra em cima de uma compra que
já deu certo.
A jornada do comprador
Ele paga no checkout
A Chargefy o leva para a página da primeira oferta
success_url, ele cai na página que você definiu na etapa de
entrada, levando uma chave de acesso na URL. É ela que diz quem é ele e
qual oferta ele está vendo.Ele decide
A decisão leva à próxima etapa
O funil termina
Anatomia de uma etapa
Cada etapa do funil junta cinco coisas:
Ao selecionar uma etapa, o painel separa em abas a oferta e a página, o texto dos botões e para onde cada resposta leva, enquanto o canvas mostra o resultado.
Instalar os botões na sua página
A página da oferta é uma página comum do seu site. Você só marca onde os dois botões entram.Exemplo de uma página de oferta: o conteúdo e o layout são seus; a Chargefy renderiza apenas os dois botões de decisão.
<head>:
complete-url é opcional e só entra em ação quando aquela decisão
encerra o funil. Enquanto houver próxima etapa, quem manda é o funil — a
Chargefy leva o comprador para a página seguinte e ignora o complete-url.
A identidade visual vem da sua marca
Cor principal, fonte, estilo e tema dos botões seguem a aparência da marca da sua organização — a mesma que veste o seu checkout. Não há ajuste por página nem por etapa, de propósito: o comprador acabou de pagar numa tela sua e precisa reconhecer o botão como parte da mesma experiência. Ajuste a aparência em Configurações → Branding no Dashboard, descrita em Marca e aparência.A mesma integração acompanha a cor principal, a fonte, o estilo e o tema definidos para o checkout.
Duração da sessão
A sessão do funil começa quando a compra inicial é aprovada e dura 1 hora. Durante esse período, a chave de acesso na URL identifica o comprador, a etapa atual e a oferta que ele pode aceitar. Sem uma chave de acesso válida, os botões não aparecem. Isso acontece quando alguém abre a página sem ter vindo de uma compra aprovada, quando a sessão vence ou quando o funil já terminou. A página continua funcionando normalmente, mas sem permitir a cobrança de uma oferta. A chave de acesso vale para uma única sequência. Depois de 1 hora, a sessão expira, os botões somem e a chave não pode ser reutilizada.Cada “sim” é uma cobrança independente
Aceitar uma oferta não aumenta o valor da compra original. A Chargefy cria uma cobrança nova, separada:Quando o clique não consegue cobrar
O texto do botão continua exatamente como você escreveu. O comportamento é que se adapta:interest_payer) do checkout inicial. Uma alteração posterior
na configuração da organização não muda essas regras. Cartão e Pix só aparecem
quando permitidos na origem; boleto não é oferecido no upsell.
Os dados conhecidos são reaproveitados sem pedir que o comprador os informe
novamente. Se faltar um dado obrigatório, o formulário pede esse dado antes de
pagar. No cartão, o nome do titular vem preenchido; número e código de segurança
precisam ser informados quando não há cartão reutilizável. Se esse cartão for
aprovado e salvo, ele passa a ser o cartão de um clique das ofertas seguintes.

Ao escolher Pix, o QR Code nasce no mesmo modal. Fechar e reabrir preserva este código enquanto ele estiver válido.
A mesma oferta não é cobrada duas vezes
Cada etapa aceita uma decisão só. Clicar novamente, atualizar a página durante o processamento ou voltar pelo navegador não cria outra cobrança. A Chargefy mostra o resultado já registrado ou informa que a decisão ainda está sendo processada. Essa proteção é aplicada antes de a cobrança ser enviada ao banco.Status do funil na lista
O link que dá start
Cada funil é disparado por um payment link, e cada link dá start em um funil. Você escolhe esse link na criação do funil e pode trocá-lo depois, nas configurações. Link e funil precisam estar no mesmo ambiente.
Se o funil estiver sem link de entrada, o primeiro card fica vermelho, explica o bloqueio e leva direto à configuração.
success_url normal. As cobranças já feitas e as métricas do
período são preservadas.
Testar em sandbox
Funis funcionam em sandbox exatamente como em produção. Crie o funil no ambiente de teste escolhendo um payment link de teste e conclua a compra com cartão ou Pix. Para conferir o fallback, entre com Pix — ou use um cartão salvo que seja recusado na oferta — e aceite uma etapa. Na origem Pix, confirme que o QR Code é gerado sem outro clique e sem repetir o cadastro. Feche e reabra o modal para conferir que ele preserva o mesmo código enquanto estiver pendente. Cartões de teste e cenários em Sandbox.Ler o estado do funil na sua página
Para uma página de oferta mais elaborada — mostrar o valor no título, o final do cartão, um contador — o Chargefy.js expõe o estado da chave de acesso atual:appearance traz a aparência do checkout em que o comprador acabou de pagar,
já resolvida — seja ela da organização, da plataforma ou a padrão da Chargefy.
Aqui as duas cores vêm sempre em hex: uma cor escolhida pelo nome, ou a falta
de cor de marca, chega convertida no tom exato do tema, pronta para pintar o
resto da página igual ao checkout. Os outros cinco campos têm os valores
descritos em Marca e aparência.
Os botões continuam sendo a forma suportada de cobrar e recusar. getState()
serve para enfeitar a página em volta deles.
Quando installments.surcharge_pending_card_brand vier true, o valor por
parcela não inclui a taxa repassada ao comprador — a organização precifica o
cartão por bandeira e o total exato só é definido na cobrança, a partir do
cartão salvo. Exiba o valor como “R$ 16,66 + taxa” nesse caso; com false
(o padrão), o valor exibido é o total por parcela.
Limites
Próximos passos
Criar um Link de pagamento
Chargefy.js
Produtos, preços e descontos
Entrega de webhooks
Juros no aceite da oferta
offer.installments.interest_rate informa a taxa vigente em pontos-base. O Chargefy.js a envia como interest_rate no aceite. Se a taxa tiver mudado, a resposta 409 installment_interest_changed não cobra: o botão recarrega a oferta, avisa que os juros mudaram e aguarda outro clique. Quando o comprador paga juros, as parcelas são exibidas para que ele confira o valor.
