PayZu CâmbioSegurança
Idempotência
Repita com segurança uma chamada que ficou sem resposta, sem comprar, cadastrar ou sacar duas vezes.
Como funciona
O cabeçalho Idempotency-Key é obrigatório em POST /v1/buys, POST /v1/wallets e POST /v1/withdrawals.
| Repetição | Resposta |
|---|---|
| Com os mesmos dados | A da primeira chamada, com o cabeçalho Idempotent-Replayed: true |
| Com dados diferentes ou em outra rota | idempotency_key_reused |
| Enquanto a primeira ainda executa | idempotency_in_progress |
A resposta fica guardada por 24 horas.
Ela vale para a chave de API que fez a chamada. Guardam-se os sucessos e os erros 400, 404, 409 e 422 da própria operação. Depois de 401, 403, 429 ou 5xx nada é guardado, e repetir com a mesma chave processa a chamada como nova.
Como repetir uma chamada
Gere o Idempotency-Key antes da primeira tentativa, guarde junto do pedido e reenvie exatamente o mesmo valor quando não souber o resultado.
Erros de idempotência
| Código | HTTP |
|---|---|
idempotency_key_required | 400 |
idempotency_in_progress | 409 |
idempotency_key_reused | 422 |