> For the complete documentation index, see [llms.txt](https://docs.ur.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ur.app/concepts/ur-account.md). # UR Account The UR Account is a hybrid financial infrastructure that bridges FINMA-supervised Swiss banking (via Fiat24) with Web3 settlement rails. It functions as the user's regulated fiat account linked to an active [URID](/concepts/urid.md). Fiat balances are issued as [tokenized deposits](/concepts/tokenized-deposits.md) (e.g., USD24, EUR24) on Mantle Network, backed 1:1 by fiat reserves held by UR's regulated Swiss banking entity (Fiat24, FINMA-supervised). This architecture provides users with a fully compliant banking interface — including personal Swiss IBANs and Mastercard debit card capabilities — while enabling instant, atomic on-chain settlement for crypto-to-fiat conversions, card spending, and cross-border transfers. ## How a UR Account holds assets Every UR Account is backed by an on-chain wallet address on Mantle Network. Tokenized deposits (e.g., USD24, EUR24) are ERC-20 tokens held at this address. How assets are split depends on the integration mode: * **Managed Custody Mode** *(new feature)* — UR manages the user's fiat account (tokenized deposits, IBAN, card). The user's crypto can be held in the same UR-managed account, or in a separate non-UR wallet (partner-side or the user's own); in the latter case crypto enters the UR Account via off-ramp. Either way, the fiat account is always UR-managed. * **External Wallet Access Mode** — Both fiat (tokenized deposits) and crypto live in the user's single external wallet. The UR Account and the user's wallet are the same address. * **Delegated Mode** *(will be deprecated soon)* — Similar to Managed Custody; UR manages the wallet via delegated smart contracts. The user performs a one-time delegation during onboarding. Being replaced by Managed Custody Mode. In both cases, the UR Account provides a regulated Swiss bank account issued by UR's banking entity, Fiat24 (for fiat rails, IBAN, and card), with on-chain settlement for all operations. ## What a UR Account includes * **Personal Swiss IBAN** — receive SEPA Instant and SWIFT transfers directly * **Multi-currency balances** — hold EUR, USD, CHF, CNH, SGD, JPY, and HKD as tokenized deposits * **Mastercard debit card** — spend fiat balances anywhere Mastercard is accepted; settlement happens on-chain in milliseconds * **Instant FX** — convert between supported currencies atomically (burn one token, mint another in a single transaction) * **On-chain transparency** — balances and transactions are recorded on Mantle Network, fully auditable ## Account structure by integration mode How the account is provisioned depends on how your platform integrates with UR: * [**Managed Custody Mode**](/integration-methods/managed-custody-mode.md) *(new feature, recommended)* — UR manages a fiat account per user (tokenized deposits, IBAN, card). The user's crypto can sit in the UR-managed account itself, or in a separate non-UR wallet (partner-side or the user's own). The partner backend orchestrates all fiat actions via API. * [**External Wallet Access Mode**](/integration-methods/external-wallet-access-mode.md) — Users connect their own wallet (e.g., MetaMask, SafePal). The URID is minted directly to their address, and they interact with UR through your UI or directly on-chain. * [**Delegated Mode**](/integration-methods/delegated-mode.md) *(will be deprecated soon)* — Legacy API-driven integration via delegated smart contracts. Existing partners on this mode continue to be supported. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.ur.app/concepts/ur-account.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.