Skip to main content
Prices a payout that lands on a card. Anonymous: no account, no wallet, no identity, so the price can be shown before anyone signs up. For the flow this belongs to, see Payouts.
Needs the card-payouts permission on your API key. A key without it gets 403 permission_denied. See Authentication.
Card payouts settle in EUR, GBP and USD only. The incoming card direction covers dozens of currencies; the outgoing one does not, and asking for any other currency is refused with 422 no_route. Where a user needs paying in something else, use a bank payout - the bank side reaches far more currencies. Read GET /v1/payment-methods per country rather than assuming symmetry between the two directions.

​
Request

​
string
required
The asset the user is paying out with (e.g. "USDC").
​
number
required
Chain id the stablecoins are sent from. Must be enabled on your key.
​
string
required
ISO 4217 code the card is settled in (e.g. "EUR").
​
string
The amount of stablecoin the user gives up, as a decimal string. Send this or fiatAmount, never both.
​
string
The amount that must arrive on the card, as a decimal string. Use this when the user names what they want to receive and the cost is solved backwards.

​
Response

​
string
Pass this to POST /v1/card/payout. A payout created without it is repriced at execution.
​
string
What the user sends, as a decimal string.
​
string
What lands on the card, after both fees.
​
string
Exchange rate used, fiat per unit of crypto.
​
string
The payout partner’s fee, in fiat. Already deducted from fiatAmount.
​
string
Rheon’s markup, in fiat. "0" until a markup is configured on your account.
​
string
ISO 8601. Execute before this or the quote is refused as expired.
Fees come out of the payout, they are not charged separately. With a cryptoAmount of 100.00 and fees totalling 2.50, the card receives the fiatAmount we return - not that figure minus 2.50 again. Showing both numbers without saying so reads as a double charge.
Card payout fees carry a flat minimum, so a 20 EUR payout costs proportionally far more than a 2,000 EUR one. Quote each amount rather than applying a percentage from a single sample.

​
Errors