Account Inquiry All Accounts

Account Inquiry - All Accounts

Description

Allow merchants to validate Equity bank accounts.

Test URL

POSThttps://uat.finserve.africa/v3-apis/account-api/v3.0/account/validate

Live URL

POSThttps://api.finserve.africa/v3-apis/account-api/v3.0/account/validate

Get account details

Example Request

Signature Formulae e.g. KE00201XXXX14605JOHNDOE

countryCode+accountNumber+accountFullName

Example HTTP Request Headers

curl -X POST \
	-H 'Authorization: Bearer {access_token}'  \
    -H 'Content-Type: application/json' \
	-H 'signature: e967CLKebZyLfa73/YYltjW5M4cHoyWeHi/5VDKJ64gOwKBvzHJRqJJrBBc34v2m4jyKkDMBtfRJeFlxbNisMAeBtkw0TRcD2LThFK27EOqLM3m8rQYa+7CJ2FhPhK+iOa4RUY+vTfkRX5JXuqOW7a3GHds8qyPaPe19cKUY33eAJL3upXnGnA3/PEhzjhb0pqk2zCI7aRzvjjVUGwUdT6LO73NVhDSWvGpLEsP0dH/stC5BoTPNNt9nY8yvGUPV7fmaPSIFn68W4L04WgePQdYkmD1UPApGcrl+L2ALY3lPaRfI6/N+0Y3NIWQyLgix+69k7V4EGolqejWdion+9A=='  \
	-L 'https://uat.finserve.africa/v3-apis/account-api/v3.0/account/validate'

Example Request Body

{
    "countryCode": "UG",
    "accountNumber": "1036200681230",
    "accountFullName": "DICKSON MAITEI",
    "chargeAccount": "1036200681230" //optional
}

Note: The chargeAccount field is optional. If not provided, the system will use the default account for the transaction.

Example Response

{
    "status": true,
    "code": 0,
    "message": "success",
    "data": {
        "account": {
            "fullNames": "DICKSON MAITEI",
            "currency": "UGX",
            "accountNumber": "1036*****1230",
            "status": "Active"
        }
    }
}

Response Codes

Http Response Code	Response Code	Description
200	0	Request Processed Successfully
	104101	Request successful;Account validation failed
400	900100	Invalid Signature
401	401, 401101	Unauthorized access
	401101	API Access restricted to Logged-in user
403	403	Forbidden
500	500	Internal Server Error

Account Inquiry Within Equity Bank