Skip to main content

Name Enquiry

Overview

Description: This is specification used by initiating bank to fetch Account name attached to beneficiary account. It is expected that beneficiary bank implements an interface that accepts the below request and response. Beneficiary bank will communicate the full restful endpoint url to eTranzact.

For sending Encrypted Requests, the following steps should be adhered to

  1. Create your plain request object
data: {
"clientReference": "testClientReference12345678910",
"transactionReference": "830UDI83HKHSD8U90U3830UD",
"channel": 10,
"initiatorInstitutionCode": "123456",
"destinationIssuerCode": "345678",
"accountNumber": "00987601234"
}
  1. Using the AES 256 encryption, generate an encrypted requuest from the plain Request Body (Hint: Use the same AES 256 method used when generating the token) EncryptedRequestBody = AES 256(PlainRequestBody)

  2. The final encrypted payload to be sent should look like this

{
"data": "EncryptedRequestBody"
}
  1. When you receive the request at your end, you decrypt it using the AES decryption method (Hint: Use the same AES 256 method used when decrypting the token)
ParameterTypeDescriptionRequired?
transactionReference StringTransaction reference from eTranzact instant transfer service. Maximum of 50 characters. Yes
clientReference StringClient/initiating bank’s unique reference number. Maximum of 50 characters.No
channel integerChannel ID through which transaction originated. Refer to transaction response and Channel codes description tableNo
initiatorInstitutionCode StringInitiating institution code, when applicable.No
accountNumber StringBeneficiary Account Number. Maximum of 30 characters.Yes
POST / https://{defined_by_beneficiary_bank
curl `https://{defined_by_beneficiary_bank}`
-H "Content-type: application/json"
-d '{
"clientReference": "testClientReference12345678910",
"transactionReference": "830UDI83HKHSD8U90U3830UD",
"channel": 10,
"initiatorInstitutionCode": "123456",
"destinationIssuerCode": "345678",
"accountNumber": "00987601234"
}'
-X POST