Questions générales
Paramètres de projet
Dois-je créer de nouveaux projets pour chaque environnement (AQ, pré-production, production) ?
Pour les tests, nous vous recommandons d’utiliser des projets distincts afin d’éviter d’affecter l’environnement de production.
Je suis un développeur de jeux mobiles. Que dois-je spécifier comme site Web dans les paramètres de projet ?
Spécifiez l’URL du site Web du jeu ou l’URL du site Web de votre entreprise.
Comment puis-je inviter des membres de mon entreprise pour leur donner accès à mon Compte éditeur ?
Dans votre Compte éditeur, accédez à Company settings > Users et cliquez sur Invite new user.
Où puis-je trouver l'ID de projet ?
Ouvrez le projet dans le Compte éditeur et accédez à la section Project settings > General settings.
Où puis-je trouver l'ID du commerçant ?
Ouvrez le Compte éditeur et accédez à la section Company settings > Company.
Quelle est la différence entre une clé secrète, une clé de projet et une clé API ?
La clé secrète correspond à la clé de projet et est utilisée pour la signature numérique nécessaire lors du traitement des paiements sécurisés. Le corps JSON de la requête est concaténé avec cette clé, puis le résultat est haché avec SHA-1.
La clé API est utilisée pour les appels API envoyés au serveur Xsolla. Cette clé doit être conservée sur votre propre serveur et jamais dans des fichiers binaires ou dans le frontend. Pour plus d’informations sur l’utilisation des clés API, voir la référence API.
Quelle est la différence entre une URL de webhook et une URL de retour ?
L’URL du webhook est l’adresse URL de votre serveur webhook où les notifications sont envoyées. Une URL de retour est l’adresse URL où l’utilisateur est redirigé après un paiement.
Où puis-je trouver la clé API ?
La clé API ne s’affiche dans le Compte éditeur qu’une seule fois lors de sa création, vous devez donc la conserver de votre côté. Vous pouvez créer une clé dans les sections suivantes :
Pour plus d’informations sur l’utilisation des clés API, consultez la référence API.
Recommandations principales :
- Enregistrez la clé API générée de votre côté. Lors de sa création dans le Compte éditeur, la clé API ne s’affiche qu’une seule fois.
- Gardez votre clé API secrète. Elle donne accès à votre compte personnel et à vos projets dans le Compte éditeur.
- Stockez la clé API sur votre serveur et non dans des fichiers binaires ou sur le client.
Si l’appel API nécessaire ne contient pas le paramètre de chemin project_id, utilisez la clé API valide dans tous les projets de l’entreprise pour l’autorisation.
API et webhooks
Quelles sont les API Xsolla disponibles ?
Vous pouvez utiliser les API suivantes :
Comment commencer à travailler avec l'API Xsolla ?
Référez-vous aux informations de base.
Où puis-je trouver des informations sur l'utilisation des webhooks ?
Dans la documentation webhook.
Quelles adresses IP du réseau Xsolla dois-je ajouter à la liste d'autorisations pour configurer les webhooks ?
Consultez la documentation webhooks pour obtenir la liste des adresses IP à partir desquelles les webhooks sont envoyés.
Dois-je utiliser HTTPS pour un protocole de webhook ?
Oui.
Pourquoi la notification Xsolla n'a-t-elle pas été envoyée à l'URL du webhook ?
Assurez-vous que votre serveur de webhook prend en charge les types de requêtes HTTP requis (POST, GET).
Pourquoi les webhooks ne sont-ils pas envoyés à mon application mobile ?
Les webhooks ne sont envoyés qu’à une seule adresse URL spécifiée dans les paramètres de votre projet. Étant donné que les webhooks sont des communications entre serveurs, ils ne peuvent pas être envoyés à plusieurs adresses URL. Si vous souhaitez recevoir des notifications dans votre jeu, site Web ou application mobile, configurez l’envoi de webhooks sur votre serveur pour permettre le transfert de données entre Xsolla et votre jeu.
Pourquoi l'en-tête Authorization n'apparaît-il pas dans la requête de webhook ?
Pour corriger cette erreur, vous devez modifier les fichiers Apache .htaccess ou httpd.conf. Reportez-vous à la documentation SDK pour plus d’informations.
SDK
Quels sont les SDK Xsolla disponibles ?
Xsolla prend en charge les SDK suivants :
Où puis-je trouver des informations détaillées sur chaque SDK ?
Accédez à la documentation SDK et choisissez la section appropriée.
Existe-t-il des SDK pour Node.JS/C#/Ruby/Java/ASP, etc ?
Il existe actuellement des SDK pour PHP et Android. Vous pouvez créer votre propre SDK en utilisant un langage ou une plateforme quelconque, à condition qu’il dispose des fonctionnalités des requêtes HTTPS.
Notifications automatiques en cas de changements importants dans les paramètres du Compte éditeur
Xsolla vous informe de toute modification apportée aux paramètres de votre projet susceptible d’affecter le traitement des paiements ou le fonctionnement de vos systèmes. Des notifications par e-mail sont envoyées aux utilisateurs disposant du rôle Owner dans le Compte éditeur, dans la section Company settings > Users. Ces notifications sont envoyées avec un délai allant jusqu’à une minute.
| Section du Compte éditeur | Événements de notification |
|---|---|
| Company settings |
|
| Project settings |
|
| Store | Changements dans les paramètres des clés de jeu, de la monnaie virtuelle et des objets virtuels :
|
Journal d'activité utilisateur
Le journal d’activité utilisateur suit les principales actions des utilisateurs de votre entreprise liées à l’utilisation des services clés de Xsolla. Ce journal enregistre toutes les requêtes HTTP envoyées à l’API, qu’elles soient directes ou déclenchées via l’interface du Compte éditeur.
Vous pouvez consulter le journal d’activité utilisateur dans le Compte éditeur, sous Company settings > Activity.
Cette section est accessible aux utilisateurs du Compte éditeur qui répondent aux critères suivants :
- Avoir le rôle Owner.
- Si l’accès est limité par projet, l’utilisateur doit avoir accès à tous les projets.

Fonctionnalités principales :
- Filtrez les données par période et par adresse e-mail de l’utilisateur ayant lancé la requête API.
- Exportez le journal d’activité utilisateur au format CSV selon le filtre appliqué.
- Le journal inclut les données des 2 dernières années. Pour obtenir des données antérieures à 2 ans, contactez votre responsable de la réussite client ou envoyez un e-mail à csm@xsolla.com.
- Les données ne peuvent être exportées que pour une période maximale d’un an. Pour une période plus longue, divisez-la en segments d’une durée inférieure à un an et exportez chaque segment séparément.
Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entrée.