Webhook Notifications

Tingee Webhook là cơ chế thông báo đẩy (Push Notification) giúp máy chủ của bạn nhận dữ liệu giao dịch tức thì ngay khi có biến động số dư, loại bỏ việc phải gọi API kiểm tra trạng thái (Polling).

⚡ Phản hồi Real-time

Nhận thông báo đơn hàng gần như tức thì sau khi hệ thống ghi nhận giao dịch thành công.

🛡️ Bảo mật SHA512

Mọi payload đều được ký số SHA512. Chỉ các webhook có x-signature hợp lệ mới được xử lý.

🔄 Cơ chế Retry

Tự động gửi lại tối đa 5 lần nếu máy chủ của bạn phản hồi lỗi hoặc timeout trong thời gian quy định.

---

Sơ đồ luồng chi tiết

Luồng xử lý Webhook IPN

← Vuốt ngang để xem thêm →

---

Xác thực chữ ký (Signature)

TINGEE sử dụng cơ chế HMAC-SHA512 để ký nội dung:

signature = HMAC_SHA512(
  requestTimestamp + ':' + JSON.stringify(body),
  secretToken
)

Đối tác cần xác minh lại chữ ký này để đảm bảo dữ liệu hợp lệ.

---

Lưu ý khi triển khai

• Idempotency: Nên sử dụng mã giao dịch để tránh xử lý trùng lặp trong trường hợp nhận được webhook retry.

---

Danh mục Sự kiện

Loại Payload	Chức năng
Payment Callback	Thông báo biến động số dư QR & VA.
Deep Link Return	Kết quả thanh toán từ Deep Link.