Accept PaymentsServer to ServerMobile MoneyAccount Name Verification

Account Name Verification

Verify a bank account or mobile money number before initiating a transfer.

This endpoint returns the registered account name when the verification is successful. It is recommended to call this endpoint before bank_transfer.

Endpoint

POST https://backendapi.sayswitchgroup.com/api/v1/account_name_verify

Headers

Authorization: Bearer YOUR_SECRET_KEY
Content-Type: application/json

Request Body

{
  "bank_code": "MTNGH",
  "account_number": "233000000000",
  "currency": "GHS"
}

For Kenya, pass KES as the currency:

{
  "bank_code": "BANK_OR_MOMO_CODE",
  "account_number": "BENEFICIARY_ACCOUNT_OR_PHONE",
  "currency": "KES"
}

Request Parameters

ParameterTypeRequiredDescription
bank_codeStringYesBank or mobile money provider code
account_numberStringYesAccount or phone number to verify
currencyStringYesCurrency code. Use KES or GHS

Sample cURL

curl -X POST "https://backendapi.sayswitchgroup.com/api/v1/account_name_verify" \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bank_code": "MTNGH",
    "account_number": "233000000000",
    "currency": "GHS"
  }'

Success Response

{
  "bank_code": "MTNGH",
  "account_number": "233245690993",
  "currency": "GHS"
}

Failure Response

{
  "success": false,
  "message": "Name query failed"
}
Supported InstitutionsPayouts / Transfers