Configurer la vente des objets
In-Game Store vous permet monétiser les jeux par la vente en jeu des biens suivants contre des devises réelles ou de la monnaie virtuelle :
- monnaie en jeu et packages de monnaie ;
- objets consommables ;
- objets non consommables ;
- objets à durée limitée.
Biens | Mode de vente |
---|---|
Un objet (par exemple, un objet virtuel ou un montant quelconque de monnaie virtuelle) | Appels d’achat rapide |
Plusieurs biens dans un panier | Passez l’ID unique de l’utilisateur. L’ID unique de l’utilisateur est utilisé dans le titre sous la forme d’un numéro ou d’une ligne lors de l’appel aux méthodes API de la sous-section Catalog du groupe de méthodes Virtual items & currency (paramètre x-unauthorized-id ). L’identifiant est généré côté front-end, par exemple via la bibliothèque de génération d’identifiants. |
Pour gérer l’accès des utilisateurs à votre application et aux fonctionnalités des produits Xsolla, configurez un système d’authentification. Pour ce faire, utilisez Xsolla Login ou implémentez votre propre système d’authentification.
Si vous avez implémenté votre propre système d’authentification et que vous n’avez besoin que de l’interface de paiement, générez le jeton d’accès Pay Station et configurez les webhooks sur votre serveur.
Utilisez Xsolla Login pour votre In-Game Store, si vous n’avez pas vos propres serveurs ou si vous souhaitez utiliser une solution existante. Les fonctions suivantes sont exécutées côté Xsolla :
- stockage et gestion du catalogue ;
- gestion des prix ;
- stockage des données sur les prix régionaux ;
- authentification des utilisateurs ;
- traitement des transactions.
Authentification via Xsolla Login
Xsolla Login prend en charge le protocole standard OAuth 2.0 pour l’enregistrement et l’authentification utilisateur. Le protocole standard OAuth 2.0 contribue à simplifier le développement de l’application côté client. OAuth 2.0 vous permet de mettre à jour le jeton d’accès sans impliquer l’utilisateur.
Les données sur les utilisateurs autorisés peuvent être stockées :
- Dans le stockage Xsolla. Voir Commencer avec Xsolla Login pour le configurer.
- Dans la base de données PlayFab. Utilisez les instructions pour le stockage PlayFab pour la configurer.
- Dans un stockage personnalisé. Utilisez les instructions pour un stockage personnalisé pour le configurer.
Authentification par jeton d'accès Pay Station
Flux général
Flux d’interaction entre votre client et le serveur Xsolla :- Votre client envoie une requête d’authentification à votre serveur.
- Votre serveur demande un jeton d’autorisation et envoie un en-tête qui contient les paramètres
project_id/merchant_id
etapi_key
au serveur Xsolla. - Le serveur Xsolla renvoie le jeton d’accès Pay Station.
- Votre serveur passe le jeton d’accès Pay Station à votre client.
- Le jeton d’accès Pay Station renvoyé est utilisé comme jeton d’autorisation pour l’authentification dans In-Game Store API et la construction d’une interface de magasin.
Obtenir le jeton d'accès Pay Station
Sur le back-end de votre application, implémentez une méthode pour obtenir le jeton d’accès Pay Station à l’aide d’une requête HTTP POST.
L’API Xsolla utilise l’authentification HTTP de base. La requête doit contenir l’en-tête Authorization: Basic <your_authorization_basic_key>
, où <your_authorization_basic_key>
est la paire merchant ID:API key encodée conformément à la norme Base64. Accédez au Compte éditeur pour trouver les paramètres suivants :
- Merchant ID est affiché :
- Dans la section Company settings > Company ;
- Dans l'URL de la barre d'adresse du navigateur sur n'importe quelle page du Compte éditeur. L'URL est au format suivant :
https://publisher.xsolla.com/<merchant ID>/<Publisher Account section>
.
- L'API key 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 nouvelle clé dans les sections suivantes :
- Company settings > API keys ;
- Project settings > API keys.
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.
Requête HTTP :
POST https://api.xsolla.com/merchant/v2/merchants/{merchant_id}/token
Pour obtenir le jeton, passez les paramètres suivants dans le corps de la requête :
Paramètre | Type | Description |
---|---|---|
settings | object | Paramètres de projet personnalisés (objet). |
settings.project_id | integer | ID Xsolla du jeu. Il se trouve dans le Compte éditeur à côté du nom de votre projet. Obligatoire. |
user | object | Informations sur l’utilisateur (objet). |
user.id | object | ID utilisateur dans votre système d’autorisation (objet). |
user.id.value | string | ID utilisateur. Obligatoire. |
user.email | object | Adresse e-mail utilisateur (objet). |
user.email.value | string | Adresse e-mail utilisateur. Doit être valide selon le protocole RFC 822. Obligatoire. |
user.name | object | Pseudo de l’utilisateur (objet).Obligatoire. |
user.name.value | string | Pseudo de l’utilisateur. |
user.steam_id | object | ID Steam de l’utilisateur (objet). |
user.steam_id.value | string | ID Steam de l’utilisateur. Obligatoire si l’application est publiée sur Steam. |
user.playfab_id | object | ID PlayFab de l’utilisateur (objet) |
user.playfab_id.value | string | ID PlayFab de l’utilisateur. Obligatoire si l’application utilise les services PlayFab pour l’octroi des objets. |
custom_parameters
, purchase
, etc.), ils ne sont pas destinés à recevoir un jeton d’autorisation.La durée de vie du jeton d’accès Pay Station lors de l’utilisation d’In-Game Store et de l’inventaire du jeu est d’une heure après le dernier appel à l’API Xsolla. Pour modifier la durée de vie du jeton d’accès Pay Station, contactez votre responsable de la réussite client ou envoyez un e-mail à csm@xsolla.com.
Implémentez la logique d’obtention d’un nouveau jeton d’accès pay Station après son expiration. Nous vous recommandons d’effectuer cette opération en arrière-plan, afin que l’utilisateur n’ait pas à se reconnecter à l’application.
Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.