Docs
  1. Global payouts
  2. Single Fund Transfers

Nigeria 🇳🇬

Payouts to Nigeria are processed through the NIBSS Instant Payment (NIP) rail. This ecosystem is optimized for real-time settlement but requires a strict Name Enquiry handshake to ensure funds reach the correct recipient.

Metadata requirements

ElementDescription
currencyCodeSet to NGN for all Naira transfers.
beneficiaryAccountNumberThe 10-digit NUBAN account number.
paymentMethodTypeThe routing method. Must be BankCode.
paymentMethodValueThe 6-digit central bank code of the bank.
beneficiaryAccountNameFull name of the beneficiary account.
amountValue to send (Minimum: 1.00).
tenantReferenceYour unique transaction tracking ID.
beneficiaryCountryIsoThe ISO 2-letter country code for Nigeria.

{
    "currencyCode": "NGN",
    "beneficiaryAccountName": "ACCOUNT HOLDER NAME",
    "beneficiaryAccountNumber": "0112345678", // using test account
    "amount": 1200,
    "narration": "Single Payout NGN example",
    "paymentMethodType": "BankCode",
    "paymentMethodValue": "999998", // using test value
    "tenantReference": "{{$randomInt}}",
    "beneficiaryAddress": "8916 Str Ave, Woodhaven, United Kingdom",
    "nameEnquiryRef": null,
    "beneficiaryKYCLevel": null,
    "beneficiaryBankVerificationNumber": null,
    "beneficiaryCity": null,
    "beneficiaryState": null,
    "beneficiaryZIP": null,
    "beneficiaryCountryIso": null
}