NOnomba
Accounts

Create a sub account

Changed on

You can use this endpoint to create a sub account that is part of your business.

post/v1/accounts

Request

  • Base URL
    https://api.nomba.com
  • URL
    https://api.nomba.com/v1/accounts
  • Auth
    HTTP bearer

Headers

accountIdstring uuid required
Example:890022ce-bae0-45c1-9b9d-ee7872e6ca27

The parent accountId of the business.

Request body

accountRefstring required

Account reference

phoneNumberstring required

Phone number

emailstring email required

Email address

bvnstring required

Bank Verification Number (BVN)

pinstring required

Personal Identification Number (PIN)

accountNamestring required

Account holder's name

currency'NGN' required

Currency code

callbackUrlstring url

Callback url

expiryDatestring date-time

Expiry date

Example request

{
  "accountRef": "1oWbJQQHLyQqqf1SwxjSpudeA21",
  "phoneNumber": "2348188667581",
  "email": "ifeol-subaccount@exmple.com",
  "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"
}

Response

Account creation successful.

codestring required

Response Code

descriptionstring required

Response description

Example response

{
  "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": "ifeol-subaccount-4@exmple.com",
    "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"
  }
}

Changes