PayoutsAccount Name Verification

Account Name Verification

This endpoint verifies a recipient’s account name using the provided bank_code, account_number, and currency. It is commonly used before initiating a bank transfer to ensure the account details are valid.

endpoint

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

Sample cURL Request

curl -X POST https://backendapi.sayswitchgroup.com/api/v1/account_name_verify \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{
    "bank_code": "100004",
    "account_number": "7036218209",
    "currency": "NGN"
  }'

Sample Response

{
"success": true,
"message": "Account name retrieved.",
"data": "John Doe"
}

Response Fields

FieldTypeDescription
successbooleanIndicates if the request was successful.
messagestringA message describing the result of the operation.
datastringThe resolved account holder’s full name.