Pagamentos — Cobranças
Pagamentos
Cobranças
A cobrança (charge) é a unidade central da plataforma. Entender seu ciclo de vida — do pedido ao liquido — é a chave para operar qualquer fluxo.
Tipos de cobrança
| Tipo | Descrição |
|---|---|
| Pix | Pagamento instantâneo brasileiro com QR code e payload |
| Cartão de crédito | Com opções de parcelamento e retentativa |
| Cartão de débito | Cobrança imediata no saldo do portador |
| Boleto | Com emissão, vencimento e compensação |
| E-wallet | Carteiras digitais e contas de pagamento |
| QRA | Cobrança QR da Argentina (QR para pagar) |
| PFC | Pago Fácil Conectado (Argentina) |
| SPEI | Transferência instantânea do México |
| OXXO | Pagamento em caixa (México) |
| Apple Pay | Pagamento via carteira da Apple |
| Transferência bancária | Débito direto via banco |
| Pagamento em caixa | Dinheiro ou boleto em pontos de pagamento |
| QR code | Pagamento por QR genérico |
Estados de uma cobrança
| Estado | Significado |
|---|---|
| confirmed | Cobrança confirmada e aguardando pagamento |
| pending | Aguardando processamento ou confirmação |
| issued | Instruções de pagamento emitidas (Pix/boleto) |
| paid | Pagamento liquidado pela rede |
| canceled | Cobrança cancelada antes da captura |
| not_issued | Não foi possível emitir as instruções |
| error | Falha de processamento |
| unpaid | Vencida ou não paga |
| refunding / refunded | Estorno em andamento / concluído |
| partially_refunded | Estorno parcial concluído |
| chargeback | Chargeback aberto pelo banco |
| chargeback_won / lost | Chargeback resolvido a seu favor / contra |
| pre_captured | Pré-autorização realizada, aguardando captura final |
| pre_chargeback_resolution | Em prevenção pré-chargeback |
Ciclo de vida rápido
- Você cria o charge com o meio de pagamento escolhido.
- Para cartão, ocorre a pré-autorização; para Pix/boleto, são emitidas as instruções (issued).
- O cliente paga e a rede confirma (paid).
- O webhook de pagamento confirma o evento e a API reflete o novo estado.
- Quando apropriado, você captura ou estorna; o saldo se move na liquidação.