Endpoint de validation joueur

La validation joueur résout un compte in-game avant tout mouvement d'argent. Elle confirme que l'identifiant existe pour ce produit, renvoie le nom in-game pour que votre acheteur puisse le vérifier, et expose la région afin qu'une commande inter-régions soit rejetée tôt plutôt que d'échouer après paiement.

Quels champs envoyer

Le corps de la requête est une paire fixe à laquelle s'ajoute ce que le jeu lui-même exige. Lisez d'abord GET /catalog/category/:categoryId/requirements, puis envoyez chaque field_name renvoyé aux côtés de sub_category_id et player_id. Les champs de type single_select ou multi_select n'acceptent qu'une valeur issue de leur propre liste select_options ; toute autre valeur échoue à la validation avec INVALID_PRODUCT_CONFIG au lieu d'atteindre le jeu.

Une réponse réussie renvoie le nom in-game et la région derrière l'identifiant. Comparez cette région au produit que vous vous apprêtez à vendre : une incohérence est refusée avec REGION_MISMATCH, et l'attraper au moment de la validation coûte une requête, tandis que l'attraper au moment de la commande coûte un cycle de remboursement complet.

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.

Limite de requêtesHas 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.

Corps de la requête

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

Requête

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

Exemple de réponse

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

Envoyez une vraie requête depuis cette page

Collez une clé API pour appeler ces endpoints en direct. La clé reste dans cet onglet du navigateur et n'est envoyée qu'à l'API elle-même.

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

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

Nouveau sur la plateforme ? Commencez par la présentation de l'API de recharge de jeux pour revendeurs, ou lisez la présentation du programme revendeur SHOP2TOPUP pour comprendre le fonctionnement du compte partenaire.