Receber — Ciclo de vida e status

Receber

Ciclo de vida e status

Toda cobrança nasce, avança e termina em um dos status abaixo. Acompanhe mudanças pelo retorno da API ou pelos webhooks.

StatusO que significa
pendingCobrança aguardando resolução (ex.: e-wallet).
issuedCobrança emitida (Pix gerado, boleto emitido). Aguardando pagamento.
confirmedCartão pré-aprovado. Aguardando captura.
pre_capturedAutorização pré-capturada registrada.
paidPagamento confirmado e disponível.
partially_refundedPagamento recebido com estorno parcial.
refundingEstorno em processamento.
refundedEstorno concluído.
refund_errorFalha ao estornar. Tente novamente.
not_issuedEmissão do meio falhou.
unpaidPagamento recusado (cartão) ou não realizado.
canceledCobrança cancelada antes do pagamento.
errorErro de processamento.
chargebackComprador contestou a cobrança.
chargeback_wonContestação vencida a favor da loja.
chargeback_lostContestação perdida (valor é devolvido).

Fluxos típicos

  • Pix/boleto: issued → paid (ou canceled/error).
  • Cartão pré-autorizado: confirmed → pre_captured → paid.
  • Cartão aprovação direta: confirmed → paid.
  • Estorno total: paid → refunding → refunded.
  • Contestação: paid → chargeback → chargeback_won | chargeback_lost.