Name Inquiry

This operation retrieves the account details of the destination account, commonly known as account name enquiry, to verify the recipient's information before transactions on the merchant portal.

Request Body

Field Name	Type	Required	Description
destinationInstitutionCode	string	true	The unique code identifying the recipient's financial institution.
destinationAccountNumber	string	true	The NUBAN (Bank Account Number) of the recipient's account.

Response Body

Field Name	Type	Description
sessionID	string	A unique identifier for the transaction session.
transactionId	string	A unique reference ID assigned to the transaction.
destinationInstitutionCode	string	The unique code identifying the recipient's financial institution.
destinationAccountNUBAN	string	The NUBAN (Bank Account Number) of the recipient's account.
destinationAccountName	string	The name of the recipient's account holder.
destinationAccountBankVerificationNumber	string	The Bank Verification Number (BVN) associated with the recipient's account.
destinationBankName	string	The name of the recipient's financial institution.
nameInquiryReference	string	A reference ID generated during the name inquiry process.

Request

Authorization

OAuth 2.0

Client Credentials

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: {{tpGatewayHostUrl}}/security/authenticate

Body Params application/json

Example

{
  "destinationInstitutionCode": "000001",
  "destinationAccountNumber": "62707280"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Response

application/json

Bodyapplication/json

Example

{
  "sessionID": "840453jh209759729",
  "transactionId": "290j2jd5655512301",
  "destinationInstitutionCode": "000001",
  "destinationAccountNUBAN": null,
  "destinationAccountName": "Sample Customer",
  "destinationAccountBankVerificationNumber": "19192012",
  "destinationBankName": "Sample Bank",
  "nameInquiryReference": "721j6jd1650522500"
}

🟠400| Source | Error | When |

🟠401| Source | Error | When |

🟠403| Source | Error | When |

🔴500| Source | Error | When |

Request Body#

Response Body#

Request

Request Code Samples

Responses

Request Body

Response Body