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"
}'
{
  "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",
    "accountName": "Daniel Scorsese",
    "currency": "NGN",
    "callbackUrl": "https://webhook.site/98ef100f-5adc-4434-800a-0808h60bd8d7"
  }
}

Create a sub account

Create a sub account for your customers

POST /v1/accounts

Request body

accountRef
string
required

Account reference (a reference on your system that uniquely identifies the account (user) within your own ecosystem)

phoneNumber
string
required

Phone number (you can also use the phone number of the main account)

email
string
required

Email address (you can also use the email address of the main account)

bvn
string
required

Bank Verification Number (BVN)

pin
string
required

Personal Identification Number (PIN)

accountName
string
required

Account holder’s name

currency
string

Currency code

callbackUrl
string

Callback url (if passed, will attach an event to this account such that for every successful payment, a notification is sent to this url)

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 (this is the ID of the parent account)

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.

accountName
string
required

Account holder’s name.

currency
string
required

Currency code.

callbackUrl
string

Callback url.

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"
}'
{
  "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",
    "accountName": "Daniel Scorsese",
    "currency": "NGN",
    "callbackUrl": "https://webhook.site/98ef100f-5adc-4434-800a-0808h60bd8d7"
  }
}