Webhooks — HiTechCloud Pay

Webhook giao dịch thời gian thực của HiTechCloud Pay: nhận thông báo tiền vào, tiền ra từ tài khoản ngân hàng, ví điện tử và tài khoản ảo ngay về máy chủ của bạn.

Xem Markdown

HiTechCloud Pay Webhooks là giải pháp thông báo biến động số dư ngân hàng theo thời gian thực dành cho doanh nghiệp. Mỗi khi tài khoản ngân hàng hoặc tài khoản ảo của bạn phát sinh giao dịch nhận tiền (hoặc chuyển tiền), HiTechCloud Pay sẽ ngay lập tức gửi một HTTP POST request chứa toàn bộ dữ liệu giao dịch chi tiết tới máy chủ của bạn.

Lợi ích cốt lõi

  • Tự động hóa 100%: Xóa bỏ hoàn toàn thao tác kiểm tra sao kê ngân hàng thủ công, đối soát tự động theo mã đơn hàng.
  • Độ trễ thấp (1-3s): Nhận thông báo gần như tức thì ngay khi tin nhắn ngân hàng hoặc biến động số dư phát sinh.
  • Bảo mật đa tầng: Hỗ trợ 4 phương thức xác thực mạnh mẽ gồm HMAC-SHA256, API Key, OAuth 2.0 Client Credentials và Whitelist IP.
  • Cơ chế tự động gửi lại (Retry): Đảm bảo không bao giờ bỏ sót giao dịch ngay cả khi máy chủ của bạn bảo trì hoặc nghẽn mạng.

Sơ đồ luồng gửi Webhook

mermaid
sequenceDiagram
  autonumber
  actor User as Khách hàng
  participant Bank as Ngân hàng (VCB, MB, TCB...)
  participant HTC as HiTechCloud Pay Engine
  participant Webhook as Server của bạn (Webhook Receiver)
  participant DB as CSDL của bạn

  User->>Bank: Quét mã QR chuyển khoản ngân hàng
  Bank-->>HTC: Báo có biến động số dư (SMS/API/OpenBanking)
  HTC->>HTC: Phân tích mã đơn, bóc tách cú pháp & tạo chữ ký HMAC
  HTC->>Webhook: POST https://yourdomain.com/webhook (JSON payload + X-HiTechCloud-Signature)
  Webhook->>Webhook: Kiểm tra chữ ký HMAC-SHA256 & Timestamp
  Webhook->>DB: INSERT IGNORE giao dịch & Cập nhật đơn hàng PAID
  Webhook-->>HTC: HTTP 200 {"success": true}
  Note over HTC,Webhook: Nếu HTTP khác 200/timeout -> HTC tự động Retry theo lịch

Sơ đồ gửi, xác thực & gửi lại

Vòng đời một webhook
HiTechCloud PayKý HMAC & POST
Xác thực chữ kýX-HiTechCloud-Signature
Chống trùngKhoá theo transaction_id
Phản hồi 200{"success": true}
Gửi lại nếu lỗiBackoff lũy tiến

Cổng gửi webhook có chữ ký; server của bạn xác thực, chống trùng và phản hồi 200. Nếu thất bại, cổng tự động gửi lại theo lịch lũy tiến.

Danh mục tài liệu