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.
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ịchSơ đồ 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
- Bắt đầu nhanh — Thiết lập endpoint và kiểm tra với giao dịch thật.
- Tích hợp Webhook & Payload — Cấu trúc dữ liệu JSON, chuẩn phản hồi và kỹ thuật chống trùng lặp.
- Xác thực Webhook — So sánh chi tiết 4 cơ chế bảo mật (HMAC, API Key, OAuth 2.0).
- Bảo mật & Whitelist IP — Danh sách dải IP máy chủ gửi tin và các thực hành an toàn.
- Xử lý lỗi & Lịch Retry — Quản lý webhook thất bại và cơ chế gửi lại tự động.