PayZu CâmbioSegurança

Idempotência


Nesta páginaComo funcionaComo repetir uma chamadaErros de 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çãoResposta
Com os mesmos dadosA da primeira chamada, com o cabeçalho Idempotent-Replayed: true
Com dados diferentes ou em outra rotaidempotency_key_reused
Enquanto a primeira ainda executaidempotency_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