> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agitapay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Idempotência

> Evite cobranças e saques duplicados durante retries.

Use `Idempotency-Key` em operações que criam cobrança ou saque. Isso evita duplicidade quando sua aplicação tenta novamente após timeout.

```http theme={null}
Idempotency-Key: pedido-1001
```

## Como funciona

* Escopo por loja da chave.
* Mesma chave + mesmo JSON retorna a resposta original.
* Mesma chave + JSON diferente retorna `409 idempotency_mismatch`.
* Sem chave, retries podem criar novas cobranças ou saques.

O header aceita até 128 caracteres. Alternativamente, envie `idempotency_key` no corpo — o header prevalece. Uma falha HTTP 5xx não grava a chave.

## Onde usar

* `POST /payments/pix`
* `POST /withdrawals`