IPN Callback

IPN (Instant Payment Notification) is the mechanism by which TCONNECT automatically notifies the partner system of transaction results when a customer completes a payment.

POST {{partner_url}}

TCONNECT will call this partner URL to update the order status as soon as the payment is recorded in the system.

Request

Headers

Name	Required	Description
Content-Type	✅	application/json

Body (Encrypted)

Field	Type	Required	Description
data	string	✅	JSON data containing transaction information encrypted with AES-256-CBC

Body (Decrypted)

Field	Type	Description
order_id	string	Partner's order ID
amount	number	Actual payment amount
payment_type	string	Payment type (default: QR)
retrieval_ref_no	string	Bank reference transaction code
request_id	string	Unique request identifier
narrative	string	Transfer description entered by the customer
acc_no	string	Account number used for the transaction (if available)
original_transaction_date	number	Timestamp of the transaction date

Example

IPN Example (Encrypted)

{
  "data": "e53cb37a8743b33bbe598bf43394c4..."
}

IPN Example (Decrypted)

{
  "order_id": "0106002530",
  "amount": 2000.0,
  "payment_type": "QR",
  "retrieval_ref_no": "20260211000006",
  "request_id": "39b73dd3-1b1c-4b37-b2d2...",
  "narrative": "117926751847 FT26021165605807",
  "acc_no": "9648364",
  "original_transaction_date": 1770782306
}

important

Partners need to build a publicly accessible backend API for TCONNECT to call. The accepted method is POST with the header Content-Type: application/json. After processing, partners should respond with HTTP Code 200 to confirm the IPN was received successfully.