Skip to main content
Você não precisa começar pela API. Comece pelo resultado financeiro que quer criar: vender uma oferta, concluir um pedido, cobrar um cliente específico ou manter uma relação recorrente. Depois escolha quanto da experiência de pagamento sua equipe quer controlar.
Regra rápida: a mesma oferta usa Link de pagamento; cada pedido usa uma Checkout Session; uma cobrança pontual vinculada a um cliente usa uma fatura avulsa; uma relação recorrente usa uma assinatura. Use um Payment Intent diretamente apenas quando sua aplicação já controlar o checkout e precisar coordenar a cobrança.

​
Comece pelo que você quer cobrar

​
Use a Chargefy como motor de cobrança

Checkout resolve a experiência de compra. Faturas e assinaturas resolvem o que acontece quando existe um valor devido por um cliente — uma vez ou ao longo do tempo.

Criar uma fatura avulsa

Crie uma cobrança pontual para um cliente, compartilhe a página hospedada e acompanhe pagamento, nova tentativa, cancelamento ou baixa.

Criar uma assinatura

Defina cliente, itens e cadência uma vez. A Chargefy gera a fatura, cobra e avança cada ciclo automaticamente.

Recuperar cobranças recorrentes

Use retentativas automáticas, avisos ao assinante, atualização de cartão e uma ação final configurável quando uma renovação falhar.

​
Escolha quanto da interface quer controlar

Compartilhar uma oferta sem código

Monte a oferta no Dashboard, publique a URL e compartilhe. Cada abertura gera uma tentativa de compra independente.

Usar uma página pronta

Seu backend cria o pedido e redireciona o comprador para um checkout que a Chargefy mantém e sua organização configura.

Criar a experiência no seu produto

Sua interface coleta os dados com segurança e apresenta os estados de pagamento; seu backend mantém a regra do pedido.

Controlar diretamente a cobrança

Use quando sua aplicação já resolveu itens, preço e comprador e precisa acompanhar apenas o movimento financeiro.

​
Decida pela responsabilidade de cada parte

O retorno do comprador para o seu site não é confirmação financeira. Em todos os caminhos, conclua o pedido no backend a partir do webhook e trate a mesma entrega mais de uma vez sem duplicar o efeito.

​
Chargefy for Platforms

Esta seção só se aplica a contas com o produto Chargefy for Platforms habilitado. Nesse produto, uma plataforma opera pagamentos para suas organizações filhas.
Use esse modelo quando seu marketplace, software vertical, franquia ou produto precisa manter vendedores, clientes empresariais ou unidades como operações financeiras separadas. Cada organização filha é dona de seus clientes, produtos, Links de pagamento, Checkout Sessions, pagamentos, faturas, assinaturas e histórico financeiro.

Entender o modelo de Platforms

Veja quando criar organizações filhas e como os recursos financeiros ficam separados entre elas.

Operar organizações filhas

Crie, ative e selecione cada organização para operar checkouts, pagamentos e cobranças pela mesma integração central.

​
Próximo passo

Se ainda houver dúvida entre a URL reutilizável e uma sessão criada por pedido, veja a diferença entre Link de pagamento e Checkout Session. Se a cobrança pertence a um cliente ao longo do tempo, comece por Faturas ou Assinaturas. Depois teste o caminho escolhido no ambiente de testes antes de ativar pagamentos reais.