ramp_payout_exceeds_payin: The payout is larger than the payin

An off-ramp pays out at most the stablecoin the payee paid in (with the fees, in operator mode). In own-account mode, a reported payout larger than what the chain shows the payee sent is refused, and nothing is recorded.

The same code can appear later as the errorCode of an off-ramp record in state mismatch: in operator mode when the payin the provider completed does not cover the payout plus the fees, and in own-account mode when a recheck on chain finds the payin smaller than the payout. The payee kit's own-account off-ramp helper raises the same code itself, before paying out, when the payout is larger than what the provider credited.

What to do

On the wire

HTTP 409, error type state_error.

{
  "error": "state",
  "reason": "ramp_payout_exceeds_payin",
  "detail": "…",
  "errorDetail": {
    "type": "state_error",
    "code": "ramp_payout_exceeds_payin",
    "message": "…",
    "param": "payoutMicroUsd",
    "doc_url": "…/errors/ramp_payout_exceeds_payin.md",
    "fix": "an off-ramp pays out at most what the payee paid in; report a payout no larger than the payin (operator mode: pay in the quote's full payinMicroUsd)"
  }
}

See ramps and all error codes.