Guides & Tutorials
Jenga API
Receive Money
Bill Validation

Receive Payments - Bill Validation

Test URL

POSThttps://uat.finserve.africa/v3-apis/transaction-api/v3.0/bills/validation

Live URL

POSThttps://api.finserve.africa/v3-apis/transaction-api/v3.0/bills/validation

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
bill.billStatusstring
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
biller.billerCode+amount+amountCurrency
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
    }
}