Comment implémenter la vente de la monnaie virtuelle Metaframe dans votre interface

Vous pouvez vendre de la monnaie virtuelle sans utiliser le widget Metaframe. Par exemple, si vous préférez créer votre propre interface de magasin ou utiliser un autre service d’autorisation. Pour ce faire, implémentez la logique d’achat de monnaie virtuelle, de recharge automatique et d’affichage du solde de l’utilisateur à l’aide de Metaframe API.

Prérequis

Avant de commencer, définissez les paramètres nécessaires au projet :

1. Créez un projet.
2. Créez des packages de monnaie virtuelle dans le Compte éditeur.
3. Obtenez les ID et la clé secrète nécessaires. Pour ce faire, contactez votre responsable de la réussite client ou bien envoyez un e-mail à csm@xsolla.com ou à integration@xsolla.com. Assurez-vous de fournir les informations suivantes disponibles dans le Compte éditeur :

• ID du commerçant, qui se trouve :
  • À côté du nom de votre entreprise ;
  • Dans la section Company settings > Company ;
  • Dans l’URL dans la barre d’adresse du navigateur sur n’importe quelle page du Compte éditeur. L’URL est au format suivant : https:​//publisher.xsolla.com/ID du commerçant/section du Compte éditeur.

• ID du projet, qui se trouve à côté du nom du projet.

• Clé secrète pour signer les webhooks du projet, qui se trouve dans la section Project settings > Webhooks.

• Clé API qui 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.

L’équipe Xsolla vous fournit les informations suivantes nécessaires pour poursuivre la configuration :

• ID de l’hôte ;
• ID client OAuth 2.0 du Compte Xsolla ;
• Clé secrète client OAuth 2.0 du Compte Xsolla.

Obtenir un jeton de serveur

Le jeton du serveur est nécessaire pour l’obtention du jeton d’accès utilisateur et pour la recharge automatique.

Côté serveur de votre application, implémentez une méthode pour obtenir le JSON Web Token (JWT) du serveur en utilisant l’appel API Generate JWT. La requête doit contenir les paramètres suivants :

• grant_type — type de JWT, passez la valeur client_credentials ;
• client_secret — clé secrète obtenue de Xsolla ;
• client_id — ID client obtenu de Xsolla.

Obtenir un jeton d'accès utilisateur

Le jeton d’autorisation utilisateur est nécessaire pour générer un jeton de paiement et demander le solde de la monnaie virtuelle de l’utilisateur.

Si vous utilisez votre propre système d’autorisation, pour obtenir un jeton d’autorisation approprié, utilisez :

• le jeton d’accès du réseau social ;
• le custom ID — l’ID utilisateur généré sur votre serveur.

Obtenir un jeton lors de la connexion via un réseau social

1. Configurer l'autorisation utilisateur via un réseau social dans le Compte éditeur :

1. 1. Ouvrez le projet dans le Compte éditeur.
   2. Dans le menu latéral, cliquez sur Login.
   3. Cliquez sur Create Login project.
   4. Sélectionnez Standard Login project et cliquez sur Create and set up. Une fois le nouveau projet de Login créé, la page avec les paramètres du projet de connexion s'affiche.
   5. Dans le bloc Login methods, sélectionnez Social login et cliquez sur Configure.
   6. Connectez les réseaux sociaux utilisés pour la connexion dans votre application.
   7. Cliquez sur le nom du projet de Login dans le fil d'Ariane pour revenir à la page du projet.
   8. Accédez au bloc Security et sélectionnez la section JWT signature.
   9. Choisissez RS256 comme algorithme de génération de signature et cliquez sur Save changes.

2. Dans la partie client de votre application, implémentez la réception et le rafraîchissement d'un jeton en utilisant l'appel API Auth via access token of social network.

Obtenir un jeton à l'aide d'un custom ID

Côté serveur de votre application, implémentez une méthode pour obtenir et rafraîchir le jeton en utilisant l’appel API Auth by custom ID. La requête doit contenir l’en-tête X-Server-Authorization: <server_JWT>, où <server_JWT> est le JWT du serveur obtenu à l’étape précédente.

Gérer la monnaie virtuelle à l'aide d'appels API