Cobranças
Gerencie vendas no painel ou integre o checkout hospedado ao seu aplicativo.
Cobranças reúne catálogo, clientes, descontos, assinaturas, faturas e cobranças recebidas. Use o painel para gerenciar vendas ou integre o checkout hospedado ao seu aplicativo.
Operar pelo painel
Escolha a conta e o ambiente ativos e confira o acesso do seu papel antes de fazer alterações. Comece com Produtos e preços e crie um link de pagamento para uma oferta reutilizável ou uma fatura para um cliente.
| Tarefa | Guia |
|---|---|
| Preparar o que você vende | Produtos e preços |
| Gerenciar contatos e faturamento | Clientes |
| Oferecer desconto por código | Cupons |
| Oferecer benefícios automáticos | Promoções |
| Entender vários benefícios juntos | Como combinar descontos |
| Gerenciar cobranças recorrentes | Assinaturas |
| Criar faturas e registrar pagamentos | Faturas |
| Investigar cobranças não pagas | Recuperação de cobranças |
| Oferecer autoatendimento | Portal do cliente |
Escolher o fluxo de checkout
Links de pagamento
Use links de pagamento quando um operador gerencia uma oferta reutilizável e compartilha uma URL por site, mensagem, campanha ou QR. Exigem produtos e preços do catálogo; o acesso por API é opcional.
Cart Checkout
Use Cart Checkout quando seu backend monta o carrinho e cria uma Checkout Session por tentativa de compra. Admite preços do catálogo ou preços inline. Mantenha a chave de API no servidor; o navegador recebe a URL do checkout hospedado.
Ambos usam checkout hospedado e o mesmo processamento comercial após criar a sessão. Um carrinho de API pode ser editado enquanto aberto e não preparado, com Idempotency-Key e If-Match. Alterações do link afetam sessões posteriores; uma tentativa existente mantém seu snapshot.
Antes de começar
- Configure uma conexão de pagamentos e rotas válidas para os países e moedas previstos.
- Defina se a oferta é avulsa, recorrente, um teste ou carrinho misto compatível.
- Teste no Sandbox antes de publicar.
- Para uma integração, configure Webhooks assinados e confirme a compra somente após verificar
invoice.paid.
O status da Checkout Session descreve o fluxo do comprador e paymentStatus descreve a cobrança. Uma página concluída ou redirecionamento não comprova pagamento; um pagamento em processamento pode terminar depois. No painel, confira valores pagos e pendentes reais da fatura.