Seção 07
Ciclo de Vida da Cobrança
Status da cobrança (payment.status)
| Status | Significado |
|---|---|
PENDING | Criada e aguardando o pagamento |
REQUIRES_ACTION | Cartão: o pagador precisa concluir a autenticação 3DS |
PAID | Paga |
FAILED | A tentativa de cobrança falhou |
CANCELED | Cancelada antes de ser paga |
REFUNDED | Estornada (cartão) |
Status da transação (to_status / from_status nos avisos)
Cada tentativa de cobrança é uma transação. O aviso transaction.status_changed informa a mudança:
| Status | Significado |
|---|---|
PROCESSING | Em processamento |
AUTHORIZED | Autorizada pelo emissor |
REFUSED | Recusada |
PAID | Paga |
CANCELED | Cancelada |
REFUNDED | Estornada |
CHARGEDBACK | Contestada pelo portador (chargeback) |
Como cada meio se comporta
- Pix: pago em segundos. O aviso de pagamento chega logo em seguida.
- Boleto: vence na data configurada; o pagamento é confirmado depois da compensação bancária (pode levar um dia útil).
- Cartão: pode exigir 3DS (
REQUIRES_ACTION). Parcelado atémax_installments, sem juros para o pagador.
Dica de implementação: trate o webhook como a fonte do status. Use
GET /payments/{id}só para conferir, nunca em laço de consulta.