# 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.pandablue.com/specifications/countries-specifications#documents-validations)                        | Beneficiary's document ID                                                                                         |
| `country`              | `NG`                                                                                                                                        | See [country codes](https://docs.pandablue.com/specifications/countries-specifications#countries-and-currencies)  |
| `currency`             | `NGN` / `USD`                                                                                                                               | See [currency codes](https://docs.pandablue.com/specifications/countries-specifications#countries-and-currencies) |
| `amount`               | Number with up to 2 decimals                                                                                                                | Cashout amount                                                                                                    |
| `bank_account`         | See [validations below](https://docs.pandablue.com/api-documentation/cashouts-api/countries-validations/african-countries/broken-reference) | Beneficiary's bank account                                                                                        |
| `bank_code`            | See [bank codes](https://docs.pandablue.com/api-documentation/cashouts-api/countries-validations/african-countries/broken-reference)        | 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.pandablue.com/specifications/countries-specifications#documents-validations) to check document types and validations.

## Example Request

```java
{
    "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"
}
```

## Bank Codes

| Bank                       | Code |
| -------------------------- | ---- |
| First Bank of Nigeria Plc  | 011  |
| Heritage Bank              | 030  |
| Union Bank Nigeria Plc     | 032  |
| United Bank for Africa Plc | 033  |
| WEMA Bank Plc              | 035  |
| Access Bank Plc            | 044  |
| Ecobank Nigeria            | 050  |
| Zenith Bank International  | 057  |
| Guaranty Trust Bank Plc    | 058  |
| Fidelity Bank Plc          | 070  |
| Keystone Bank Ltd          | 082  |
| First City Monument Bank   | 214  |
| Unity Bank Plc             | 215  |
| Sterling Bank Plc          | 232  |
| Jaiz Bank                  | 301  |

{% 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.pandablue.com/api-documentation/cashouts-api/endpoints/cashout-bank-codes)
{% endhint %}