idempotency_key_reused
Esa `Idempotency-Key` ya se usó con un payload distinto. La clave identifica una operación concreta, así que reutilizarla para otra vaciaría de sentido el replay. Un `external_id` ya emitido que se reenvía con otro tipo o total en `POST /v1/companies/{company}/invoices` no devuelve este error, sino el 409 `unattended_replay_mismatch`.
| Code | Type | HTTP | Categoría |
|---|---|---|---|
idempotency_key_reused | idempotency_error | 422 | Idempotency |
Causa
Esa Idempotency-Key ya se usó con un payload distinto. La clave identifica una operación concreta, así que reutilizarla para otra vaciaría de sentido el replay. Un external_id ya emitido que se reenvía con otro tipo o total en POST /v1/companies/{company}/invoices no devuelve este error, sino el 409 unattended_replay_mismatch.
Qué hacer
Usa una clave nueva por cada operación distinta, y reutiliza una clave solo para reintentar exactamente la misma petición.