Toda transação passa por uma sequência de estados, do momento em que você a cria
até o desfecho. Esta página explica o que cada status significa e como eles se
encadeiam.
O ciclo
pending ──> accepted ──> approved
├──> declined
├──> canceled
└──> error
approved ──> refund_pending ──> refunded
└──> approved (se o estorno não concluir)O que cada status significa
| Status | Significado | É final? |
|---|---|---|
pending | Cobrança criada, aguardando uma maquininha assumir. | Não |
accepted | Uma maquininha assumiu; o cliente está passando o cartão. | Não |
approved | Cobrança aprovada. | Sim |
declined | Recusada pela adquirente ou pelo emissor do cartão. | Sim |
canceled | Cancelada antes de concluir (o operador ou o cliente desistiu). | Sim |
error | Falha técnica no processamento. | Sim |
refund_pending | Estorno solicitado, em processamento. | Não |
refunded | Transação estornada. | Sim |
Três estados que costumam confundir
declined— o pagamento foi tentado e o banco recusou (sem saldo, cartão
bloqueado, etc.). A operação aconteceu; o resultado foi negativo.canceled— o pagamento não chegou a ser tentado; alguém desistiu antes
de passar o cartão.error— uma falha técnica impediu o processamento (queda de comunicação,
por exemplo). Não é recusa nem desistência.
Acompanhando o status
Enquanto o status for pending ou accepted, a transação ainda está em curso.
Consulte GET /transactions/{id} a cada 5 segundos e pare assim que chegar a
um estado final (approved, declined, canceled ou error).
Para não precisar consultar, registre um webhook: enviamos um aviso ao seu
sistema a cada mudança de status. Veja a seção Webhooks na API Reference.