Create an NGN bank account

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 name	Provider
NGN Gateway 1	`NGN-1`
NGN Gateway 2	`NGN-2`

Request body

Field	Type	Description
`customerId`	String	Required. The unique ID of the customer to link the bank account to.
`currency`	String	Required. The account currency.
`reference`	String	Optional. Your own identifier for the operation (e.g. a user ID).
`provider`	String	Optional. `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"
  }
}

Get Started

Bank Accounts

Bill Payments

Collections

Compliance

Customer

External Services

Gift Cards

Payment Links

Payouts

Refunds

S2S Payments

Transactions

Tuition

Create an NGN bank account

Endpoint

Providers

Request body

Response

​Endpoint

​Providers

​Request body

​Response

Endpoint

Providers

Request body

Response