curl --request POST \
  --url https://api.nomba.com/v1/accounts/virtual \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'accountId: <accountid>' \
  --data '{
  "accountRef": "1oWbJQQHLyQqqf1SwxjSpudeA21",
  "accountName": "Daniel Scorsese",
  "currency": "NGN",
  "expiryDate": "2024-06-17 04:55:00"
}'
{
  "code": "00",
  "description": "Success",
  "data": {
    "createdAt": "2023-09-04T07:09:06.900Z",
    "accountId": "fc81b80e-e607-4b86-8591-840925191733",
    "accountHolderId": "01a10aeb-d989-460a-bbde-9842f2b4320f",
    "accountRef": "1oWbJQQHLyQqqf1SwxjSpudeA21",
    "bvn": "12234412345",
    "status": "ACTIVE",
    "type": "virtual",
    "accountName": "Daniel Scorsese",
    "expiryDate": "2024-06-17T04:55:00",
    "banks": [
      {
        "bankAccountNumber": "93910",
        "bankName": "Sterling Bank",
        "bankAccountName": "Nomba/Ifeoluwa Adeboye"
      }
    ],
    "currency": "NGN"
  }
}

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.

accountId
string
required

Account ID.

accountHolderId
string
required

Account holder ID.

accountRef
string
required

Account reference.

phoneNumber
string
required

Phone number.

email
string
required

Email address.

bvn
string
required

Bank Verification Number (BVN).

status
enum<string>
required

Account status.

type
enum<string>
required

Account type.

accountName
string
required

Account holder’s name.

banks
object[]
required

List of associated bank accounts.

bankAccountNumber
string
required

Bank account number.

bankName
string
required

Bank name.

bankAccountName
string
required

Bank account holder name.

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: <accountid>' \
  --data '{
  "accountRef": "1oWbJQQHLyQqqf1SwxjSpudeA21",
  "accountName": "Daniel Scorsese",
  "currency": "NGN",
  "expiryDate": "2024-06-17 04:55:00"
}'
{
  "code": "00",
  "description": "Success",
  "data": {
    "createdAt": "2023-09-04T07:09:06.900Z",
    "accountId": "fc81b80e-e607-4b86-8591-840925191733",
    "accountHolderId": "01a10aeb-d989-460a-bbde-9842f2b4320f",
    "accountRef": "1oWbJQQHLyQqqf1SwxjSpudeA21",
    "bvn": "12234412345",
    "status": "ACTIVE",
    "type": "virtual",
    "accountName": "Daniel Scorsese",
    "expiryDate": "2024-06-17T04:55:00",
    "banks": [
      {
        "bankAccountNumber": "93910",
        "bankName": "Sterling Bank",
        "bankAccountName": "Nomba/Ifeoluwa Adeboye"
      }
    ],
    "currency": "NGN"
  }
}