ramp_idempotency_conflict: The idempotency key or quote is already used
One idempotency key confirms one quote, and one quote is confirmed once. The key sent already confirmed another quote (or, in own-account mode, another deliveryTxHash), or the quote was already confirmed under another key. Nothing was sent.
The off-ramp routes apply the same rule: an operator-mode confirmation whose key confirmed another payee's or another quote's off-ramp, or whose quote was confirmed under another key; and an own-account report (POST /payee/v1/offramps) whose key reported another off-ramp (another payee, payinTxHash or payout). Nothing was sent or recorded.
What to do
- Retry with the same key and exactly the same values to read the existing order.
- For a new ramp, ask for a fresh quote (own-account off-ramps need none) and use a new UUID v4 key.
On the wire
HTTP 409, error type state_error.
{
"error": "state",
"reason": "ramp_idempotency_conflict",
"detail": "…",
"errorDetail": {
"type": "state_error",
"code": "ramp_idempotency_conflict",
"message": "…",
"param": "idempotencyKey",
"doc_url": "…/errors/ramp_idempotency_conflict.md",
"fix": "one idempotency key confirms one quote, and one quote is confirmed once; use a new UUID v4 key and a fresh quote"
}
}
See ramps and all error codes.