Issue an on-ramp bank account
Issue a persistent US bank account whose deposits convert to stablecoin on-chain.
destinationAssetCode and is delivered on-chain to the UPA’s connected wallet. There is no separate settlement step, and the account is reusable indefinitely.
New USD funding accounts use a server-owned developer fee of 25 bps (0.25%), deducted from each incoming deposit before conversion. Disclose developerFeeBps from the requirements response before issuing. The returned facility preserves its rate through retries; existing facilities are not automatically repriced and a null rate means unconfirmed pricing. Do not send a fee override. Banking provider costs and Payment fees are separate.
The UPA needs the bank_onramp capability approved (see Activate a regulated capability) and an active connected wallet on a verified destination chain and asset pair. Unverified pairs return payment_method_not_supported.
Only connectedWalletId and destinationAssetCode are always required in the body. Omit recipientType, recipientName and recipientAddress together to use verified details on file, indicated by recipientOnFile in the requirements response. To override those details, or when none are on file, send all three together. A partial override is rejected.
A UPA holds one current on-ramp bank account. Repeating the request returns the existing account rather than issuing a second set of banking coordinates. Routing is fixed when the account is issued: a request naming a different connected wallet, chain or destination asset returns 409, and an existing account cannot be re-pointed. Idempotency-Key is required and must contain 8–256 printable characters after trimming surrounding whitespace. Preserve the original body and key through a timeout or provisioning response. Discover eligible rails and wallets through Get on-ramp requirements.
The response shows only the bank name and the last four account digits. Call Get deposit instructions for the full details to show the account holder. See On-ramp accounts.Authorizations
Headers
Required retry key for funding-account issuance: 8-256 printable characters after trimming surrounding whitespace. Retry the identical request with the same key after a timeout or provisioning response; changed input returns 409 idempotency_conflict.
8 - 256^[^\u0000-\u001f\u007f]+$"bank-funding-account-123-v1"
Path Parameters
Body
Omit recipientType, recipientName and recipientAddress to use the name and address already verified for the UPA (see recipientOnFile on the requirements). Send all three together to override them. The recipient type must match the UPA subject type. Existing provider recipients are reused only when exactly one matches the requested name; unrelated or ambiguous recipients require operations review.
Response
On-ramp bank account
Developer fee rate frozen for this facility. 25 bps is 0.25% of each incoming deposit before conversion. Null means the existing account's rate is unconfirmed; it does not mean zero. Existing facilities are not repriced by issuance retries.
0 <= x <= 1000025