PayZu PaymentsReferência de códigos

Status da transação


Nesta páginaStatus da cobrançaCiclo de vidaSe vale tentar de novoOnde o status aparece

Decida o que fazer com cada cobrança pelo número em creditCardPayment.status; os códigos de retorno servem para registrar e explicar o resultado. Na cobrança Pix, o status fica em pixPayment.status; veja Status do Pix.

Status da cobrança

statusNomeDescrição
0NotFinishedPagamento não concluído por falha no processamento.
1AuthorizedPagamento autorizado, ainda sem captura.
2PaymentConfirmedPagamento confirmado.
3DeniedPagamento recusado pelo emissor.
10VoidedPagamento cancelado.
11RefundedPagamento estornado.
12PendingAguardando o retorno da instituição financeira.
13AbortedPagamento cancelado por falha no processamento.
statusO que fazer
2Libere o pedido. É o único status que aceita estorno.
3Mostre ao cliente o returnMessage da resposta da criação e veja se vale tentar de novo com o mesmo cartão.
0 ou 13Trate a cobrança como não paga e crie outra se o cliente quiser tentar de novo.
12 ou 1Aguarde o aviso charge.update com o status final.

Numa cobrança avulsa a autorização e a captura acontecem na mesma chamada, então o primeiro status que você vê costuma ser 2, 3, 12, 0 ou 13. Os status 1 e 10 podem aparecer conforme o provedor de pagamento da conta.

Ciclo de vida

Depois de um PUT /charges/{chargeId}/reverse, a cobrança continua em 2 com reversedAmount preenchido até a confirmação do cancelamento, que leva o status a 10 ou 11.

Se vale tentar de novo

No pagamento negado (3), creditCardPayment.retryAllowed e creditCardPayment.retryAfter dizem se o emissor aceita outra tentativa com o mesmo cartão.

  • Onde vêm: na criação e na consulta por id (GET /charges/{chargeId}). São null quando o pagamento não foi negado.
  • Onde não vêm: na listagem, no estorno, nas respostas a chargeback e nos avisos.
retryAllowedretryAfterO que significaO que fazer
falsenullRecusa definitiva.Peça outro cartão. A nova tentativa com o mesmo cartão responde 422 com PZ202 por 30 dias, sem criar cobrança.
true"2026-11-09T18:40:12.000Z"O emissor deu um prazo.Tente depois de retryAfter ou peça outro cartão. Antes do prazo, a tentativa responde 422 com PZ203.
truenullRecusa comum.Pode tentar de novo, dentro dos limites da bandeira.

Os códigos de cada bandeira estão em Programa de retentativa das bandeiras.

Onde o status aparece