Configurer l’achat d’objets

Créer une commande côté serveur de l'application

Pour créer une commande avec les données utilisateur et les données de l’objet côté Xsolla, utilisez l’appel API Créer un jeton de paiement pour un achat. Cette méthode renverra un jeton de paiement, nécessaire pour ouvrir l’interface et effectuer un paiement. Pour utiliser le mode bac à sable, passez le paramètre “sandbox”: true dans le corps de la requête d’obtention du jeton.

Limites :

• Vous devez passer le pays ou l’adresse IP de l’utilisateur dans la requête de jeton de paiement. Ces données permettent au système de déterminer la devise d’achat, la langue de l’interface de paiement et de calculer les taxes.
• Si la devise n’est pas passée dans le jeton, elle est déterminée en fonction du pays.
• Si la devise est passée dans le jeton, l’utilisateur paie dans cette devise.
• Dans le paramètre user_id, passez l’ID de l’utilisateur dans votre système d’authentification. Cet ID est utilisé pour valider l’utilisateur avant un achat. Lors des tests, vous pouvez passer un symbole aléatoire dans ce paramètre.

Ouvrir l'interface de paiement

<script>
   var options = {
       access_token: 'ACCESS_TOKEN', //TODO use access token, received on previous step
       sandbox: true //TODO please do not forget to remove this setting when going live
   };
   var s = document.createElement('script');
   s.type = "text/javascript";
   s.async = true;
   s.src = "https://static.xsolla.com/embed/paystation/1.0.7/widget.min.js";
   s.addEventListener('load', function (e) {
       XPayStationWidget.init(options);
   }, false);
   var head = document.getElementsByTagName('head')[0];
   head.appendChild(s);
</script>

<button data-xpaystation-widget-open>Buy Credits</button>

<iframe
  src="https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN"
  width="800"
  height="700"
  allow="clipboard-read; clipboard-write; payment"
></iframe>

Effectuer un paiement test

Pour tester le processus de paiement, utilisez le mode bac à sable. Il s’agit d’un environnement autonome qui reproduit toutes les fonctionnalités d’un environnement réel, à l’exception des paiements réels et des paiements refusés. Pour accéder au mode bac à sable, passez le paramètre “sandbox”: true lorsque vous créez une commande.

1. Ouvrez l'interface de paiement en mode bac à sable.
2. Choisissez le mode de paiement Carte bancaire.
3. Entrez les informations de la carte bancaire. Dans les autres champs (par exemple, le nom ou l'adresse), entrez n'importe quelle donnée. Vous pouvez également indiquer des informations incorrectes (numéro de carte ou date d'expiration) pour vérifier si une erreur est générée.
4. Cliquez sur Pay.

Liste des cartes de test

Voir la liste des cartes bancaires de test.

Pour voir les informations détaillées, y compris les frais, sur les transactions effectuées en mode bac à sable :

1. Ouvrez votre Compte éditeur.
2. Accédez à Accounting > Transaction registry.
3. Cochez la case Show test transactions.

Vous pouvez également consulter les détails des transactions et demander des remboursements dans le Compte éditeur dans la section Support > Transaction search.