Эндпоинт проверки игрока

Проверка игрока определяет игровой аккаунт до того, как пойдут деньги. Она подтверждает, что идентификатор существует для этого товара, возвращает игровое имя, чтобы покупатель мог его сверить, и показывает регион — так заказ в чужой регион отклоняется заранее, а не проваливается после оплаты.

Какие поля отправлять

Тело запроса — фиксированная пара плюс то, что требует сама игра. Сначала прочитайте GET /catalog/category/:categoryId/requirements, затем отправьте каждое возвращённое field_name вместе с sub_category_id и player_id. Поля типа single_select или multi_select принимают только значение из собственного списка select_options; всё остальное падает на валидации с INVALID_PRODUCT_CONFIG, не доходя до игры.

Успешный ответ возвращает игровое имя и регион, стоящие за идентификатором. Сравните этот регион с товаром, который собираетесь продать: несовпадение отклоняется с REGION_MISMATCH, и поймать его на этапе проверки стоит одного запроса, а на этапе заказа — целого цикла возврата.

POST

/player/validate

Validate Player

Validate a player ID for a specific game. Include the dynamic requirement fields returned by the Get Category Requirements endpoint.

Лимит запросовHas its own rate limiter

Примечание: Use the Get Category Requirements endpoint to discover which fields are needed for each game. Include all required fields in the request body.

Тело запроса

Название	Тип	Обязательный	Описание	Пример
sub_category_id	number	Да	The subcategory ID of the product. Use Catalog Explorer to find this.	999
player_id	string	Да	The in-game player ID.	123456789
...requirements	varies	Нет	Additional fields from the Get Category Requirements endpoint. Include each field_name as a key with the user-provided value.	"server": "Asia"

Запрос

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
}'

Пример ответа

{
  "success": true,
  "player": {
    "player_id": "123456789",
    "player_name": "ProGamer99",
    "region": "Asia"
  }
}

Отправьте настоящий запрос прямо с этой страницы

Вставьте API-ключ, чтобы вызвать эти эндпоинты вживую. Ключ остаётся в этой вкладке браузера и отправляется только самому API.

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

Выберите эндпоинт

sub_category_id *

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.

Впервые на платформе? Начните с обзора API пополнения игр для реселлеров, а затем прочитайте обзор реселлерской программы SHOP2TOPUP, чтобы понять, как устроен партнёрский аккаунт.