Môi trường Sandbox Cổng thanh toán HiTechCloud Pay

Môi trường thử nghiệm (sandbox) của Cổng thanh toán HiTechCloud Pay: mô phỏng đầy đủ luồng QR VietQR và thẻ, cách ly hoàn toàn và không phát sinh tiền thật.

Xem Markdown

Sandbox là môi trường thử nghiệm độc lập của HiTechCloud Pay, cho phép lập trình viên kiểm tra toàn bộ luồng thanh toán, kiểm thử IPN callback, xử lý ngoại lệ và tự động hóa quy trình mà không cần tiền thật hay tài khoản ngân hàng thương mại.

Thông số kết nối Sandbox

MụcGiá trị SandboxMô tả
Host Checkout (Form)https://pay-sandbox.hitechcloud.vn/v1/checkout/initEndpoint gửi form POST đơn hàng từ trình duyệt
Host REST APIhttps://pgapi-sandbox.hitechcloud.vnHost gọi API tra cứu đơn hàng, giao dịch
Xác thực REST APIAuthorization: Basic base64(merchant_id:secret_key)Dùng Merchant ID & Secret Key của Sandbox
Portal cấu hìnhhttps://my.hitechcloud.vnBật chế độ Sandbox/Test mode trên bảng điều khiển

Tài khoản Ngân hàng mô phỏng (Test Bank Accounts)

Ngân hàngSố tài khoản testTên chủ tài khoảnChi nhánh
Vietcombank (VCB)9988776655CONG TY TNHH HITECHCLOUD TESTHồ Chí Minh
MBBank (Quân Đội)090912345678CONG TY TNHH HITECHCLOUD TESTHà Nội
Techcombank (TCB)190367890123CONG TY TNHH HITECHCLOUD TESTĐà Nẵng
ACB (Á Châu)246813579CONG TY TNHH HITECHCLOUD TESTSài Gòn

Thẻ quốc tế thử nghiệm (Test Cards & 3D Secure)

Loại thẻSố thẻ thử nghiệmHạn sử dụngCVVKịch bản kiểm thử
Visa Success4000 0000 0000 000112/30123Thanh toán thành công ngay lập tức (OTP: 123456)
Visa Insufficient Funds4000 0000 0000 000212/30123Lỗi không đủ số dư trong thẻ (HTTP 422)
Mastercard Blocked5100 0000 0000 000312/30123Lỗi thẻ bị ngân hàng phát hành khóa (Blocked)
JCB 3DS Failed3528 0000 0000 000412/30123Thất bại xác thực OTP 3D-Secure

Mô phỏng thanh toán qua cURL (Trigger IPN)

Ngoài việc bấm nút trên trang thanh toán giả lập, bạn có thể gọi API Sandbox để chủ động kích hoạt gửi IPN cho một hóa đơn:

cURL mô phỏng thanh toán thành công
curl -X POST "https://pgapi-sandbox.hitechcloud.vn/v1/sandbox/simulate-payment" \
  -H "Authorization: Basic $(echo -n 'YOUR_SANDBOX_MERCHANT_ID:YOUR_SANDBOX_SECRET_KEY' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "order_invoice_number": "INV-1759134677",
    "status": "APPROVED",
    "amount": 100000
  }'