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ção | Onde vai | Repetiu com os mesmos dados | Repetiu com dados diferentes |
|---|---|---|---|
| Cobrança | Corpo de POST /pix | Retorna a cobrança que já existe | Retorna a cobrança que já tem essa referência, sem comparar o valor nem outro campo |
| Envio e transferência entre contas | Corpo de POST /withdraw, POST /withdraw/qrcode e POST /internal-transfer | Retorna a operação que já existe | 409 com PZC210 |
| Devolução | Corpo de POST /refund/{transactionId}, por transação | Retorna a devolução que já existe, se ela está PENDING ou COMPLETED; em outro status, 409 com PZC210 | 409 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ção | Onde consultar |
|---|---|
| Cobrança | GET /pix |
| Envio | GET /withdraw |
| Transferência entre contas | GET /internal-transfer |
| Devolução | GET /pix pelo id da transação original, lendo refundStatus |