> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reeple.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create an NGN bank account

> Issue a virtual NGN bank account for a customer

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.            |

```bash theme={null}
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

```json theme={null}
{
  "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"
  }
}
```