Skip to main content
Before initiating a transfer, call this endpoint to resolve the registered account name for a given account number and bank code. For intra-bank accounts, the lookup is resolved locally. For inter-bank accounts, the lookup is performed via NIP through the bank provider. Always run a name enquiry first — confirming the account name with your user prevents payments sent to the wrong recipient. Endpoint 
POST https://baasapi.payrepmfb.com/api/v1/transaction/transfer/web/name_enquiry
Sandbox 
POST https://shogun-dev.xchangeboxng.com/api/v1/transaction/transfer/web/name_enquiry

​
Authentication

Include your Bearer token in the Authorization header: 
Authorization: Bearer <access_token>
Obtain a token by logging in via User Login.

​
Request body

​
beneficiary_account_number
string
required
The 10-digit account number of the recipient you want to verify.
​
bank_code
string
required
The bank code for the recipient’s bank. Use Fetch Banks to retrieve valid bank codes.
​
source_account_number
string
required
Your source account number. Required to establish transfer context for the lookup.

​
Example request

curl --request POST \
  --url https://baasapi.payrepmfb.com/api/v1/transaction/transfer/web/name_enquiry \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "beneficiary_account_number": "0123456789",
    "bank_code": "058",
    "source_account_number": "7801234567"
  }'

​
Response

A successful response returns the standard envelope with the resolved account details in data.
​
status
boolean
true when the request succeeded.
​
response_code
string
"00" on success.
​
message
string
Human-readable status message.
​
data
object
The resolved account information.
{
  "status": true,
  "response_code": "00",
  "message": "Account resolved successfully",
  "data": {
    "account_name": "Jane Doe",
    "account_number": "0123456789",
    "bank_name": "Guaranty Trust Bank"
  }
}

​
Error codes

CodeMeaning
00Success
41Customer not found — your session token is invalid or expired
80Service unavailable — the bank provider is temporarily unreachable
83Provider error — the bank rejected the name enquiry request (e.g., account not found)