Skip to main content

​
NGN Bank Transfer / Withdrawal

This endpoint currently supports NGN (Nigerian Naira) wallet withdrawals.

​
How to Perform a Bank Transfer

  1. Ensure the user has sufficient balance in their NGN wallet.
  2. Retrieve the list of supported Nigerian banks and their respective bankCode values by calling the utility endpoint: /transaction/{method}/providers
  3. Pass the following query parameters to the utility endpoint:
    ParameterValue
    methodBANK_TRANSFER
    currencyNGN
    iso2NG
  4. Use the returned bankCode when initiating a transfer.

​
Required Fields

FieldDescription
currencyMust be NGN
amountAmount to transfer from the wallet
accountNumberDestination bank account number
bankCodeBank code of the destination bank
accountNameName on the destination bank account
bankNameName of the destination bank

​
Optional Fields

FieldDescription
narrationTransaction narration or description

​
Sample Request Payload

{
  "currency": "NGN",
  "amount": 15000,
  "narration": "Refund",
  "accountNumber": "5010755577",
  "bankCode": "999240",
  "accountName": "MONIRATESLIMITE / JOHN DOE",
  "bankName": "SAFE HAVEN SANDBOX BANK"
}

​
Notes

  • This endpoint is only for NGN bank transfers.
  • Fees may apply and will be deducted from the wallet balance.
  • Transfers are subject to bank processing times.
  • Invalid bank codes or insufficient balance will result in validation errors.