ramp_wrong_mode: The route does not apply in this ramp mode
Own-account off-ramps are quoted and paid by the payee's own Circle account; the core only records them. The quote route (POST /payee/v1/offramps/quotes) serves operator mode only. A payee with no verified wire destination gets ramp_destination_missing there first.
The payee kit's own-account on-ramp helper (ownAccountOnRamp in @dynamoprotocol/payee-kit/ramps) throws the same code, before it moves anything, when the quote it is given is not an own-account quote. That refusal comes from the library, not over HTTP.
What to do
- Read the mode at
GET /owner/v1/ramps. - In own-account mode, report the off-ramp at
POST /payee/v1/offramps.
On the wire
HTTP 409, error type state_error.
{
"error": "state",
"reason": "ramp_wrong_mode",
"detail": "…",
"errorDetail": {
"type": "state_error",
"code": "ramp_wrong_mode",
"message": "…",
"param": null,
"doc_url": "…/errors/ramp_wrong_mode.md",
"fix": "read the ramp mode at GET /owner/v1/ramps; in own-account mode the payee's own Circle account quotes, and POST /payee/v1/offramps records"
}
}
See ramps and all error codes.