Câu hỏi thường gặp (FAQ)
Giải đáp nhanh khi tích hợp Cổng thanh toán HiTechCloud Pay: IPN, chữ ký, môi trường thử nghiệm (sandbox), hoàn tiền, đối soát và go-live.
IPN và tra cứu API khác nhau thế nào?
IPN là kênh đẩy (push) bất đồng bộ do HiTechCloud Pay chủ động gọi tới server của bạn ngay khi có kết quả — đây là kênh xác thực chính. API tra cứu là kênh kéo (pull) do bạn chủ động gọi để đối soát hoặc dự phòng khi IPN bị nghẽn mạng. Nên dùng IPN làm chính và API tra cứu để kiểm tra lại.
Vì sao tôi liên tục nhận lỗi INVALID_SIGNATURE?
- Thứ tự sắp xếp key chưa đúng alphabet tăng dần.
- Dùng secret key của Sandbox để ký nhưng gọi sang Production (hoặc ngược lại).
- Có đưa trường
signaturevào chuỗi ký, hoặc để lọt khoảng trắng/encode khác nhau. - Kiểu dữ liệu số bị định dạng khác (ví dụ
100000.00thay vì100000).
Vì sao HiTechCloud Pay gửi IPN nhiều lần cho một đơn?
Nếu server của bạn không trả về đúng HTTP 200/201 kèm {"success": true} trong thời gian cho phép, hệ thống coi là chưa nhận được và sẽ gửi lại theo lịch lũy tiến. Hãy đảm bảo xử lý idempotent (chống trùng) bằng transaction_id để một giao dịch chỉ được ghi nhận một lần.
Sandbox có phát sinh tiền thật không?
Không. Sandbox là môi trường cách ly hoàn toàn với Production, dùng bộ Merchant ID/Secret Key riêng và tài khoản ngân hàng, thẻ mô phỏng. Bạn kiểm thử toàn bộ luồng mà không mất phí.
Tôi có thể hoàn tiền một phần không?
Có. Gọi API Hoàn tiền với trường amount nhỏ hơn tổng số đã thu để hoàn một phần; bỏ trống amount để hoàn toàn bộ. Đơn sẽ chuyển sang PARTIALLY_REFUNDED hoặc REFUNDED tương ứng. Xem API Hoàn tiền.
Cần chuẩn bị gì để go-live?
- Hoàn tất kiểm thử toàn bộ luồng trên Sandbox (thành công, hủy, hết hạn, hoàn tiền).
- Liên kết tài khoản ngân hàng nhận tiền thật trên my.hitechcloud.vn.
- Thay endpoint và cặp khóa sang Production, cập nhật URL IPN trỏ về server thật.
- Đăng ký whitelist IP máy chủ gọi REST API.
https://my.hitechcloud.vn để được trợ giúp chi tiết.