Câu hỏi thường gặp (FAQ)
Giải đáp nhanh khi tích hợp webhook HiTechCloud Pay: độ trễ, bảo mật, chống trùng lặp, dùng nhiều endpoint và xử lý sự cố thường gặp.
Webhook mất bao lâu để tới server của tôi?
Thông thường 1-3 giây kể từ khi ngân hàng báo biến động số dư. Độ trễ phụ thuộc vào kênh kết nối của từng ngân hàng (SMS/API/Open Banking) và thời gian phản hồi của endpoint.
Tôi có bắt buộc phải xác thực chữ ký không?
Trên Production xử lý tiền, có. Hãy bật HMAC-SHA256 và kiểm tra cả timestamp để chống giả mạo và Replay. Chế độ 'Không xác thực' chỉ nên dùng khi phát triển cục bộ.
Vì sao tôi nhận cùng một giao dịch nhiều lần?
Do cơ chế retry khi phản hồi chậm/lỗi hoặc do replay thủ công. Hãy dùng trường id làm khóa UNIQUE để xử lý mỗi giao dịch đúng một lần — xem trang Idempotency.
Endpoint cần trả về gì để được coi là thành công?
HTTP 200/201 kèm body JSON {"success": true} trong vòng tối đa 30 giây. Thiếu một trong các điều kiện này, HiTechCloud Pay sẽ coi là thất bại và retry.
Nếu server của tôi sập nhiều giờ thì có mất giao dịch không?
Không. HiTechCloud Pay retry tối đa 10 lần trong vòng ~24 giờ. Nếu vẫn thất bại, giao dịch được đánh dấu 'Thất bại' nhưng bạn luôn có thể bấm 'Gửi lại thủ công' trên bảng điều khiển.
Một tài khoản ngân hàng có thể gửi tới nhiều endpoint không?
Có. Bạn đăng ký nhiều webhook; HiTechCloud Pay bắn song song tới mọi webhook đang active và khớp điều kiện giao dịch.
Trường code bị null, tôi phải làm sao?
code là null khi nội dung chuyển khoản không khớp mẫu cấu hình bóc tách. Hãy đối soát dự phòng theo số tiền + thời gian, hoặc hướng dẫn khách ghi đúng cú pháp nội dung chuyển khoản.
Số tiền trong transferAmount có đơn vị gì?
Luôn là số nguyên VNĐ (đồng), không có phần thập phân. Ví dụ 500000 nghĩa là 500.000 VNĐ.
Làm sao test trước khi có giao dịch thật?
Dùng Sandbox để giả lập giao dịch, và Local Tunnel để nhận webhook ngay trên máy phát triển.
https://my.hitechcloud.vn và đính kèm id giao dịch cùng ảnh chụp tab 'Lịch sử gửi' để được xử lý nhanh nhất.