Core Banking Overview
An overview of fund movements on UR.
This guide provides a high-level overview of the core products that power all money movement on the UR platform. These modules are the engine that connects your platform to the global banking system and creates a seamless, closed-loop financial ecosystem for your users.
You can use these products individually or combine them to create sophisticated applications, from simple "cash-out" features to a fully embedded banking experience.
Key Capabilities
The core banking suite is built on two primary pillars:
Fiat Money Movement: Moving fiat (e.g., EUR, CHF) between a user's UR account and the traditional banking system.
Asset Conversions: Instantly converting assets between crypto (held on your platform) and fiat (held in the user's UR account).
1. Fiat Money Movement (Bank Transfers)
This pillar connects your user's account to the traditional banking world, allowing them to move funds to and from any external bank account. These features are generally reserved for fully verified, Live status users.
Fiat Deposits (External)
What it is: This flow allows a user to fund their UR account by sending a bank transfer from an external source (e.g., their salary, another bank account).
How it works: After a user is fully verified (
Live), you can call our API to retrieve their personal Swiss IBAN. The user then uses this IBAN to send a SEPA or SWIFT transfer. When the funds arrive, we send you apayment.receivedwebhook so you can update their balance in your app.Use Case: Enabling users to "cash in" to the ecosystem or receive payments from third parties.
Fiat Payouts (External)
What it is: This flow allows a user to withdraw fiat from their UR account and send it to an external bank account.
How it works: This is a high-security action. Your platform initiates the request, and we provide a secure webview for the user to authenticate (via Email/SSO) and authorize the on-chain transfer. This provides a seamless UX while ensuring the user is the only one who can move their money out.
Use Case: Enabling users to "cash out" to the traditional financial world, such as sending funds to their primary bank or paying a bill.
2. Asset Conversions (On/Off-Ramps)
This pillar creates a powerful, "closed-loop" economy within your platform. It allows users to move seamlessly between their crypto assets (managed by you) and their new fiat balance (managed by UR), all without the friction of external bank transfers.
Crypto-to-Fiat (Off-Ramp)
What it is: This is the core "cash out" flow. It allows a user to sell crypto from their balance on your platform and instantly receive fiat in their UR account.
How it works: Your platform requests a quote, the user confirms, and you execute the trade. Our backend performs an atomic settlement: we debit crypto from your corporate omnibus account and simultaneously credit the corresponding fiat to the end-user's personal UR account.
Use Case: This is the primary feature for
Touristusers, allowing them to off-ramp and see immediate value before completing full KYC.
Fiat-to-Crypto (On-Ramp)
What it is: This is the "closed-loop" on-ramp. It allows a user to buy crypto from you by using the fiat balance they already hold in their UR account.
How it works: The user confirms a quote, and your platform calls our API to execute an instant, internal fiat transfer from the user's account to your corporate omnibus account. Once you receive our "success" webhook, you can release the crypto to the user's wallet.
Use Case: Creating a frictionless experience, increasing your platform's volume and user engagement by removing the wait time for bank transfers.
Coming Soon
This guide will be expanded to include other core banking features as they become available:
Internal Transfers (P2P): Instantly move fiat between two UR users.
FX (Fiat-to-Fiat): Allow users to swap fiat balances (e.g., EUR to USD).
Card Programs: Issue co-branded debit cards for users to spend their fiat balance.
Last updated