Endpoint kiểm tra người chơi

Bước kiểm tra người chơi xác định tài khoản trong game trước khi phát sinh bất kỳ giao dịch tiền nào. Endpoint xác nhận ID đó tồn tại với sản phẩm, trả về tên trong game để người mua tự kiểm tra, đồng thời cho biết khu vực để đơn khác khu vực bị từ chối sớm thay vì thất bại sau khi đã thanh toán.

Cần gửi những trường nào

Body của yêu cầu gồm hai trường cố định cộng với các trường mà từng game yêu cầu. Trước tiên hãy gọi GET /catalog/category/:categoryId/requirements, sau đó gửi mọi field_name nhận được cùng với sub_category_id và player_id. Trường có kiểu single_select hoặc multi_select chỉ nhận giá trị nằm trong danh sách select_options của chính nó. Thiếu trường sẽ bị từ chối với MISSING_REQUIRED_FIELD; giá trị sai quy tắc của trường sẽ bị từ chối với INVALID_PARAMETER_FORMAT, INVALID_PARAMETER_VALUE hoặc INVALID_PARAMETER_LENGTH. Trong cả hai trường hợp, details.field đều cho biết tên trường.

Khi thành công, phản hồi trả về tên trong game và khu vực của ID đó. Hãy đối chiếu khu vực này với sản phẩm bạn sắp bán: nếu không khớp, yêu cầu bị từ chối với REGION_MISMATCH. Phát hiện ở bước kiểm tra chỉ tốn một yêu cầu, còn để đến lúc đặt đơn thì phải qua cả một vòng hoàn tiền.

POST

/player/validate

Kiểm tra ID người chơi

Kiểm tra ID người chơi của một game cụ thể. Gửi kèm các trường yêu cầu động mà endpoint "Lấy trường yêu cầu của danh mục" trả về.

Giới hạn tần suấtHạn mức kiểm tra người chơi theo ngày (mỗi tài khoản), không trả header X-RateLimit

Lưu ý: Gọi endpoint "Lấy trường yêu cầu của danh mục" để biết mỗi game cần những trường nào, rồi đưa đủ các trường bắt buộc vào request body. PLAYER_NOT_FOUND nghĩa là game đã xác nhận ID không tồn tại. PLAYER_CHECK_UNAVAILABLE (HTTP 503, có thể thử lại) nghĩa là lúc này chưa kiểm tra được ID, chứ ID không bị từ chối.

Body yêu cầu

TênKiểuBắt buộcMô tảVí dụ
sub_category_idnumberCóID danh mục con của sản phẩm. Bạn có thể tìm ID này trong Catalog Explorer.999
player_idstringCóID người chơi trong game.123456789
...requirementsvariesKhôngCác trường bổ sung lấy từ endpoint "Lấy trường yêu cầu của danh mục". Dùng mỗi field_name làm key, giá trị là dữ liệu người dùng nhập."server": "Asia"
Yêu cầu
curl -s -X POST "https://shop2topup.com/api/endpoints/v1/player/validate" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
  "sub_category_id": 999,
  "player_id": 123456789
}'
Phản hồi mẫu
{
  "success": true,
  "player": {
    "player_id": "123456789",
    "player_name": "ProGamer99",
    "region": "Asia"
  }
}

Gửi yêu cầu thật ngay trên trang này

Dán khóa API để gọi trực tiếp các endpoint này. Khóa chỉ nằm trong tab trình duyệt này và chỉ được gửi tới chính API.

Enter your API key to use the interactive playground. Get your API key

Chọn endpoint

Use Catalog Explorer to find this

No requirements for this category.

Enter your API key above to try this endpoint.

Response will appear here after sending a request.

Nếu bạn mới dùng nền tảng, hãy bắt đầu với trang tổng quan API nạp game dành cho đại lý, hoặc đọc tổng quan chương trình đại lý SHOP2TOPUP để biết tài khoản đối tác hoạt động ra sao.

Tài liệu API kiểm tra người chơi: POST /player/validate