​
Create an NGN Bank Account

​
To create an NGN bank account, the user must first be registered as a customer with approved KYC and a verified BVN. Each customer can have a bank account issued with either SafeHaven Bank or Loma Bank, but not both at the same time.

​
Endpoint

POST {{baseurl}}/accounts/generate/ngn

This is a POST request, and it should include the following parameters:

Bank NameProvider
SafeHaven BankSAFEHAVEN
Loma BankFINTAVA
FieldData TypeDescription
customerIdString

Required. The unique ID of the customer to whom the bank account will be linked.

referenceString

Optional. Your unique identifier for the operation (e.g., userId).

providerString

Optional. Specifies the bank provider. If not provided, the default provider is FINTAVA. Possible values: SAFEHAVEN or FINTAVA.

If your request is successful, the response will look like this:

{
    "success": true,
    "statusCode": 201,
    "message": "Bank account created successfully",
    "data": {
        "id": "d88343f6-f1c2-4e04-a74c-39c7add0c1f8",
        "type": "CUSTOMER",
        "accountName": "SHI / Account Name",
        "accountNumber": "1234567890",
        "bankName": "Testing Bank",
        "accountType": null,
        "bankCode": "000017",
        "accountId": "d88343f6-f1c2-4e04-8762-39c7add0c1f8",
        "currency": "NGN",
        "isVirtual": true,
        "createdAt": "2024-05-01T22:37:54.322Z",
        "updatedAt": "2024-05-01T22:37:54.322Z",
        "businessId": "0bb1dfc6-a74c-4e53-b41a-4a0c1eab188e",
        "reference": "shsi29wns02j9whdhnw012bd9dh2w",
        "customerId": "0bb1dfc6-a74c-a74c-8762-39c7add0c1f8",
        "resourceType": null,
        "status": "ACTIVE"
    }
}
WebhooksGet a bank account