Idempotency-Key em operações que criam cobrança ou saque. Isso evita duplicidade quando sua aplicação tenta novamente após timeout.
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.
idempotency_key no corpo — o header prevalece. Uma falha HTTP 5xx não grava a chave.
Onde usar
POST /payments/pixPOST /withdrawals