Verify Bank Account
monei_verify_bank_accountVerify a Nigerian bank account before sending naira to confirm the account holder's name and avoid transferring to the wrong account. Provide account number and bank code to get the account name.
Instructions
Verifies a Nigerian bank account number and returns the account holder's name.
Always call this before sending naira to a bank account. Surfacing the account name to the user before they confirm the transaction prevents sending to the wrong account.
Args:
accountNumber (string): 10-digit Nigerian bank account number
bankCode (string): Bank code from monei_get_banks (e.g. "058" for GTBank)
Returns: { "accountName": string, "accountNumber": string, "bankCode": string }
Examples:
Before sending to 0123456789 at GTBank -> call this with accountNumber="0123456789", bankCode="058"
User says "send to my GTBank account 0123456789" -> verify first, show account name, confirm before sending
Error handling:
Returns error if the account number does not exist at the given bank
Returns error if the bank code is invalid (call monei_get_banks to find valid codes)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bankCode | Yes | Bank code (e.g. '058' for GTBank, '033' for UBA). Call get_banks to get the full list of bank codes. | |
| accountNumber | Yes | Nigerian bank account number (exactly 10 digits) |