Bill preparation
This call pulls the customer details and transaction ID
Method: POST
URI: …/jambopayservices/api/payments/POST
Stream: kplc
Request body
Name | Type | Required | Description |
---|---|---|---|
Stream | string | R | Payment stream being accessed |
PhoneNumber | string | R | User phone number |
Amount | decimal | R | Transaction amount |
MeterNumber | string | R | Meter number you are buying tokens for |
CallbackUrl | string | NO | Callback url to receive final transaction status |
Structure of callback data
{
"TransactionId": "<jambopay-transaction-id>",
"MeterNumber": "<meter-number>",
"PhoneNumber": "<customer-phone-number>",
"Amount": 0.0,//the transaction amount
"TransactionStatus": "<final-transaction-status>",//may be completed if successful if third party was successful or cancelled if transaction failed and agent float was reversed.
"ThirdPartyRef": "<Third-party-transaction-reference>",
"Action": "<final-application-action>"//may be Token Vending if third party transaction was successful or Agent Refunded if third party transaction failed.
}
Response
Output | Type | Description |
---|---|---|
Customer[ReferenceNumber] | string | Reference number sent by KPLC |
Customer[Names] | string | Customer names |
Customer[Address] | string | Customer address |
TransactionID | string | Transaction reference number |
Amount | decimal | Transaction amount |
MeterNumber | string | Meter number you are buying tokens for |
Example of the API call: …/jambopayservices/api/payments/POST