Môi trường thử nghiệm SoundBox (Sandbox)

Môi trường thử nghiệm (sandbox) của Loa thông báo HiTechCloud Pay: chạy thử trọn luồng liên kết và phát âm thanh mà không cần thiết bị thật, không đụng dữ liệu thật.

Xem Markdown

HiTechCloud Pay SoundBox cung cấp một môi trường thử nghiệm (Sandbox) riêng để lập trình viên tích hợp và kiểm thử toàn bộ quy trình: lấy Access Token, kiểm tra thiết bị, ghép nối OTP và bắn thông báo biến động số dư. Mọi lời gọi tới Sandbox đều được mô phỏng — thiết bị loa ảo luôn trực tuyến, OTP cố định và không có âm thanh thật nào được phát ra.

Máy chủ Sandbox

Môi trườngBase URLGhi chú
Chính thức (Production)https://speaker-api.hitechcloud.vn/devices/v1Thiết bị thật — âm thanh phát ra tức thời
Thử nghiệm (Sandbox)https://sandbox.speaker-api.hitechcloud.vn/devices/v1Thiết bị ảo mô phỏng; không phát âm thanh thật
Thiết bị ảoDùng hardwareId mẫu `HTC_SANDBOX_0001` — luôn online, pin 100%, không cần phần cứng.
OTP cố địnhTrong Sandbox, mã OTP ghép nối luôn là `0000` để bạn tự động hoá kiểm thử.
Không phát tiếngLệnh notify trả về trạng thái `PLAYED` giả lập nhưng không có âm thanh thật.

Thông tin kiểm thử cố định

MụcGiá trị mẫu
Hardware IDHTC_SANDBOX_0001
Mã OTP ghép nối0000
Client ID / SecretCấp riêng trong Cổng khách hàng ở tab Sandbox
TTL của Token6000 giây, giống môi trường thật
cURL lấy Access Token trên Sandbox
curl -X POST "https://sandbox.speaker-api.hitechcloud.vn/devices/v1/token/create" \
  -H "Authorization: Basic $(echo -n 'SANDBOX_CLIENT_ID:SANDBOX_CLIENT_SECRET' | base64)"
cURL bắn thông báo thử nghiệm
curl -X POST "https://sandbox.speaker-api.hitechcloud.vn/devices/v1/speaker/transactions/notify" \
  -H "Authorization: Bearer YOUR_SANDBOX_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "hardwareId": "HTC_SANDBOX_0001",
    "amount": 100000,
    "requestId": "SANDBOX_TXN_001"
  }'
Client ID/Secret của Sandbox không dùng được trên môi trường chính thức và ngược lại. Hãy tách biến môi trường của hai môi trường để tránh bắn nhầm lệnh lên thiết bị thật.
Khi đã kiểm thử xong, chỉ cần đổi Base URL từ sandbox.speaker-api.hitechcloud.vn sang speaker-api.hitechcloud.vn và thay cặp Client ID/Secret là chuyển sang chạy thật.