Skip to main content
Issue a virtual NGN account number for a customer. The customer must already be registered with approved KYC and a verified BVN before you call this endpoint. Each customer can hold an account with either NGN-1 or NGN-2, but not both at the same time.

​
Endpoint

POST https://api-v3.reeple.ai/accounts/generate/ngn

​
Providers

Bank nameProvider
NGN Gateway 1NGN-1
NGN Gateway 2NGN-2

​
Request body

FieldTypeDescription
customerIdStringRequired. The unique ID of the customer to link the bank account to.
currencyStringRequired. The account currency.
referenceStringOptional. Your own identifier for the operation (e.g. a user ID).
providerStringOptional. NGN-1 or NGN-2. Defaults to NGN-1 if omitted.
curl -X POST https://api-v3.reeple.ai/accounts/generate/ngn \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR_SECRET_KEY" \
  -d '{
    "customerId": "0bb1dfc6-a74c-4e53-b41a-4a0c1eab188e",
    "currency": "NGN",
    "provider": "NGN-1"
  }'

​
Response

{
  "success": true,
  "statusCode": 201,
  "message": "Bank account created successfully",
  "data": {
    "id": "d88343f6-f1c2-4e04-a74c-39c7add0c1f8",
    "type": "CUSTOMER",
    "accountName": "Acme Inc / 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"
  }
}