LogoLogo
Document ValidationsPayment Methods
  • Welcome to LimePay API Docs
  • Getting Started with Lime-Pay
  • API Documentation
    • Deposits API
      • Technical and Security Aspects
        • Calculating the Signature
      • Endpoints
        • Deposit Creation Endpoint
          • Notifications
        • Deposit Status Endpoint
        • Payment Methods Endpoint
        • Currency Exchange Endpoint
        • Refund Creation Endpoint
          • Notifications
        • Refund Status Endpoint
      • Payment Methods
        • 🌍Africa
          • 🇧🇯Benin
          • 🇧🇼Botswana
          • 🇨🇲Cameroon
          • 🇨🇬Congo Brazzaville
          • 🇨🇩Congo DRC
          • 🇪🇬Egypt
          • 🇬🇦Gabon
          • 🇬🇭Ghana
          • 🇨🇮Ivory coast
          • 🇰🇪Kenya
          • 🇲🇼Malawi
          • 🇲🇱Mali
          • 🇳🇬Nigeria
          • 🇷🇼Rwanda
          • 🇿🇦South Africa
          • 🇹🇿Tanzania
          • 🇹🇬Togo
          • 🇺🇬Uganda
          • 🇿🇲Zambia
        • 🌏Asia
          • 🇧🇩Bangladesh
          • 🇨🇳China
          • 🇭🇰Hong Kong
          • 🇮🇳India
          • 🇮🇩Indonesia
          • 🇯🇵Japan
          • 🇲🇾Malaysia
          • 🇵🇰Pakistan
          • 🇹🇭Thailand
          • 🇹🇷Turkey
          • 🇻🇳Vietnam
      • API Codes
    • Cashouts API
      • Technical and Security Aspects
        • Calculating the Payload-Signature
      • Endpoints
        • Cashout Creation Endpoint
          • Notifications
        • Cashout Status Endpoint
        • Cashout Update Status Endpoint
        • Cashout Cancellation Endpoint
        • Cashout Bank Codes
      • Countries Validations
        • 🌍African Countries
          • 🇧🇼Botswana
          • 🇨🇲Cameroon
          • 🇨🇬Congo Brazzaville
          • 🇨🇩Congo DRC
          • 🇪🇬Egypt
          • 🇬🇭Ghana
          • 🇰🇪Kenya
          • 🇲🇼Malawi
          • 🇳🇬Nigeria
          • 🇷🇼Rwanda
          • 🇿🇦South Africa
          • 🇿🇲Zambia
          • 🇬🇦Gabon
        • 🌏Asian Countries
          • 🇧🇩Bangladesh
          • 🇨🇳China
          • 🇮🇳India
          • 🇮🇩Indonesia
          • 🇯🇵Japan
          • 🇲🇾Malaysia
          • 🇹🇭Thailand
          • 🇹🇷Turkey
          • 🇻🇳Vietnam
          • 🇵🇰Pakistan
      • API Codes
    • Reconciliation API
      • Technical and Security Aspects
      • Endpoints
      • API Codes
  • Knowledge Base
    • Countries Specifications
Powered by GitBook
On this page
  • Required fields
  • Bank Account Validations
  • Document Validations
  • Example Request
  • Bank Codes

Was this helpful?

  1. API Documentation
  2. Cashouts API
  3. Countries Validations
  4. African Countries

Nigeria

Check the requirements and validations made over the cashouts on 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

Beneficiary's document ID

country

NG

currency

NGN / USD

amount

Number with up to 2 decimals

Cashout amount

bank_account

Beneficiary's bank account

bank_code

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

Example 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"
}
external_id=100365001A2538925094
cashout_id=197824123
date=2025-03-18 10:10:10
bank_reference_id=999999250318115805775951234567
comments=
control=50553B0A13419744FF8CFFAD6711829863B5152E702FCDB123456789735671

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

Bank Codes

Bank
Bank Code

Opay

305

Access Bank Plc

9044

PalmPay Limited

100033

Guaranty Trust Bank Plc

058

United Bank for Africa Plc

033

Kuda Bank

50211

First Bank of Nigeria Plc

011

Zenith Bank International

057

Paycom(Opay)

100004

WEMA Bank Plc

035

Rolez Microfinance Bank

90405

Kuda Microfinance Bank

90267

First Bank of Nigeria

016

Fidelity Bank Plc

070

First City Monument Bank

214

Union Bank Nigeria Plc

032

Sterling Bank Plc

232

Ecobank Nigeria

050

Diamond Bank

005

ProvidusBank PLC

101

9Payment Service Bank

120001

VFD MFB

90110

Fairmoney Microfinance Bank Ltd

90551

Keystone Bank Ltd

082

Stanbic IBTC Bank

221

Globus Bank

103

Fidelity Bank

007

Paga

327

Jaiz Bank

301

Taj Bank

026

Polaris Bank

008

Unity Bank Plc

215

GoMoney

100022

Stanbic IBTC @ease wallet

100007

Standard Chaterted Bank PLC

068

Lotus Bank

029

SmartCash PSB

120004

MoMo PSB

120003

Zenith Mobile

322

RenMoney Microfinance Bank

90198

Last updated 2 months ago

Was this helpful?

See

See

See

See

See

to check document types and validations.

For the full and most up-to-date list of banks and its codes, please check the

🌍
🇳🇬
Cashout Bank Code endpoint.
bank codes
validations below
Click here
document validations
country codes
currency codes