curl --request POST \
  --url https://api.nomba.com/v1/accounts/virtual \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'accountId: <parent accountId>' \
  --data '{
  "accountRef": "1oWbJQQHLyQqqf1SwxjSpudeA21",
  "accountName": "Daniel Scorsese",
  "currency": "NGN",
  "expiryDate": "2024-06-17 04:55:00"
}'

{
  "code": "00",
  "description": "Success",
  "data": {
    "createdAt": "2024-10-11T14:15:39.376Z",
    "accountRef": "Archie Friesen",
    "accountHolderId": "8d19d421-85b1-4b61-be90-168dc261gf45",
    "accountName": "John Doe",
    "currency": "NGN",
    "bankAccountNumber": "9171424569",
    "bankAccountName": "Ayomide Akinrotoye",
    "bankName": "Amucha MFB",
    "bvn": "22122204392",
    "expiryDate": "2024-10-12T12:30:49",
    "expired": false
  }
}

Create a virtual account

Accept payments with virtual accounts

​
POST /v1/accounts/virtual

​
Request body

​
accountRef
string
required

Account reference

​
accountName
string
required

Account holder’s name

​
currency
string
required

Currency code

​
expiryDate
string

Expiry Date (This field allows you to customize the expiry period for this account. The default time however is 5 minutes)

​
Response body

​
code
string
required

Response code

​
description
string
required

Response description

​
data
object
​
createdAt
string
required

Creation timestamp.

​
accountHolderId
string
required

Account holder ID.

​
accountRef
string
required

Account reference.

​
bvn
string
required

Bank Verification Number (BVN).

​
accountName
string
required

The name associated with the account (may return the parent account name if not a corporate account)

​
bankAccountNumber
string
required

The account number

​
bankAccountName
string
required

The account name that will reflect when doing name lookup

​
currency
string
required

Currency code.

​
expiryDate
string

Expiry date of the account created.

curl --request POST \
  --url https://api.nomba.com/v1/accounts/virtual \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'accountId: <parent accountId>' \
  --data '{
  "accountRef": "1oWbJQQHLyQqqf1SwxjSpudeA21",
  "accountName": "Daniel Scorsese",
  "currency": "NGN",
  "expiryDate": "2024-06-17 04:55:00"
}'

{
  "code": "00",
  "description": "Success",
  "data": {
    "createdAt": "2024-10-11T14:15:39.376Z",
    "accountRef": "Archie Friesen",
    "accountHolderId": "8d19d421-85b1-4b61-be90-168dc261gf45",
    "accountName": "John Doe",
    "currency": "NGN",
    "bankAccountNumber": "9171424569",
    "bankAccountName": "Ayomide Akinrotoye",
    "bankName": "Amucha MFB",
    "bvn": "22122204392",
    "expiryDate": "2024-10-12T12:30:49",
    "expired": false
  }
}
IntroductionFetching account balance