Wallets/Holding Funds
Wallets form the foundation of how funds are held and moved within your Verto Atlas account. Each wallet represents a dedicated balance in a single currency and can be used to collect, hold, or transfer funds between accounts or sub-accounts.
You can create wallets for multiple currencies, manage them via the dashboard or API, and view all associated balances in one consolidated view.
Key Capabilities
- Create Multi-Currency Wallets – Open dedicated wallets in supported currencies (e.g. USD, GBP, EUR, NGN, KES, etc.).
- Hold and Manage Balances – Securely store client or operational funds under each wallet.
- Internal Transfers – Instantly move money between wallets within the same parent account.
- Transaction Statements – Retrieve full transaction histories for reconciliation or reporting.
Before proceeding to create a wallet , you have to login as a subaccount
How It Works
Wallets are linked to your parent or sub-accounts within Atlas. Each wallet can only hold one currency, but you can create as many as you need based on your operational or client requirements.
Once a wallet is created, you can:
- Fund it through collections, incoming transfers, or payouts.
- Move funds to other wallets in the same account structure.
- Generate downloadable statements for transaction review.
Creating a Wallet
Partners can create new wallets either through the Verto dashboard or programmatically using the Wallet API.
When creating a wallet, you’ll need to specify:
- Currency – The ISO 4217 currency code (e.g. USD, KES, NGN).
- Type – Defines the wallet’s purpose.
- standard: for everyday transactions
- fx_balance: for managing FX operations
- Customer Reference Label (optional) – A custom name to easily identify the wallet. If not provided, the system automatically assigns one.
Each wallet created receives a unique walletId, which can then be used for all subsequent operations such as fetching balances, initiating transfers, or generating statements.
For developers, see the API specification:
https://beta-docs.vertofx.com/reference/create_a_wallet_new#/
Viewing Wallet Details
You can fetch wallet details such as:
- Balance
- Currency type
- Linked collection accounts
- Account mode (global, local, or multi)
Each wallet may be linked to one or two funding accounts (e.g., local and international) depending on currency support.
For technical specifications, visit:
https://beta-docs.vertofx.com/reference/get_all_funding_methods_new#/
Transferring Funds Between Wallets
The Wallet-to-Wallet API allows seamless, real-time movement of funds between wallets under the same parent account.
You’ll simply specify:
- Source Wallet ID – where funds will be deducted from.
- Target Wallet ID – where funds will be credited to.
- Currency & Amount – the amount and currency of the transfer.
- Description / Reference – an optional note or identifier for tracking.
This is ideal for internal fund allocation, currency segregation, and liquidity management.
Developers can learn more here:
https://beta-docs.vertofx.com/reference/create_transfer_new-1#/ Requesting Wallet Statements
You can easily generate statements for any wallet to view or reconcile past transactions. Statements can be requested by date range and exported in CSV or PDF format.
When a statement is ready, Verto sends the wallet statement webhook with:
"eventType": "statement.ready"Use this event type when you build your webhook consumer. Do not use wallet.statement.generated.
Parameters include:
- Wallet IDs – select one or multiple wallet IDs.
- Date range – choose “since” and “till” dates in ISO format. **
- Email (optional) – specify where the statement should be delivered.
Example formats:
- CSV (default)
https://beta-docs.vertofx.com/reference/request_wallet_statement-1#/
Updated about 2 months ago