Accounts
Create a sub account
You can use this endpoint to create a sub account that is part of your business.
POST
/
v1
/
accounts
Authorizations
Authorization
string
headerrequiredNomba 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
requiredThe parent accountId of the business.
Body
application/json
accountRef
string
requiredAccount reference
Required string length:
16 - 64
phoneNumber
string
requiredPhone number
Required string length:
11 - 15
email
string
requiredEmail address
bvn
string
requiredBank Verification Number (BVN)
Required string length:
11
pin
string
requiredPersonal Identification Number (PIN)
Required string length:
4
accountName
string
requiredAccount holder's name
Required string length:
8 - 64
currency
enum<string>
requiredCurrency code
Available options:
NGN
callbackUrl
string
Callback url
expiryDate
string
Expiry date
Response
200 - application/json
code
string
requiredResponse Code
description
string
requiredResponse description
data
object
required