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. Un campo ausente se rechaza con MISSING_REQUIRED_FIELD, y un valor que incumple las reglas del campo, con INVALID_PARAMETER_FORMAT, INVALID_PARAMETER_VALUE o INVALID_PARAMETER_LENGTH; en ambos casos details.field indica el campo.

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

Validar jugador

Valida el ID de un jugador para un juego específico. Incluye los campos de requisitos dinámicos que devuelve el endpoint Obtener requisitos de la categoría.

Límite de solicitudesTu cuota diaria de verificación de jugadores (por cuenta), sin encabezados X-RateLimit

Nota: Consulta el endpoint Obtener requisitos de la categoría para saber qué campos necesita cada juego. Incluye todos los campos obligatorios en el cuerpo de la solicitud. PLAYER_NOT_FOUND significa que el juego confirmó que el ID no existe; PLAYER_CHECK_UNAVAILABLE (HTTP 503, se puede reintentar) significa que el ID no se pudo verificar en este momento y no fue rechazado.

Cuerpo de la solicitud

NombreTipoObligatorioDescripciónEjemplo
sub_category_idnumberSíID de subcategoría del producto. Lo encuentras en el Explorador de catálogo.999
player_idstringSíID del jugador dentro del juego.123456789
...requirementsvariesNoCampos adicionales del endpoint Obtener requisitos de la categoría. Incluye cada field_name como clave con el valor que ingresó el usuario."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