Withdrawals
Fiat Payout
This flow also applies to UR Peer Transfers - fiat transfers between 2 live UR accounts.
This flow enables a fully verified (Live) user to send funds from their UR account to an external bank account. This is a high-security action that requires the user to authenticate and sign the transaction.
1. Prerequisite
The user's status must be Live.
Partner
2. Initiate Payout
The user clicks "Withdraw" or "Send to Bank" from within your app.
Partner
3. Request Payout URL
Your backend calls GET /v1/payouts/url to get a one-time URL for the Payout webview.
Partner
4. Open Payout Webview
Your app opens a secure webview with the URL provided by UR.
Partner
5. User Authenticates
Inside the webview, the user must re-authenticate (via Email/Google SSO) to securely access their private key.
UR
6. Complete & Confirm
The user fills in the payout details (amount, destination IBAN, reference) and confirms the transaction.
UR
7. Authorize & Process
The user's confirmation, combined with their authentication, authorizes UR's backend to execute the on-chain payout.
UR
8. Notify Partner
UR's backend executes the on-chain payout, and the funds are sent. UR sends a payment.sent webhook to your backend.
UR -> Partner
9. Update User
Your backend receives the webhook and updates the user's balance and transaction history in your app.
Partner
Fiat-to-Crypto Conversion (Onramp)
This flow allows a user to instantly purchase crypto from your platform using the fiat balance held in their UR bank account.
Scenario: A user has $1,000 in their embedded UR account and wants to on-ramp $500 to buy USDC.
1. Initiate On-Ramp
The user goes to the "Buy Crypto" section and chooses to pay using their available fiat balance in the embedded UR account.
Partner
2. Confirm Transaction
Partner's trading engine provides a real-time quote for the crypto purchase. The user confirms the amount.
Partner
3. Instant Fiat Settlement
Partner execute an internal transfer of $500 from the user's individual UR account to Partner's corporate UR account, enabled by . The settlement is instant.
Partner -> UR
4. Crypto Delivery
Upon confirmation of the instant fiat settlement, Partner's trading engine is triggered to purchase the crypto and deliver it to the user's connected wallet.
Partner
Last updated