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: ###########
}
}