Player validation endpoint

Player validation resolves an in-game account before any money moves. It confirms the identifier exists for that product, returns the in-game name so your buyer can check it, and surfaces the region so a cross-region order is rejected early instead of failing after payment.

Which fields to send

The request body is a fixed pair plus whatever the game itself requires. Read GET /catalog/category/:categoryId/requirements first, then send every field_name it returns alongside sub_category_id and player_id. Fields typed single_select or multi_select accept only a value from their own select_options list; anything else fails validation with INVALID_PRODUCT_CONFIG instead of reaching the game.

A successful response returns the in-game name and the region behind the identifier. Compare that region against the product you are about to sell: a mismatch is refused with REGION_MISMATCH, and catching it at validation time costs one request, while catching it at order time costs a full refund cycle.

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.

Rate limitHas its own rate limiter

Note: Use the Get Category Requirements endpoint to discover which fields are needed for each game. Include all required fields in the request body.

Request body

Name	Type	Required	Description	Example
sub_category_id	number	Yes	The subcategory ID of the product. Use Catalog Explorer to find this.	999
player_id	string	Yes	The in-game player ID.	123456789
...requirements	varies	No	Additional fields from the Get Category Requirements endpoint. Include each field_name as a key with the user-provided value.	"server": "Asia"

Request

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

Example response

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

Send a real request from this page

Paste an API key to call these endpoints live. The key stays in this browser tab and is sent only to the API itself.

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

Choose an endpoint

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.

New to the platform? Start with the game top-up API overview for resellers, or read the SHOP2TOPUP reseller programme overview for how the partner account works.