O que e idempotencia?
Idempotencia garante que uma mesma requisicao, executada multiplas vezes, produz o mesmo resultado. Isso e fundamental em pagamentos para evitar cobracas duplicadas em caso de timeout, retry ou falha de rede.Como usar
Inclua o headerIdempotency-Key com um UUID v4 unico em toda requisicao de criacao:
Endpoints que exigem Idempotency-Key
Comportamento
Boas praticas
1
Gere a key no seu sistema
Use UUID v4 gerado no seu backend antes de enviar a requisicao. Isso garante que retries usem a mesma key.
2
Associe a key ao pedido
Vincule a Idempotency-Key ao ID do pedido no seu sistema. Se precisar reenviar, use a mesma key.
3
Nunca reutilize keys entre pedidos diferentes
Cada pedido/transacao deve ter sua propria key unica.