Skip to main content

​
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
customerIdStringRequired. The unique ID of the customer to whom the bank account will be linked.
referenceStringOptional. Your unique identifier for the operation (e.g., userId).
providerStringOptional. Specifies the bank provider. If not provided, the default provider is FINTAVA. Possible values: SAFEHAVEN or FINTAVA.
currencyStringRequired. Specifies the currency.
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"
    }
}
⌘I