Endpoint de validación de jugador

La validación de jugador resuelve una cuenta dentro del juego antes de mover dinero. Confirma que el identificador existe para ese producto, devuelve el nombre dentro del juego para que su comprador lo revise, y expone la región para que un pedido de otra región se rechace temprano en lugar de fallar después del pago.

Qué campos enviar

El cuerpo de la solicitud es un par fijo más lo que exija el juego en sí. Lea primero GET /catalog/category/:categoryId/requirements y después envíe cada field_name que devuelva junto con sub_category_id y player_id. Los campos de tipo single_select o multi_select solo aceptan un valor de su propia lista select_options; cualquier otra cosa falla en la validación con INVALID_PRODUCT_CONFIG en lugar de llegar al juego.

Una respuesta exitosa devuelve el nombre dentro del juego y la región que hay detrás del identificador. Compare esa región con el producto que está por vender: una discrepancia se rechaza con REGION_MISMATCH, y atraparla en el momento de la validación cuesta una solicitud, mientras que atraparla en el momento del pedido cuesta un ciclo completo de reembolso.

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.

Límite de solicitudesHas its own rate limiter

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

Cuerpo de la solicitud

NombreTipoObligatorioDescripciónEjemplo
sub_category_idnumberThe subcategory ID of the product. Use Catalog Explorer to find this.999
player_idstringThe in-game player ID.123456789
...requirementsvariesNoAdditional fields from the Get Category Requirements endpoint. Include each field_name as a key with the user-provided value."server": "Asia"
Solicitud
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
}'
Respuesta de ejemplo
{
  "success": true,
  "player": {
    "player_id": "123456789",
    "player_name": "ProGamer99",
    "region": "Asia"
  }
}

Envíe una solicitud real desde esta página

Pegue una clave de API para llamar a estos endpoints en vivo. La clave se queda en esta pestaña del navegador y solo se envía a la propia API.

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

Elija un 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.

¿Recién llega a la plataforma? Empiece por la presentación de la API de recargas de juegos para revendedores, o lea la presentación del programa de revendedores de SHOP2TOPUP para ver cómo funciona la cuenta de socio.

Referencia API de validación — POST /player/validate