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
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"
}
}