API Explorer
Receive Money
Bill Payments

Receive Payments - Bill Payments

Test URL


Live URL


This API Provides Partners the Capability To Initiate Utility Bill Payments For Goods And Services

200 Success Response Schema

Field NameField TypeField Description
statusstringbill processing status i.e whether SUCCESS or FAILED
transactionIdstringpayment transaction id. returned only if payment is successful

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 '{
            "biller": {
                "billerCode": "320320",
                "countryCode": "KE"
            "bill": {
                "reference": "10170476767676",
                "amount": "111.00",
                "currency": "KES"
            "payer": {
                "name": "A. N Other",
                "account": "101704",
                "reference": "123451000002",
                "mobileNumber": "0764555320"
            "partnerId": "0020100014605",
            "remarks": "These are just some remarks"
        }'  \
	-H 'Authorization: Bearer {{token}}'  \
	-H 'signature: {{signature}}'  \
	-H 'Content-Type: application/json'  \
	-L 'https://uat.finserve.africa/v3-apis/transaction-api/v3.0/bills/pay'

Example Response

Example Response
    "status": true,
    "code": 0,
    "message": "success",
    "reference": "10170476767676",
    "data": {
        "transactionId": "123451000002",
        "status": "SUCCESS"