Idempotência
Idempotency-Key em todas as escritas — sem duplicatas em retries.
Toda chamada POST que cria um recurso aceita o header Idempotency-Key. Reenviar a mesma chave dentro de 24h retorna a mesma resposta sem criar duplicatas.
curl -X POST https://api.stone.com.br/v1/charges \\
-H "Authorization: Bearer $TOKEN" \\
-H "Idempotency-Key: 7b3f8e2a-9c4d-4e6f-8a1b-0d3c5e7f9a2b" \\
-H "Content-Type: application/json" \\
-d '{ "amount": 1990, "payment_method": "pix" }'
- Use UUIDv4 ou ULID
- Uma chave por intenção de negócio (não por retry)
- Mesma chave + corpo diferente = erro
409 idempotency_key_reused