PayZu Gateway

Status


Nesta páginaFaturaTentativa de pagamentoEstornoAssinaturaPlanoContestaçãoEntrega de webhook

Confira o que significa cada status que a API retorna, da fatura e das tentativas de pagamento à entrega dos webhooks.

Fatura

StatusO que significaPode seguir para
pendingEm aberto, recebendo tentativas de pagamento.paid, canceled, expired
paidPaga no cartão ou no Pix.refunded, chargedback
canceledCancelada por você ou junto com a assinatura.paid, pending
expiredChegou a billing.expires_at sem pagamento.paid
refundedEstornada.-
chargedbackContestada.-

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.

StatusO que significa
pendingPix aguardando pagamento, com o QR Code em pix.
processingCartão ou Pix sem resposta da adquirente. No Pix, passa a pending, com o QR Code, quando a cobrança aparece.
paidPaga.
failedRecusada, com o motivo em failure.
expiredO QR Code do Pix venceu sem pagamento.
refund_requestedEstorno pedido e ainda não confirmado.
refundedEstornada.
chargedbackContestada.
  • 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.

StatusO que significa
requestedPedido e ainda não confirmado, como a devolução do Pix à espera do banco.
confirmedValor devolvido, com a data em confirmed_at.
failedO estorno não aconteceu. Com a fatura ainda paid, você pode pedir outro.

O passo a passo está em Estornar uma fatura.

Assinatura

StatusO que significa
incompleteAguardando o pagamento da fatura da adesão.
activeAssinatura ativa. Na carência, segue active, com grace preenchido.
canceledAssinatura 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

StatusO que significa
activePlano à venda, que aceita novas assinaturas.
inactivePlano fora de venda. As novas assinaturas dele são recusadas, e as que já existem continuam.

Veja Planos.

Contestação

StatusO que significa
receivedA contestação chegou e aceita uma resposta até defense_deadline.
acceptedAceita pela API, aceita fora da API ou encerrada por prazo vencido.
defendedA defesa foi enviada.

Veja Contestações.

Entrega de webhook

StatusO que significa
pendingEspera a primeira ou a próxima tentativa.
deliveredEntrega concluída.
failedSexta tentativa sem 2xx, ou reenvio que não teve 2xx.

Veja Consultar entregas.