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.

BiensMode de vente
Un objet (par exemple, un objet virtuel ou un montant quelconque de monnaie virtuelle)Appels d’achat rapide
Plusieurs biens dans un panierPassez 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 :

Note
Les données utilisateur comprennent le solde en monnaie réelle (monnaie), les cartes enregistrées, l’historique des transactions et les abonnements.

Authentification par jeton d'accès Pay Station

Note
Recommandée si vous souhaitez intégrer les méthodes In-Game Store API.

Flux général

Flux d’interaction entre votre client et le serveur Xsolla :
  1. Votre client envoie une requête d’authentification à votre serveur.
  2. Votre serveur demande un jeton d’autorisation et envoie un en-tête qui contient les paramètres project_id/merchant_id et api_key au serveur Xsolla.
  3. Le serveur Xsolla renvoie le jeton d’accès Pay Station.
  4. Votre serveur passe le jeton d’accès Pay Station à votre client.
  5. 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.
Note
Par défaut, la durée de vie du jeton est de 24 heures. Si vous souhaitez modifier cette valeur, contactez votre responsable de la réussite client ou envoyez un e-mail à csm@xsolla.com. La nouvelle valeur sera activée pour tous les projets de votre entreprise créés dans le Compte éditeur.

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.
Avis

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ètreTypeDescription
settings
objectParamètres de projet personnalisés (objet).
settings.project_id
integerID Xsolla du jeu. Il se trouve dans le Compte éditeur à côté du nom de votre projet. Obligatoire.
user
objectInformations sur l’utilisateur (objet).
user.id
objectID utilisateur dans votre système d’autorisation (objet).
user.id.value
stringID utilisateur. Obligatoire.
user.email
objectAdresse e-mail utilisateur (objet).
user.email.value
stringAdresse e-mail utilisateur. Doit être valide selon le protocole RFC 822. Obligatoire.
user.name
objectPseudo de l’utilisateur (objet).Obligatoire.
user.name.value
stringPseudo de l’utilisateur.
user.steam_id
objectID Steam de l’utilisateur (objet).
user.steam_id.value
stringID Steam de l’utilisateur. Obligatoire si l’application est publiée sur Steam.
user.playfab_id
objectID PlayFab de l’utilisateur (objet)
user.playfab_id.value
stringID PlayFab de l’utilisateur. Obligatoire si l’application utilise les services PlayFab pour l’octroi des objets.
Voir des exemples de requêtes et de réponses dans la référence API.
Avis
Dans la requête, utilisez uniquement les paramètres de la liste ci-dessus. Ne passez pas d’autres paramètres de l’appel API (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.

Cet article vous a été utile ?
Merci !
Que pouvons-nous améliorer ? Message
Nous sommes désolés de l'apprendre
Dites-nous pourquoi vous n'avez pas trouvé cet article utile. Message
Merci pour votre commentaire !
Nous examinerons votre message et l'utiliserons pour améliorer votre expérience.
Dernière mise à jour: 3 Octobre 2024

Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.

Signaler un problème
Nous améliorons continuellement notre contenu grâce à vos commentaires.
Indiquez votre adresse e-mail pour un suivi
Merci pour votre commentaire !