# Nigeria

## Required fields

| Field                  | Format                                                                                                              | Description                                                                                                      |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| `login`                | String                                                                                                              | Cashouts login                                                                                                   |
| `pass`                 | String                                                                                                              | Cashouts pass                                                                                                    |
| `external_id`          | String (max length: 100)                                                                                            | Transaction's ID on your end                                                                                     |
| `document_id`          | See [document validations](https://docs.lime-pay.com/knowledge-base/countries-specifications#documents-validations) | Beneficiary's document ID                                                                                        |
| `country`              | `NG`                                                                                                                | See [country codes](https://docs.lime-pay.com/knowledge-base/countries-specifications#countries-and-currencies)  |
| `currency`             | `NGN` / `USD`                                                                                                       | See [currency codes](https://docs.lime-pay.com/knowledge-base/countries-specifications#countries-and-currencies) |
| `amount`               | Number with up to 2 decimals                                                                                        | Cashout amount                                                                                                   |
| `bank_account`         | See [validations below](#document-validations)                                                                      | Beneficiary's bank account                                                                                       |
| `bank_code`            | See [bank codes](https://docs.lime-pay.com/api-documentation/cashouts-api/endpoints/cashout-bank-codes)             | Code specifying the beneficiary's bank                                                                           |
| `beneficiary_name`     | String (max length: 100)                                                                                            | Beneficiary's name                                                                                               |
| `beneficiary_lastname` | String (max length: 100)                                                                                            | Beneficiary's last name                                                                                          |

## Bank Account Validations

| Bank name | Bank code | Format  | Example               |
| --------- | :-------: | ------- | --------------------- |
| All       |     -     | Numeric | 123456789, 9283749293 |

## Document Validations

[Click here](https://docs.lime-pay.com/knowledge-base/countries-specifications#documents-validations) to check document types and validations.

## Example Request

{% tabs %}
{% tab title="Request" %}

```
{
    "login": "xxxxxxx",
    "pass": "xxxxxxx",
    "external_id": "30000000001",
    "country": "NG",
    "amount": 100,
    "currency": "NGN",
    "bank_account": "123456789",
    "bank_code": "11", 
    "document_id": "892374233",
    "beneficiary_name": "User",
    "beneficiary_lastname": "Test",
    "notification_url": "https://webhook.site/url",
    "type": "json"
}
```

{% endtab %}

{% tab title="Response" %}

```
external_id=100365001A2538925094
cashout_id=197824123
date=2025-03-18 10:10:10
bank_reference_id=999999250318115805775951234567
comments=
control=50553B0A13419744FF8CFFAD6711829863B5152E702FCDB123456789735671
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
We now return session ID for cashouts in Nigeria as the bank\_reference\_id field in the API response as well as the API callback
{% endhint %}

## Bank Codes

{% hint style="info" %}
For the full and most up-to-date list of banks and its codes, please check the [Cashout Bank Code endpoint.](https://docs.lime-pay.com/api-documentation/cashouts-api/endpoints/cashout-bank-codes)
{% endhint %}

| Bank                      | Bank Code |
| ------------------------- | --------- |
| Polaris Bank              | 8         |
| Taj Bank                  | 26        |
| Globus Bank               | 103       |
| Titan-Paystack            | 100039    |
| Paga                      | 327       |
| One Finance               | 100026    |
| GoMoney                   | 100022    |
| Keystone Bank Ltd         | 82        |
| Kuda Bank                 | 50211     |
| Zenith Bank International | 100034    |

{% hint style="info" %}
For the full and most up-to-date list of banks and its codes, please check the [Cashout Bank Code endpoint.](https://docs.lime-pay.com/api-documentation/cashouts-api/endpoints/cashout-bank-codes)
{% endhint %}