PayZu PixCertificados e segurança

Idempotência


Repita com segurança uma chamada que ficou sem resposta, sem cobrar, enviar ou devolver duas vezes.

Como funciona em cada operação

OperaçãoOnde vaiRepetiu com os mesmos dadosRepetiu com dados diferentes
CobrançaCorpo de POST /pixRetorna a cobrança que já existeRetorna a cobrança que já tem essa referência, sem comparar o valor nem outro campo
Envio e transferência entre contasCorpo de POST /withdraw, POST /withdraw/qrcode e POST /internal-transferRetorna a operação que já existe409 com PZC210
DevoluçãoCorpo de POST /refund/{transactionId}, por transaçãoRetorna a devolução que já existe, se ela está PENDING ou COMPLETED; em outro status, 409 com PZC210409 com PZC210

O clientReference tem até 64 caracteres e é único na conta para cobrança, envio e transferência entre contas. Usar num envio ou numa transferência a referência de outra operação também responde 409.

Como repetir uma chamada

Gere o clientReference antes da primeira tentativa, guarde junto do pedido e reenvie exatamente o mesmo valor quando não souber o resultado. Para localizar a operação depois, consulte pelo clientReference a rota dela.

OperaçãoOnde consultar
CobrançaGET /pix
EnvioGET /withdraw
Transferência entre contasGET /internal-transfer
DevoluçãoGET /pix pelo id da transação original, lendo refundStatus