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
- Report a payout no larger than the payin.
- In operator mode the payout is fixed by the quote: pay in the quote's full
payinMicroUsd.
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.