Nigeria payout

Payment Account Types

The supported payment account type in Nigeria is:

BANK_ACCOUNT

Banks

We support payouts to various banks in Nigeria. To retrieve the most current list of supported banks, use the list banks endpoint.

Decimal Requirements

Payment Account Type	Decimals Allowed
BANK_ACCOUNT	2

Transaction Limits

Payment Account Type	Minimum Amount (₦)	Maximum Amount (₦)
BANK_ACCOUNT	100	50,000,000

Compliance Requirements

Field	Requirements
sender.type	Required
sender.name	Required
sender.address.line1	Required
sender.address.city	Required
sender.address.postal_code	Required
sender.address.country	Required
sender.individual.dob	Required (with type `INDIVIDUAL`)
sender.individual.identity_document.type	Required (with type `INDIVIDUAL`)
sender.individual.identity_document.country	Required (with type `INDIVIDUAL`)
sender.individual.identity_document.number	Required (with type `INDIVIDUAL`)
sender.individual.identity_document.expires_on	Required (with type `INDIVIDUAL`)

Sample payload

The samples below are specific to Nigeria and based off the local regulations.

For a more Comprehensive list of fields, see the Payout resource.

Send to BANK_ACCOUNT

ℹ️
Info: The bank_id shown in this sample refers to a fictitious bank in our sandbox environment. It is intended for testing only and will not work in production. In production, retrieve the current list of supported banks and use a real bank_id for the destination country via the List banks endpoint.

{
  "amount": {
    "currency": "NGN",
    "value": "1250.00"
  },
  "payment_account": {
    "type": "BANK_ACCOUNT",
    "country": "NG",
    "holder": {
      "type": "INDIVIDUAL",
      "name": "Emeka Okafor"
    },
    "bank_account": {
      "bank_id": "bnk-2c5jWiL5KzRK3rnBnH0pvO2coF1",
      "number": "0123456789"
    }
  },
  "sender": {
    "type": "INDIVIDUAL",
    "name": "Mario Rossi",
    "address": {
      "line_1": "Piazza del Colosseo",
      "line_2": "1",
      "line_3": "",
      "city": "Roma",
      "postal_code": "00184",
      "country": "IT"
    },
    "individual": {
      "dob": "1985-06-15",
      "identity_document": {
        "type": "PASSPORT",
        "country": "IT",
        "number": "YA0000000",
        "expires_on": "2030-01-01"
      }
    }
  }
}