Game Machine Arcade

API này được thiết kế để cho phép thiết bị TS Play thực hiện kiểm tra và trừ tiền trực tiếp từ thẻ trả trước của người dùng.

Endpoint

POST https://admin-demo.thinksoft.com.vn/api/v1/connector/check-prepaid-card

Request

Headers

Header	Value
`Content-Type`	`application/json`
`Accept`	`application/json`

Body Parameters

Field	Type	Required	Mô tả
`card_no`	`string`	✅	Mã thẻ RFID quét được từ thiết bị.
`secret_key`	`string`	✅	Mã bảo mật định danh kết nối (SgUfecpKWEktTVVFfBJkRhrvMxoJlPND).
`device_code`	`string`	✅	Mã định danh của thiết bị máy game thực hiện yêu cầu.

Ví dụ Request

{
  "card_no": "CARD1804",
  "secret_key": "SgUfecpKWEktTVVFfBJkRhrvMxoJlPND",
  "device_code": "G3"
}

Response

Tất cả các phản hồi từ hệ thống đều trả về mã trạng thái HTTP 200. Vui lòng kiểm tra trường success trong thân phản hồi để xác định kết quả giao dịch.

Thành công

Khi thẻ hợp lệ và còn đủ số dư, hệ thống sẽ thực hiện trừ tiền và trả về thông tin số dư còn lại.

{
  "success": true,
  "message": "success",
  "remaining_credit": 85000
}

Field	Type	Mô tả
`success`	`boolean`	Luôn trả về `true` khi giao dịch thành công.
`message`	`string`	Thông báo `"success"`.
`remaining_credit`	`decimal`	Số dư tài khoản của thẻ sau khi đã trừ tiền.

Thất bại

Trong trường hợp có lỗi (thẻ hết hạn, không đủ tiền, sai mã bảo mật...), hệ thống sẽ trả về mã lỗi tương ứng.

{
  "success": false,
  "message": "Số dư thẻ không đủ (cần 10.000 đ)",
  "error_code": "PC_010"
}

Mã lỗi (Error Codes)

Dưới đây là danh sách các mã lỗi thường gặp và hành động khắc phục:

Mã lỗi	Mô tả	Hành động đề xuất
`PC_001`	Không tìm thấy kết nối	Kiểm tra lại `secret_key`.
`PC_002`	Kết nối đã bị vô hiệu hóa	Liên hệ quản trị viên để kích hoạt lại.
`PC_003`	Thiết bị không tồn tại	Kiểm tra lại `device_code`.
`PC_004`	Thiết bị chưa cấu hình giá chơi	Cấu hình `game_price_per_turn` cho thiết bị.
`PC_005`	Không tìm thấy thẻ	Kiểm tra lại mã hiệu thẻ.
`PC_006`	Thẻ không phải thẻ chơi game	Phải sử dụng thẻ loại `GAME_CARD`.
`PC_007`	Thẻ không hoạt động (bị khóa/đóng)	Liên hệ quản trị viên.
`PC_008`	Thẻ chưa đến ngày sử dụng	Kiểm tra ngày hiệu lực của thẻ.
`PC_009`	Thẻ đã hết hạn sử dụng	Yêu cầu người dùng đổi thẻ mới.
`PC_010`	Số dư thẻ không đủ	Yêu cầu nạp thêm tiền vào thẻ.
`PC_011`	Dữ liệu không hợp lệ	Kiểm tra định dạng các tham số request.
`PC_099`	Lỗi hệ thống	Liên hệ đội ngũ kỹ thuật ThinkSoft.

Ví dụ tích hợp (cURL)

Sử dụng lệnh sau để kiểm tra kết nối từ terminal của bạn:

curl -X POST https://admin-demo.thinksoft.com.vn/api/v1/connector/check-prepaid-card \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "card_no": "CARD1804",
    "secret_key": "SgUfecpKWEktTVVFfBJkRhrvMxoJlPND",
    "device_code": "G3"
  }'

Endpoint​

Request​

Headers​

Body Parameters​

Ví dụ Request​

Response​

Thành công​

Thất bại​

Mã lỗi (Error Codes)​

Ví dụ tích hợp (cURL)​