Bill Payments – Jenga Docs

Receive Payments - Bill Payments

Test URL

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

Live URL

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

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

200 Success Response Schema

Field Name	Field Type	Field Description
`status`	`string`	bill processing status i.e whether `SUCCESS` or `FAILED`
`transactionId`	`string`	payment 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

biller.billerCode+bill.amount+payer.reference+partnerId

Request Fields

Field Name	Description	Format	Required
`biller.billerCode`	The unique code for the biller	`string`	Yes
`biller.countryCode`	The country code of the biller	`string`	Yes
`bill.reference`	The reference number for the bill	`string`	Yes
`bill.amount`	The amount to be paid	`string`	Yes
`bill.currency`	The currency for the payment	`string`	Yes
`payer.name`	The name of the person making the payment	`string`	Yes
`payer.account`	The account number for the payer	`string`	Yes
`payer.reference`	The reference number for the payer's transaction	`string`	Yes
`payer.mobileNumber`	The mobile number of the payer	`string`	Yes
`partnerId`	The ID of the partner initiating the payment	`string`	Yes
`remarks`	Additional remarks about the payment	`string`	No

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

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

Pesalink - Mobile Bill Validation