Skip to main content
POST
Create virtual account

Authorizations

Authorization
string
header
required

Nomba authenticates API calls with OAuth2 HTTP bearer tokens. There are two methods of authentication; Client-Credentials method and PKCE (Proof Key for Code Exchange) method. In each of the methods, You will get an ACCESS_TOKEN. You need to use an "Authorization" HTTP header to provide your ACCESS_TOKEN. For example: Authorization: {ACCESS_TOKEN}.

Headers

accountId
string<uuid>
required

The parent accountId of the business.

Example:

"890022ce-bae0-45c1-9b9d-ee7872e6ca27"

Body

application/json

The request payload required to create an account

accountRef
string
required

Account reference

Required string length: 16 - 64
Example:

"1oWbJQQHLyQqqf1SwxjSpudeA21"

accountName
string
required

Account holder's name

Required string length: 8 - 64
Example:

"Daniel Scorsese"

bvn
string

Account holder's BVN. Optional.

Example:

"12345678"

nin
string

Account holder's National Identification Number (NIN). Optional. Must be exactly 11 digits. Can be sent on its own or alongside bvn. If neither is sent, the BVN on the parent business account is used.

Required string length: 11
Pattern: ^\d{11}$
Example:

"12345678901"

expiryDate
string

Account expiry date. Optional. ⚠️Be careful with this.

Example:

"2026-01-30 12:15:00"

expectedAmount
number<double>

Amount the account can receive. Optional.

Example:

"200.00"

Response

Virtual account creation successful.

code
string
required

Response Code

Example:

"00"

description
string
required

Response description

Example:

"Success"

data
object
required