Virtual Accounts API: NGN Bank Account Management & Fees

The Virtual Accounts API provides two endpoints for retrieving Nigerian bank account details used in the cNGN onramp flow. Your fintech has a permanent pooled account for collecting NGN deposits, and each user deposit request is associated with a dedicated virtual account that carries a full fee breakdown - letting your users know exactly how much to send and how much will be credited to their wallet.

New to virtual accounts? Read the Virtual Accounts Guide for an overview of account types, the deposit lifecycle, BVN validation requirements, and best practices before integrating these endpoints.

Endpoints Overview

Section	Endpoint	Method	Description
Get Fintech Virtual Account	`/getfintechvirtualaccount`	GET	Retrieve the NGN virtual account(s) assigned to your fintech at onboarding.
Get Virtual Account	`/getvirtualaccount`	POST	Retrieve a specific user deposit virtual account including amounts and fee breakdown.

GET /getfintechvirtualaccount

Returns the NGN virtual account(s) created for your fintech during the Strails onboarding process. This is the pooled account your users direct NGN deposits to before conversion into cNGN. Display this account information to your users in your onramp UI.

curl -X GET https://api.strails.io/v1/getfintechvirtualaccount \
  -H "x-api-key: YOUR_SECRET_API_KEY"

This endpoint requires no request body.

Response

{
  "status": "Success",
  "response_code": "00",
  "message": "Virtual account retrieved successfully",
  "data": {
    "virtualAccounts": [
      {
        "accountNumber": "1234567890",
        "accountName": "Example Fintech Ltd",
        "bankName": "ALP Bank",
        "provider": "nutmeg",
        "status": "active",
        "createdAt": "2026-01-04T05:26:39.804Z"
      }
    ]
  }
}

array

An array of virtual account objects assigned to your fintech. Most fintechs have one account, but multiple accounts may be present if you have been assigned accounts across more than one banking provider.

string

The 10-digit NUBAN account number users send NGN deposits to.

string

The account name as registered with the bank. Display this to users alongside the account number for payment confirmation.

string

The name of the Nigerian bank or microfinance institution holding the virtual account.

string

The virtual account infrastructure provider (e.g. "nutmeg", "redbiller", "novac").

string

Current account status. "active" means the account can receive deposits.

string

ISO 8601 timestamp indicating when the virtual account was provisioned.

POST /getvirtualaccount

Retrieves a specific user-level virtual account using the requestId generated when the deposit request was created. The response includes the exact amounts your user must transfer, a full fee breakdown, and the destination wallet address that will receive the equivalent cNGN.

curl -X POST https://api.strails.io/v1/getvirtualaccount \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_SECRET_API_KEY" \
  -d '{
    "requestId": "a9f706ad-6861-4669-904a-5d4e0d9963c3"
  }'

Request Parameters

string

required

The unique identifier of the deposit request whose virtual account details you want to retrieve. This is returned when a user initiates a deposit or onramp request.

Virtual accounts for individual deposit requests expire 30 minutes after creation. If your user does not complete the NGN transfer within this window, the account will be marked as expired and you will need to create a new deposit request. Do not instruct users to send funds to an expired account.

Response

{
  "status": "Success",
  "response_code": "00",
  "message": "Virtual account retrieved successfully. Virtual account amount is before gateway fee. User must pay total amount including all fees.",
  "data": {
    "requestId": "a1b2c3d4-5678-90ab-cdef-111213141516",
    "virtualAccount": {
      "accountNumber": "0123456789",
      "bankName": "Example Bank",
      "accountName": "Company Name/John Doe Smith",
      "amount": 528.84,
      "createdAt": "2026-06-09T08:33:17.614Z",
      "baseAmount": 520,
      "feeAmount": 8.84,
      "totalAmountWithFee": 528.84,
      "feeBreakdown": {
        "userRequestedAmount": 520,
        "fintechFeeAmount": 0,
        "fintechFeePercentage": 0,
        "fintechFeeCapped": false,
        "strailsFeeAmount": 8.84,
        "strailsFeePercentage": 1.7,
        "strailsFeeCapped": false,
        "totalFeeAmount": 8.84,
        "finalAmount": 528.84,
        "amountToWallet": 520
      }
    },
    "status": "created",
    "walletAddress": "0xAbC123dEf456GhI789jKl012MnO345pQrS678tUv",
    "version": "1.0.0"
  }
}

string

The unique identifier for this deposit request, matching the requestId you submitted.

string

The 10-digit NUBAN account number the user must send NGN to for this specific deposit.

string

The bank where the virtual account is held.

string

The account name displayed during bank transfers, typically in the format "Fintech Name/User Full Name".

number

The exact NGN amount the user must send, including all fees. Always use this figure - not baseAmount - when presenting the transfer amount to your user.

object

A detailed breakdown of how the total amount was calculated, including fintech and Strails fee components.

Show feeBreakdown fields

number

The NGN amount the user originally requested to deposit, before any fees are applied.

number

The flat NGN fee amount charged by your fintech for this transaction. 0 if your fintech has not configured a fee.

number

The percentage rate used to calculate the fintech fee. 0 if no fintech fee is configured.

boolean

true if your fintech’s fee is subject to a maximum cap. false if the fee scales without a ceiling.

number

The flat NGN fee amount charged by Strails for processing the deposit.

number

The percentage rate used to calculate the Strails fee (e.g. 1.7 represents 1.7%).

boolean

true if the Strails fee is subject to a maximum cap. false if the fee scales without a ceiling.

number

The combined fee amount: fintechFeeAmount + strailsFeeAmount.

number

The total NGN the user must transfer: userRequestedAmount + totalFeeAmount. Equivalent to totalAmountWithFee.

number

The cNGN amount that will be credited to the user’s wallet after fees are deducted. Equivalent to userRequestedAmount.

string

Current status of the deposit request. "created" means the account is active and awaiting the user’s transfer.

string

The EVM wallet address that will receive the cNGN equivalent once the NGN deposit is confirmed.

Error Responses

{
  "status": "Error",
  "response_code": "02",
  "message": "Virtual account not found",
  "error": "No virtual account found with the provided requestId"
}

{
  "status": "Error",
  "response_code": "01",
  "message": "Virtual account expired",
  "error": "This virtual account has expired (30 min timeout)"
}

Overview

Core APIs

FX & Trading

Configuration

Virtual Accounts API: NGN Bank Account Management & Fees

Endpoints Overview

GET /getfintechvirtualaccount

Response

POST /getvirtualaccount

Request Parameters

Response

Error Responses

​Endpoints Overview

​GET /getfintechvirtualaccount

​Response

​POST /getvirtualaccount

​Request Parameters

​Response

​Error Responses

Endpoints Overview

GET /getfintechvirtualaccount

Response

POST /getvirtualaccount

Request Parameters

Response

Error Responses