Idempotência
A idempotência é garantida na camada de aplicação (lookup em banco), por empresa:
| Operação | Onde | Comportamento |
|---|---|---|
Cobrança PIX (POST /payments/merchant/...) | campo idempotencyKey no body | Usado como externalRef da order. Se já existe order com esse externalRef na empresa, a order existente é retornada/recobrada (sem duplicar) |
Saque (POST /withdraws/merchant) | campo idempotencyKey no body | Se já existe saque com essa chave, o registro existente é retornado |
Reembolso (POST /payments/transactions/:id/refunds) | header Idempotency-Key (obrigatório) | Ausente → 400 |