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
Host: myserver.com
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 Name

Description

Type

callbackType

The type of callback. In this case IPN

String

customer.name

The customer name

String

customer.mobileNumber

The customer mobile number

String

customer.reference

The customer reference

String

transaction.date

The transaction date

String

transaction.reference

The transaction reference

String

transaction.paymentMode

The transaction mode of payment

String

transaction.amount

The transaction amount

Double

transaction.billNumber

The transaction bill number. This is the account number

String

transaction.orderAmount

The transaction order amount

Double

transaction.serviceCharge

The transaction service charge

Double

transaction.servedBy

String

transaction.additionalInfo

Any additional information for the transaction

String

transaction.status

Transaction status

String

transaction.remarks

Transaction remarks

String

bank.reference

The bank system reference id

String

bill.transactionType

The bill transaction type

String

bill.account

The bill account number

String