Instant Payment Notifications (IPN)

This will enable you to setup where payment notifications by customers will be sent to. To receive IPNs, go to JengaHQ sign-in and select IPN on the Settings menu on the sidebar and specify your username, password and callback URL you would like us to send these notifications to.

POST /send/callback/here HTTP/1.1
Content-Type: application/json
Authorization: Basic 67ew8n31me

   "callbackType": "IPN",
   "customer": {
      "name": "A N Other",
      "mobileNumber": "",
      "reference": null
   "transaction": {
      "date": "2018-11-27 00:00:00.0",
      "reference": " S2596405",
      "paymentMode": "TPG",
      "amount": "10",
      "billNumber": "A N Other",
      "orderAmount": "",
      "serviceCharge": "",
      "servedBy": "EQ",
      "additionalInfo": "MPS 254723000000 MKR35QEKV7 A N Other/537620",
      "status": "SUCCESS",
      "remarks": "?"
   "bank": {
      "reference": " S2596405",
      "transactionType": "C",
      "account": "0111234241028"

Below is the description of the payload that is sent to the URL you specify

Field NameDescriptionType
callbackTypeThe type of callback. In this case IPNString
customer.nameThe customer nameString
customer.mobileNumberThe customer mobile numberString
customer.referenceThe customer referenceString
transaction.dateThe transaction dateString
transaction.referenceThe transaction referenceString
transaction.paymentModeThe transaction mode of paymentString
transaction.amountThe transaction amountDouble
transaction.billNumberThe transaction bill number. This is the account numberString
transaction.orderAmountThe transaction order amountDouble
transaction.serviceChargeThe transaction service chargeDouble
transaction.additionalInfoAny additional information for the transactionString
transaction.statusTransaction statusString
transaction.remarksTransaction remarksString
bank.referenceThe bank system reference idString
bill.transactionTypeThe bill transaction typeString
bill.accountThe bill account numberString