# Idempotência

Timeout de rede não diz se a cobrança foi criada do outro lado. Envie um cabeçalho `Idempotency-Key` em todo `POST` que cria dinheiro (cobrança, saque) para que reenviar a mesma requisição nunca duplique a operação.

_curl_

```bash
curl -X POST https://stacepay.com.br/api/v1/charges \
  -H "Authorization: Bearer nvx_live_..." \
  -H "Idempotency-Key: pedido-8231" \
  -H "Content-Type: application/json" \
  -d '{"method":"pix","amount":5000,"customer":{...}}'
```

## Regras

- Mesma chave + mesmo corpo, ainda em processamento → `409 idempotency_key_in_progress`. Aguarde e não reenvie de imediato.
- Mesma chave + mesmo corpo, já concluída → devolve a **resposta original**, byte a byte, com o cabeçalho `Idempotent-Replay: true`.
- Mesma chave + corpo diferente → `422 idempotency_key_reused`. Use uma chave nova para cada operação distinta.

> ✅ A chave fica registrada por 24 horas. Use um identificador seu já único o código do pedido interno, por exemplo em vez de um valor aleatório gerado a cada tentativa.