Sub-accounts — 2. Wallet setup & account details

This guide covers creating wallets for your sub-account and generating the collection account details your clients will use to send funds.

📘

Authenticate as the sub-account using the

Sub-Account Login endpoint before proceeding. Use the returned JWT token in all requests.

Step 1 — Create a wallet

Create a wallet for the sub-account using the Create Wallet endpoint. We recommend always creating wallets explicitly via API to ensure a consistent implementation regardless of which currencies have default wallets.

The walletId returned will be used in the next step to generate account details.

Step 2 — Generate collection account details

Call the Get Funding Methods endpoint with autoCreate=true to generate collection account details for the wallet.

⚠️

autoCreate must be set to true to generate new account details.

Without it,the endpoint will only return existing account details for the wallet.

Verto supports two types of collection account details depending on the market:

Unique virtual accounts

Available for select markets, unique virtual accounts provide dedicated account details tied exclusively to the sub-account's wallet. Any funds sent to these details are automatically credited to the linked wallet — no payment reference is required.

{
  "id": 4563,
  "accountType": "local",
  "fundsType": "segregated",
  "accountName": "B Integrated",
  "accountNumber": "96566547",
  "bankCode": "608382",
  "bankName": "BankingCircle",
  "smartWalletRef": null
}

Pooled accounts with SmartWallet ID

For markets where unique virtual accounts are not available, Verto provides pooled account details shared across multiple wallets. For funds to be correctly allocated, the sender must include the smartWalletRef in the payment reference of every inbound transfer. Verto handles reconciliation automatically based on this reference.

{
  "id": 4562,
  "accountType": "local",
  "fundsType": "pooled",
  "accountName": "Verto Pooled Account",
  "accountNumber": "12345678",
  "bankCode": "608382",
  "bankName": "BankingCircle",
  "smartWalletRef": "SW-00123456"
}

⚠️

SmartWallet ID

For pooled accounts, your client's sender must include the smartWalletRef value in the payment reference on every transfer. Missing or incorrect references will prevent automatic allocation and will require manual reconciliation. Make sure to communicate this requirement clearly to your clients.

Account detail types summary