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 Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Name Inquiry

application/json

Body

Example

{
    "sessionID": "292329jh235123991",
    "transactionId": "290j2jd5655512301",
    "destinationInstitutionCode": "000001",
    "destinationAccountNUBAN": null,
    "destinationAccountName": "Jack Robbinson",
    "destinationAccountBankVerificationNumber": "19192012",
    "destinationBankName": "STERLING BANK PLC",
    "nameInquiryReference": "290j2jd5655512301"
}

Request Body#

Response Body#

Request

Request Code Samples

Responses

Request Body

Response Body