Use the getBeneficiaryName endpoint to get the beneficiary’s name associated with the specified account number.

To reduce the failed transactions, please use this API to confirm if the account number and the Nigerian bank name provided by a customer are accurate before submitting a transaction.

Syntax

POST https://nairagrambasket.com/api/getBeneficiaryName

Input Parameters

The following table lists the parameters that you need to provide in the getBeneficiaryName request.

Field	Value Format	Required/Optional	Description
username	mail@mail.com	Required	Input the valid email address that you submitted to your Partner Company.
password	yourPassword	Required	Input your secure password.
secretKey	yourSecretKey	Required	Input the API key provided to you by your Partner Company.
account_number	0690000004	Optional	Input the valid bank account number.
bank_code	044	Optional	Input the valid bank code. For bank names and bank codes refer to the Bank Codes section

Sample Request

curl --location --request POST 'https://nairagrambasket.com/api/getBeneficiaryName' \
--form 'username="mail@mail.com"' \
--form 'password="yourPassword"' \
--form 'secretKey="yourSecretKey"' \
--form 'account_number="0690000004"' \
--form 'bank_code="044"'

Sample Response

{
  "Code": "200",
  "Message": "Success",
  "Content": {
    account_name: ###########
  }
}