NGN (Nigerian Naira) Account
This section describes the requirements for creating a virtual account in Naira(NGN). In this section, the payloads have been separated into the requirements for individual and corporate accounts. Please take time to go through each request properly.
You can use the Virtual account API to create permanent and temporary NGN Virtual Accounts.
Hey ๐ , we recommend reading the sections below because they are critical to understanding each virtual account request.
Multiple Bank Options
You can request a Virtual Accounts from our supported bank with the Virtual Account API. Please see the API Documentation for the parameters needed to create virtual accounts in NGN. Listed below are the banks that are supported in the creation of NGN virtual accounts.
Here is a list of banks that we support for the creation of NGN Virtual Accounts.
S/N | Bank | Value |
---|---|---|
1 | Globus Bank | globus |
Endpoint Parameters
These parameters can be tested on an API explorer by calling the various endpoints supported for creating virtual accounts :
- Create a virtual account : This endpoint can be used to request a Virtual Account in any currency
{{host}}/profile/virtual-accounts/requests
Note
- After a virtual account creation request is made, a response with a data object containing a unique identifier
_id
of the virtual account will be returned, which will also be included in the webhook sent asid
if the virtual account is declined or approved. bvn
is required when creating permanent virtual accounts- Funds transfers made to NGN accounts are instant
- The name on the BVN must correspond with both the
KYCInfomation.firstName
,KYCInfomation.lastName
orKYCInfomation.bvnName
sent in the payload, otherwise, the following error will be received:BVN doesn't match the provided name
- The order of arrangement of the
bvnName
matters when verifying against the name on the BVN. Kindly pass the exact value as it is on theBVN
e.g Fincra developers == Fincra developers
Individual Request
These are the fields required to process an individual virtual account request in NGN
Field | Mandatory | type | Description |
---|---|---|---|
currency | Yes | string | The virtual account currency.e.g NGN |
accountType | Yes | string | The virtual account type . Please see the API documentation for more details |
channel | No | string | The value should be globus for globus bank accounts . |
dateOfBirth | No | string | The date of birth of the customer. |
KYCInformation.firstName | Yes | string | The customer's first name . This is required to create an individual account |
KYCInformation.lastName | Yes | string | The customer's last name . This is required to create an individual account |
KYCInformation.email | No | string | The customer's email. |
KYCInformation.bvn | Yes | string | Bank verification number. |
The payload should look like this :
{
"dateOfBirth": "10-12-1993",
"accountType": "individual",
"currency": "NGN",
"KYCInformation": {"firstName": "rita", "lastName": "general", "bvn": "090909909"},
"channel": "globus"
}
Corporate Request
These are the fields required to process an individual Virtual Account request in NGN
Field | Mandatory | type | Description |
---|---|---|---|
currency | yes | string | The virtual account currency.e.g NGN |
accountType | yes | string | The virtual account type . Please see the API documentation for more details |
channel | No | string | The value should be wema for wema bank accounts and vfd for VFD bank accounts. wema is the default channel |
dateOfBirth | No | string | The date of birth of the customer. required only when creating VFD virtual accounts in NGN. Format (mm/dd/yyyy ) |
bvn | No | string | Bank verification number. compulsory for vfd bank accounts . This must be the date of birth on thee customer's BVN |
KYCInformation.email | No | string | The customer's email. |
KYCInformation.businessName | Yes | string | The customer's business name . |
KYCInformation.bvn | Yes | string | Bank verification number. |
KYCInformation.bvnName | Yes | string | The name you want to be on the account. This must be the same name on the customer'sBVN |
The payload should look like this :
{
"dateOfBirth": "10-12-1993",
"accountType": "corporate",
"currency": "NGN",
"KYCInformation": {"bvn": "90909090909", "bvnName": "jane foster", "businessName": "jane"},
"channel": "globus"
}
Please note that the BVN provided for a corporate account request must match the details of any of the directors or shareholders on the CAC record for the corporate entity
Updated 9 months ago