Status
Confira o que significa cada status que a API retorna, da fatura e das tentativas de pagamento à entrega dos webhooks.
Fatura
| Status | O que significa | Pode seguir para |
|---|---|---|
pending | Em aberto, recebendo tentativas de pagamento. | paid, canceled, expired |
paid | Paga no cartão ou no Pix. | refunded, chargedback |
canceled | Cancelada por você ou junto com a assinatura. | paid, pending |
expired | Chegou a billing.expires_at sem pagamento. | paid |
refunded | Estornada. | - |
chargedback | Contestada. | - |
A fatura canceled ou expired vai a paid quando um pagamento já iniciado é confirmado depois. A canceled volta a pending quando a assinatura é reativada antes do vencimento da fatura, como em Reativar uma assinatura. O ciclo da fatura está em Cobranças.
Libere o pedido pelo status da fatura, e não pelo da tentativa.
Uma tentativa failed não fecha a fatura, que segue pending e aceita nova tentativa até billing.expires_at. O pedido está pago quando a fatura chega a paid.
Tentativa de pagamento
Cada tentativa fica em payments[] da fatura, da mais nova para a mais antiga.
| Status | O que significa |
|---|---|
pending | Pix aguardando pagamento, com o QR Code em pix. |
processing | Cartão ou Pix sem resposta da adquirente. No Pix, passa a pending, com o QR Code, quando a cobrança aparece. |
paid | Paga. |
failed | Recusada, com o motivo em failure. |
expired | O QR Code do Pix venceu sem pagamento. |
refund_requested | Estorno pedido e ainda não confirmado. |
refunded | Estornada. |
chargedback | Contestada. |
- Pix
pending: não impede pagar a mesma fatura no cartão. Pedir Pix de novo com o QR Code ainda válido retorna o mesmo QR Code. - Cartão
processing: uma nova tentativa na fatura é recusada até o desfecho, que a PayZu busca sozinha, como em Vender no cartão. - Nova tentativa: é feita em Pagar uma fatura.
Estorno
Cada estorno fica em refunds[] da fatura.
| Status | O que significa |
|---|---|
requested | Pedido e ainda não confirmado, como a devolução do Pix à espera do banco. |
confirmed | Valor devolvido, com a data em confirmed_at. |
failed | O estorno não aconteceu. Com a fatura ainda paid, você pode pedir outro. |
O passo a passo está em Estornar uma fatura.
Assinatura
| Status | O que significa |
|---|---|
incomplete | Aguardando o pagamento da fatura da adesão. |
active | Assinatura ativa. Na carência, segue active, com grace preenchido. |
canceled | Assinatura cancelada. O motivo vem em cancellation.reason. |
A renovação, a carência e os motivos de cancelamento estão em Ciclo da assinatura.
Plano
| Status | O que significa |
|---|---|
active | Plano à venda, que aceita novas assinaturas. |
inactive | Plano fora de venda. As novas assinaturas dele são recusadas, e as que já existem continuam. |
Veja Planos.
Contestação
| Status | O que significa |
|---|---|
received | A contestação chegou e aceita uma resposta até defense_deadline. |
accepted | Aceita pela API, aceita fora da API ou encerrada por prazo vencido. |
defended | A defesa foi enviada. |
Veja Contestações.
Entrega de webhook
| Status | O que significa |
|---|---|
pending | Espera a primeira ou a próxima tentativa. |
delivered | Entrega concluída. |
failed | Sexta tentativa sem 2xx, ou reenvio que não teve 2xx. |
Veja Consultar entregas.