Comment obtenir un jeton de paiement

Pour ouvrir l’interface de paiement, vous devez obtenir un jeton. Un jeton est une chaîne de caractères renfermant des données cryptées sur un jeu et un utilisateur. Pour identifier l’utilisateur et permettre l’achat, vous devez implémenter l’obtention d’un jeton.

Pour obtenir un jeton de paiement :

1. Obtenez un jeton d’autorisation utilisateur.
2. Créez une commande.

Obtenir un jeton d'autorisation utilisateur

Le jeton a une durée de vie de 24 heures après le dernier appel à l’API Xsolla. Pour assurer la continuité, il est recommandé d’implémenter la logique de réception d’un nouveau jeton en arrière-plan, de manière à ce que l’utilisateur n’ait pas besoin de se reconnecter à l’application après l’expiration du jeton.

Dans le back-end de votre application, implémentez l’obtention d’un jeton d’authentification utilisateur. Pour ce faire, utilisez une requête HTTP POST, qui inclut l’authentification HTTP de base, et passez les paramètres requis dans le corps de la requête.

Référence API

Voir la liste complète des paramètres.

Authentification HTTP de base

L’API Xsolla utilise l’authentification d’accès de base. Les requêtes à l’API doivent 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.

Corps de la requête

Dans le corps de la requête, passez les paramètres requis suivants :

Pour améliorer l’expérience de l’utilisateur, vous pouvez également passer les paramètres suivants :

curl -i -X POST \
  -u 2340:ZHgbSDVP6LtAJVWu \
  https://api.xsolla.com/merchant/v2/merchants/<merchant_id>/token \
  -H 'Content-Type: application/json' \
  -d '{
    "settings": {
      "currency": "USD",
      "language": "en",
      "project_id": <project_id>
      }
    },
    "user": {
      "email": {
        "value": "<user_email>"
      },
      "id": {
        "value": "<user_id>"
      },
      "name": {
        "value": "<user_name>"
      }
    }
  }'

Exemple de jeton d’authentification utilisateur reçu en réponse

{
    "token": "1230OWrp0KF6uqvmN8jWuzLyoXMzxTyK_lc_en"
}

Obtenir un jeton de paiement

En réponse, vous recevrez les données dont vous aurez besoin aux étapes qui suivent :

• token — jeton de paiement.