Account Enquiry

The merchant can check to confirm account details of the recipient of a payout before payout is processed.

POST https://transfer.dev.mypaygate.co/api/v1/transactions/name-enquiry

This API allows you to verify account details by providing an account number, bank code and currency. The API returns the account holder's name along with validation status, helping you confirm account details before processing transactions.

Headers

Name	Type	Description
x-api-key*	String	Base_64(Merchant Public Key)

Sample Request (POST)

curl --location 'https://transfer.dev.mypaygate.co/api/v1/transactions/name-enquiry' --header 'x-api-key: UEstNTItNTkzY2RkMWFlZGU4NGYxZC1VSWJuUmpaS3RmaVlubThiepand2VUlVdFNMTllRMg==' --header 'Content-Type: application/json' --data '{
  "accountNumber": "8169642235",
  "bankCode": "100004",
  "currency": "NGN",
  "country": "Nigeria"
}'

Field	Data Type	Description	Mandatory
accountNumber	String	Recipient account number	Yes
bankCode	String	Unique code for bank/operator, this can be obtained by calling the Get Payout Processors API	Yes
currency	String	-	Yes
country	String	-	Yes

Sample Response

Successful

{
"isSuccessful": true,
"responseMessage": "Successful",
"responseData": {
  "accountName": "John Doe",
  "accountNumber": "0113801890",
  "bankCode": "000017",
  "sessionId": "ACCT-LKP1747814389202"
}
}