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. Un champ manquant est refusé avec MISSING_REQUIRED_FIELD, et une valeur qui enfreint les règles du champ avec INVALID_PARAMETER_FORMAT, INVALID_PARAMETER_VALUE ou INVALID_PARAMETER_LENGTH ; dans les deux cas, details.field indique le champ.

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

Valider un joueur

Vérifie un ID joueur pour un jeu donné. Ajoutez les champs dynamiques renvoyés par l'endpoint « Obtenir les champs requis d'une catégorie ».

Limite de requêtesVotre quota quotidien de vérifications joueur (par compte), sans en-têtes X-RateLimit

Note: L'endpoint « Obtenir les champs requis d'une catégorie » vous indique quels champs chaque jeu attend. Placez tous les champs obligatoires dans le corps de la requête. PLAYER_NOT_FOUND signifie que le jeu a confirmé que l'ID n'existe pas ; PLAYER_CHECK_UNAVAILABLE (HTTP 503, réessayable) signifie que l'ID n'a pas pu être vérifié pour le moment, sans avoir été rejeté.

Corps de la requête

Nom	Type	Obligatoire	Description	Exemple
sub_category_id	number	Oui	L'ID de sous-catégorie du produit. Vous le trouverez dans l'explorateur de catalogue.	999
player_id	string	Oui	L'ID du joueur dans le jeu.	123456789
...requirements	varies	Non	Champs supplémentaires renvoyés par l'endpoint « Obtenir les champs requis d'une catégorie ». Chaque field_name devient une clé, avec la valeur saisie par l'utilisateur.	"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.