Pagamentos online

Escolha quanto da experiência de compra você quer entregar pronta e quanto quer controlar no seu produto. A Chargefy oferece desde uma URL compartilhável sem backend por pedido até uma integração white-label em que sua aplicação desenha todos os estados do pagamento. Para a maioria das integrações, comece com uma Checkout Session e use a página hospedada. Ela coordena itens, comprador, métodos de pagamento, parcelamento, expiração e webhooks, enquanto seu backend decide o que será vendido e quando o pedido pode ser liberado.

Começar com o checkout hospedado

Crie uma Checkout Session no backend e redirecione o comprador para uma página pronta para PIX, cartão ou boleto.

Escolha a experiência de pagamento

Use a forma que combina com a origem da compra e com o nível de controle que a sua equipe precisa manter.

Link de pagamento

Sem backend por compra. Configure uma oferta reutilizável no Dashboard ou pela API e compartilhe a mesma URL quantas vezes precisar.Esforço de integração: baixo.

Checkout hospedado

Recomendado. Crie uma Checkout Session para cada pedido e redirecione o comprador para uma página configurada pela sua organização.Esforço de integração: médio.

Checkout white-label

Controle total. Crie a interface dentro do seu produto com Chargefy.js, cartão tokenizado no navegador e cobranças coordenadas pelo seu backend.Esforço de integração: maior.

Comparar Link e Checkout Session

Decida entre uma URL reutilizável para a mesma oferta e uma tentativa criada sob demanda para cada pedido.

Escolha a API

A Checkout Sessions API modela a compra completa. A Payment Intents API modela somente a tentativa financeira. Prefira Checkout Sessions quando a Chargefy também deve coordenar itens, dados do comprador, métodos, aparência e expiração. Use Payment Intents quando a sua aplicação já resolveu o checkout e precisa controlar diretamente a cobrança.

Decisão	Checkout Sessions	Payment Intents
Recomendado para	Carrinhos, ofertas e assinaturas com menos código de checkout.	Cobranças server-to-server, cartão salvo ou fluxo financeiro totalmente controlado por você.
Entrada principal	Itens, comprador, desconto e URLs de retorno daquele pedido.	Valor final, moeda, método de pagamento e opções da cobrança.
Interface	Página hospedada pela Chargefy ou frontend próprio autenticado pelo `client_secret`.	Interface criada e mantida pela sua equipe.
Formas de pagamento	Cartão, PIX e boleto, conforme a configuração da organização.	Cartão e PIX na criação direta; boleto nasce em checkout hospedado ou invoice.
Assinaturas	Itens recorrentes materializam a assinatura quando o checkout termina.	O intent processa a cobrança; assinatura e invoice coordenam a recorrência.
Complexidade	Aumenta com as regras da compra, mas preserva o mesmo ciclo de Checkout Session.	Exige que sua aplicação mantenha os estados, a apresentação e as regras do checkout.

Comparação de recursos

Recurso	Checkout Session	Payment Intent
Resumo e itens da compra	Mantém `line_items`, quantidade, subtotal, desconto e total.	Recebe o valor final; sua aplicação mantém os itens.
Página hospedada	Entrega uma `url` pronta para redirecionamento.	Não entrega página de checkout.
Dados do comprador	Coleta os campos mínimos do método e os adicionais definidos no Checkout Builder.	Sua aplicação coleta e vincula o customer ou payment method.
Descontos	Aplica desconto pré-configurado ou código informado pelo comprador.	Sua aplicação resolve o valor antes de criar ou atualizar o intent.
Parcelamento	Apresenta as opções válidas no checkout conforme a configuração da organização.	Sua interface apresenta as opções e envia a escolha em `payment_method_options`.
Expiração	Expira automaticamente depois de 24 horas se não for confirmada.	O ciclo depende do status da cobrança e, nos métodos assíncronos, da validade da próxima ação.
Confirmação do resultado	Emite eventos de `checkout.session.*` e reflete o Payment Intent relacionado.	Emite eventos de `payment.intent.*` para cada transição financeira.
Nível de manutenção	A Chargefy mantém a experiência e o ciclo da compra.	Sua equipe mantém a experiência, o retry e a tradução dos estados para o comprador.

Formas de pagamento

O checkout hospedado oferece os métodos habilitados no Checkout Builder. Cartão costuma concluir na própria confirmação; PIX e boleto continuam assíncronos até a compensação financeira.

Forma de pagamento	O que o comprador faz	Quando seu sistema confirma o pedido	Onde usar
PIX	Escaneia o QR Code ou usa o código copia e cola.	Depois da confirmação assíncrona recebida por webhook.	Checkout hospedado ou cobrança direta com Payment Intent.
Cartão de crédito	Informa o cartão e escolhe o parcelamento quando essa opção estiver habilitada.	Após a aprovação; o webhook continua sendo a fonte de verdade.	Checkout hospedado, checkout white-label ou cartão já salvo.
Boleto	Abre o documento e paga pela linha digitável ou pelo código de barras.	Depois da compensação bancária recebida por webhook.	Checkout hospedado ou cobrança documentada por uma fatura.

Você não precisa escolher uma única forma de pagamento para toda a operação. No checkout hospedado, habilite os métodos e o parcelamento no Checkout Builder. Em uma integração própria, a disponibilidade depende do fluxo financeiro implementado.

A presença do comprador na página de sucesso não comprova o pagamento. Para métodos assíncronos, libere o pedido somente depois do evento de pagamento confirmado.

Recursos que acompanham o checkout

Use os mesmos recursos em pagamentos avulsos e recorrentes para manter catálogo, promoções e operação financeira consistentes.

Produtos, preços e descontos

Organize o que você vende, valores de cobrança única e cadências recorrentes.

Criar e aplicar descontos

Aplique regras automáticas ou códigos resgatáveis no checkout e nos Links de pagamento.

Assinaturas

Inicie cobranças recorrentes, trials, pró-rata, faturas e recuperação de receita.

Configurar o checkout

Defina métodos, campos obrigatórios, parcelamento, identidade e template da página hospedada.

Funil de upsell

Ofereça um item adicional depois de uma compra aprovada no cartão.

Pixel de conversão

Acompanhe abertura, tentativa, recusa, expiração e venda aprovada no seu funil.

Depois do pagamento

Seu backend deve reagir ao estado financeiro confirmado, executar cada efeito uma única vez e manter a ligação entre pedido, cobrança e recebimento.

Após receber com um Checkout

Conecte o pedido, a página de retorno e os webhooks sem mostrar um sucesso prematuro.

Entregar pedidos

Libere produto ou acesso de forma idempotente depois da confirmação.

Conciliar pagamentos

Explique quanto foi pago, quais valores foram descontados e quando o saldo liquida.

Reembolsar

Devolva total ou parcialmente sem apagar o histórico financeiro da compra.