Name Enquiry

Description: Validates a beneficiary account before payment initiation and returns account information from the PAPSS network.

Use Case

This API should be called before initiating a payment to verify:

• Beneficiary Account Number
• Beneficiary Bank
• Beneficiary Name
• Account Currency

Sample Request

Request Parameters

POST {base_url} /api/v1/epapss/name-enquiry

curl `{base_url} /api/v1/epapss/name-enquiry`
  -H "subscription-key: 2df8a91s8d7a1"
  -H "X-client-Id: 432987234"
  -H "Content-Type: application/json"
  -d '{
    "countryCode": "GH",
    "accountNumber": "01360013664879",
    "bankCode": "BARCUGKX"
  }
  '
'

Sample Response

Sample Success Response

POST {base_url} /api/v1/epapss/name-enquiry

{
  "code": "00",
  "data": {
    "accounts": [
      {
        "account_id": "01360013664879",
        "currency": "GHS"
      }
    ],
    "name": "OLASMEN KUJAYA O."
  },
  "message": "Name enquiry successful",
  "status": "SUCCESS"
}