curl --request POST \
  --url https://api.nomba.com/v1/accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'accountId: <accountid>' \
  --data '{
  "accountRef": "1oWbJQQHLyQqqf1SwxjSpudeA21",
  "phoneNumber": "2348188667581",
  "email": "[email protected]",
  "bvn": "12234412345",
  "pin": "1234",
  "accountName": "Daniel Scorsese",
  "currency": "NGN",
  "callbackUrl": "https://webhook.site/98ef100f-5adc-4434-800a-0808h60bd8d7",
  "expiryDate": "2023-12-06T15:46:43.000Z"
}'

{
  "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",
    "phoneNumber": "2348188667581",
    "email": "[email protected]",
    "bvn": "12234412345",
    "status": "ACTIVE",
    "type": "virtual",
    "accountName": "Daniel Scorsese",
    "currency": "NGN",
    "callbackUrl": "https://webhook.site/98ef100f-5adc-4434-800a-0808h60bd8d7",
    "expiryDate": "2023-12-06T15:46:43.000Z"
  }
}

Create a sub account

Create a sub account for your customers

​
POST /v1/accounts

​
Request body

accountRef
string
required

Account reference

phoneNumber
string
required

Phone number

email
string
required

Email address

bvn
string
required

Bank Verification Number (BVN)

pin
string
required

Personal Identification Number (PIN)

accountName
string
required

Account holder’s name

currency
string
required

Currency code

callbackUrl
string
required

Callback url

expiryDate
string
required

Expiry date

​
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.

currency
string
required

Currency code.

callbackUrl
string

Callback url.

expiryDate
string

Expiry date.

IntroductionCreating virtual accounts