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.
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ục | Giá trị Sandbox | Mô tả |
|---|---|---|
| Host Checkout (Form) | https://pay-sandbox.hitechcloud.vn/v1/checkout/init | Endpoint gửi form POST đơn hàng từ trình duyệt |
| Host REST API | https://pgapi-sandbox.hitechcloud.vn | Host gọi API tra cứu đơn hàng, giao dịch |
| Xác thực REST API | Authorization: Basic base64(merchant_id:secret_key) | Dùng Merchant ID & Secret Key của Sandbox |
| Portal cấu hình | https://my.hitechcloud.vn | Bậ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àng | Số tài khoản test | Tên chủ tài khoản | Chi nhánh |
|---|---|---|---|
| Vietcombank (VCB) | 9988776655 | CONG TY TNHH HITECHCLOUD TEST | Hồ Chí Minh |
| MBBank (Quân Đội) | 090912345678 | CONG TY TNHH HITECHCLOUD TEST | Hà Nội |
| Techcombank (TCB) | 190367890123 | CONG TY TNHH HITECHCLOUD TEST | Đà Nẵng |
| ACB (Á Châu) | 246813579 | CONG TY TNHH HITECHCLOUD TEST | Sài Gòn |
Thẻ quốc tế thử nghiệm (Test Cards & 3D Secure)
| Loại thẻ | Số thẻ thử nghiệm | Hạn sử dụng | CVV | Kịch bản kiểm thử |
|---|---|---|---|---|
| Visa Success | 4000 0000 0000 0001 | 12/30 | 123 | Thanh toán thành công ngay lập tức (OTP: 123456) |
| Visa Insufficient Funds | 4000 0000 0000 0002 | 12/30 | 123 | Lỗi không đủ số dư trong thẻ (HTTP 422) |
| Mastercard Blocked | 5100 0000 0000 0003 | 12/30 | 123 | Lỗi thẻ bị ngân hàng phát hành khóa (Blocked) |
| JCB 3DS Failed | 3528 0000 0000 0004 | 12/30 | 123 | Thấ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 -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
}'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ục | Giá trị Sandbox | Mô tả |
|---|---|---|
| Host Checkout (Form) | https://pay-sandbox.hitechcloud.vn/v1/checkout/init | Endpoint gửi form POST đơn hàng từ trình duyệt |
| Host REST API | https://pgapi-sandbox.hitechcloud.vn | Host gọi API tra cứu đơn hàng, giao dịch |
| Xác thực REST API | Authorization: Basic base64(merchant_id:secret_key) | Dùng Merchant ID & Secret Key của Sandbox |
| Portal cấu hình | https://my.hitechcloud.vn | Bậ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àng | Số tài khoản test | Tên chủ tài khoản | Chi nhánh |
|---|---|---|---|
| Vietcombank (VCB) | 9988776655 | CONG TY TNHH HITECHCLOUD TEST | Hồ Chí Minh |
| MBBank (Quân Đội) | 090912345678 | CONG TY TNHH HITECHCLOUD TEST | Hà Nội |
| Techcombank (TCB) | 190367890123 | CONG TY TNHH HITECHCLOUD TEST | Đà Nẵng |
| ACB (Á Châu) | 246813579 | CONG TY TNHH HITECHCLOUD TEST | Sài Gòn |
Thẻ quốc tế thử nghiệm (Test Cards & 3D Secure)
| Loại thẻ | Số thẻ thử nghiệm | Hạn sử dụng | CVV | Kịch bản kiểm thử |
|---|---|---|---|---|
| Visa Success | 4000 0000 0000 0001 | 12/30 | 123 | Thanh toán thành công ngay lập tức (OTP: 123456) |
| Visa Insufficient Funds | 4000 0000 0000 0002 | 12/30 | 123 | Lỗi không đủ số dư trong thẻ (HTTP 422) |
| Mastercard Blocked | 5100 0000 0000 0003 | 12/30 | 123 | Lỗi thẻ bị ngân hàng phát hành khóa (Blocked) |
| JCB 3DS Failed | 3528 0000 0000 0004 | 12/30 | 123 | Thấ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 -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
}'