IPN Callback

IPN (Instant Payment Notification) là cơ chế TCONNECT thông báo kết quả giao dịch cho hệ thống đối tác một cách tự động khi khách hàng thanh toán thành công.

POST {{partner_url}}

TCONNECT sẽ gọi đến URL này của đối tác để cập nhật trạng thái đơn hàng ngay khi tiền được ghi nhận vào hệ thống.

Yêu cầu

Headers

Tên	Bắt buộc	Mô tả
Content-Type	✅	application/json

Body (đã mã hóa)

Trường	Kiểu	Bắt buộc	Mô tả
data	string	✅	Dữ liệu JSON chứa thông tin giao dịch đã được mã hóa AES-256-CBC

Body (đã giải mã)

Trường	Kiểu	Mô tả
order_id	string	Mã hóa đơn phía đối tác
amount	number	Số tiền thanh toán thực tế
payment_type	string	Loại thanh toán (mặc định: QR)
retrieval_ref_no	string	Mã giao dịch tham chiếu của ngân hàng
request_id	string	Mã yêu cầu duy nhất
narrative	string	Nội dung chuyển khoản khách hàng đã ghi
acc_no	string	Số tài khoản thực hiện giao dịch (nếu có)
original_transaction_date	number	Timestamp ngày thực hiện giao dịch

Ví dụ

Ví dụ IPN (đã mã hóa)

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

Ví dụ IPN (đã giải mã)

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

Đối tác cần xây dựng một API backend công khai để TCONNECT có thể gọi đến. Phương thức chấp nhận là POST với header Content-Type: application/json. Sau khi xử lý xong, đối tác nên phản hồi HTTP Code 200 để xác nhận đã nhận IPN thành công.