API Explorer
Receive Money
Bill Validation

Receive Payments - Bill Validation

Test URL


Live URL


This web service enables your application perform a bill validation. This is typically before a payment is made for example before paying a utility bill you would like the payment application to validate it actually exists and its details are correct

200 Success Response Schema

Field NameField TypeField Description
statusboolResponse status
codenumberResponse code
messagestringResponse message
dataobjectbill object
bill.CustomerRefNumberstringbill identifier
bill.amountstringbill amount
bill.amountCurrencystringbill amount currency
bill.namestringbill name
bill.statusbooleanbill status true or false
createdOnstringbill create date on third party system
messagestringbill query response message

Example Request


In the example below, please remember to replace the variables enclosed within curly brackets {{ }} with the actual values.

Signature Formula
Example Request
curl -X POST \
	-d '{
            "billerCode": "320320",
            "customerRefNumber": "28055948",
            "amount": "1000.00",
            "amountCurrency": "KES"
        }'  \
	-H 'Authorization: Bearer 5fDAgGPdA98EF53ul4YAvR3XWC39'  \
	-H 'Content-Type: application/json'  \
	-L 'https://uat.finserve.africa/v3-apis/transaction-api/v3.0/bills/validation'

Example Response

Example Response
    "status": true,
    "code": 0,
    "message": "success",
    "data": {
        "amount": "1000.0",
        "customerRefNumber": "101704",
        "name": "John Doe",
        "billStatus": "true",
        "message": "SUCCESS",
        "createdOn": "Fri Jun 24 11:04:14 EAT 2022",
        "amountCurrency": "KES",
        "status": true