PayZu PaymentsReferência de códigos

Status do Pix


Decida o que fazer com cada cobrança Pix pelo texto em pixPayment.status e acompanhe cada devolução pelo status do item em pixPayment.refunds.

Status do Pix

statusSignificado
pendingQR Code gerado, aguardando o pagamento.
paidPago. O paidAt e o endToEndId passam a vir preenchidos.
canceledO QR Code venceu sem pagamento, ou a venda foi cancelada. No vencimento, a mudança acontece alguns minutos depois do expiresAt. O canceledAt passa a vir preenchido.
refundedO valor foi devolvido ao comprador.
failedO Pix não pôde ser processado e não aceita pagamento.

O endToEndId é o identificador do pagamento no Banco Central, o mesmo que aparece no comprovante de quem pagou. Para cobrar de novo um Pix cancelado ou com falha, crie outra cobrança.

Um Pix paid só muda para refunded, quando a devolução é confirmada. canceled, refunded e failed não mudam mais. Veja Cobrança Pix.

Status da devolução

statusSignificado
requestedDevolução pedida.
confirmedDevolução concluída.
failedDevolução não concluída.

Cada cobrança tem no máximo uma devolução requested por vez. Numa devolução failed, o valor volta ao saldo da conta e um novo pedido pode ser feito. Veja Devolver um Pix.