Skip to main content

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 header Idempotency-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.

Exemplo com retry