Core Concepts

Platform Essentials

The Verto platform is built on five core building blocks. Whether you are building an automated payout engine, an embedded finance product, or an FX conversion workflow, these foundational concepts underpin every API endpoint.


🔄 How It All Fits Together

At its core, every Verto integration follows a simple 5-step life cycle:

  1. Onboard & Setup: Create your Parent Account (and optional Sub-Accounts) and get approved by our compliance team.
  2. Fund a Wallet: Receive inbound funds via local payment rails, SWIFT, mobile money, or stablecoins.
  3. Hold a Balance: Store multi-currency balances across one or more single-currency wallets.
  4. Convert Currencies: Execute FX deals to convert between currencies before or during a payout.
  5. Pay Out: Disburse funds to external beneficiaries globally via local rails, SWIFT, or mobile money.
💡

Shortcutting Steps 3 & 4 (Inline FX): For currencies you cannot or do not want to hold in a wallet balance, Inline FX combines conversion and payout into a single atomic API call.


🧩 The Core Building Blocks

1. Accounts & Sub-Accounts

A parent Verto account can manage multiple isolated Sub-Accounts. Sub-accounts act as independent financial units with dedicated wallets, funding details, and payment flows — essential for segregating end-client funds in embedded finance setups.

Verto supports two sub-account operational models:

  • Atlas for Fintech (SUB_CLIENT): Reliance-based onboarding for licensed financial institutions serving corporate clients.
  • Atlas for Platform (PARTNER_REFERRED): Direct Verto KYB/KYC onboarding for non-regulated platforms, SaaS, or marketplaces requiring broad currency support (including USD, EUR, GBP) and custom FX markups.

📖 Read the Sub-Accounts & Atlas Selection Guide


2. Wallets & Currency Availability

A Wallet is a single-currency ledger within an account. Accounts can hold multiple wallets in the same or different currencies.

Verto classifies currencies into two operational categories:

  • Holdable Currencies: Currencies where you can maintain an ongoing wallet balance (e.g., USD, GBP, EUR, NGN).
  • Non-Holdable Currencies: Currencies where funds cannot be stored as a balance. Incoming or outgoing funds must be converted and paid out immediately via Inline FX.

📖 Read the Wallets & Currency Guide


3. Inbound Account Funding

Fund your Verto wallets using dedicated or shared account details:

  • Local Virtual Accounts: Unique domestic account details with auto-crediting.
  • SWIFT Virtual Accounts: Unique international account details for global wire transfers.
  • Pooled Accounts: Shared Verto accounts requiring a unique reference code (SmartWallet ID) for automated routing.
  • Alternative Rails: Mobile Money (M-Pesa, Tigo), Stablecoins (USDC/USDT), and instant Wallet-to-Wallet transfers.

📖 Read the Inbound Funding Guide


4. Outbound Payouts

Disburse funds to third-party bank accounts, mobile wallets, or external Verto accounts:

  • Local Payouts: Domestic payment rails (fastest and lowest cost).
  • SWIFT Payouts: Cross-border transfers to bank accounts worldwide.
  • Mobile Money: Direct payouts to mobile wallets in Kenya and Tanzania.
  • Wallet-to-Wallet: Instant internal transfers between Verto accounts.
⚠️

Note for Fintechs: Sending payouts on behalf of your end-customers requires passing a Sender object in your API payload.

📖 Read the Payouts & Sender Object Guide


5. Foreign Exchange (FX) Models

Verto provides several quote-and-book FX mechanisms depending on your liquidity and settlement requirements:

  • Instant FX: Lock a rate for 30 seconds and settle immediately from a pre-funded wallet.
  • Fund Later: Lock a rate now and fund the conversion within 24 hours.
  • Held Rate: Lock a guaranteed rate window (20–30 mins) for e-commerce checkouts.
  • Inline FX: Convert and pay out in a single step without holding a balance.
  • Indicative Quotes: Fetch non-bookable rates for real-time display and analytics.

📖 Read the FX Integration Guide


Did this page help you?