Skip to main content
Takes a single incoming bank transfer and settles stablecoins to a wallet, without opening a virtual account. Use it where a user pays once, or where the country supports it but you would rather not issue permanent bank details. The difference from Bank transfers: those issue details the user keeps and reuses; this returns details for one payment, valid until they expire.
Needs the bank permission on your API key. See Authentication.
Not every country offers this. Where a local rail requires an account in the payer’s own name, the virtual account route is the only one open. Check GET /v1/payment-methods for the country before offering it - bank_deposit in the response is what tells you it is available.

​
Request

​
string
required
The user paying. Onboard them first - see Bank transfers and Rheon ID.
​
string
required
The registered wallet the settled stablecoin is delivered to.
​
string
required
ISO 4217 code the user is paying in.
​
string
required
What the user will send. The details returned are for this amount - a transfer that differs is handled as described below.
​
string
Your idempotency key, up to 64 characters. A retry with the same value returns the original deposit rather than issuing a second set of details.

​
Response

​
string
The deposit id. Poll with POST /v1/bank/deposit/status.
​
object
The bank details to display, plus the payment reference. The shape follows the rail - an IBAN and BIC for SEPA, an account and sort code for UK rails, a CLABE for SPEI, a QR payload or key for PIX. Render what comes back rather than assuming a shape.
​
string
The rail these details are on.
​
string
ISO 8601. After this the details stop accepting money; money already in flight still settles.
​
string
awaiting_funds on creation.
The reference is what attributes the money. A transfer sent without it, or with it edited, has to be matched by hand and can take days. Show it exactly as returned and where the user cannot miss it.
An amount that differs from the one quoted still settles: what arrives is converted at the rate on arrival and delivered. An amount below the rail’s minimum is returned to the sending account instead, minus the rail’s own cost.

​
Errors