BANK TRANSFER

Overview:
Bank Transfer (NUBAN) allows direct payouts to Nigerian bank accounts using the NUBAN (Nigerian Uniform Bank Account Number) format. This method supports instant settlements via local banking networks for all major banks (GTBank, Access, Zenith, First Bank, etc.).

Required Fields:

FieldTypeRequirement LevelDescription
amountnumberRequiredAmount in the local currency
currencystringRequiredNGN
method_codestringRequired"BANK_TRANSFER_NGN"
recipient.wallet_uidstringRequiredRecipient’s bank account number
recipient.full_namestringRequiredRecipient’s bank account name
bank.codestringRequiredBank code
referencestringRequiredMerchant reference
metadataobjectOptionalMerchant metadata
webhook_urlstringOptionalHTTPS URL for notifications
sender.full_namestringOptionalSender's full name
sender.addressstringOptionalSender's address
sender.phonestringOptionalSender's phone number

Sample Payload:

{
  "amount": 100,
  "currency": "NGN",
  "method_code": "BANK_TRANSFER_NGN",
  "recipient": {
    "wallet_uid": "01712345678",
    "full_name": "Firstname Surname",
  },
  "bank": {
		"code": "90001",
  },
  "reference": "INV-2025-001",
  "metadata": {
    "internal_id": "user1234"
  },
  "webhook_url": "https://yourwebsite.com/webhook",
  "sender": {
    "full_name": "Firstname Surname",
    "address": "No 2, Green Median Str"
  }
}