Créer une commande côté client 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 Create order with specified item. 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.

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>

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

Créer une commande et ouvrir l'interface de paiement

Pour créer une commande avec les données de l’utilisateur et du bien côté Xsolla, appelez la méthode SDK XsollaCatalog.Purchase ; passez les paramètres suivants :

• itemSku — UGS de l’objet que l’utilisateur souhaite acheter.
• onSuccess — fonction de rappel en cas d’achat réussi, déclenché lorsque le statut de la commande passe à done.
• onError — fonction de rappel en cas d’erreur de requête.
• onBrowseClosed — fonction de rappel en cas de fermeture du navigateur (facultatif). L’événement n’est suivi que lorsque l’utilisateur ouvre l’interface de paiement dans le navigateur intégré. Les événements liés à un navigateur externe ne sont pas suivis.
• purchaseParams — paramètres d’achat et d’interface de paiement de l’utilisateur, tels que la devise et la langue (facultatif).
• customHeaders — en-têtes personnalisés de la requête Web (facultatif).

La méthode XsollaCatalog.Purchase lance le processus d’achat pour l’objet spécifié, incluant la création de la commande, l’ouverture de l’interface de paiement et le suivi de l’état de la commande. Le paramètre onSuccess contient une fonction qui est appelée lorsque le statut de la commande passe à done.

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, cochez la case Test Payments Mode dans l’éditeur Unity, dans le panneauInspector (cochée par défaut).

1. Lancez votre application ou la scène dans l'éditeur Unity.
2. Choisissez le mode de paiement Bank card.
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 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.

Créer une commande et ouvrir l'interface de paiement

1. Pour créer une commande avec les données de l'utilisateur et du bien côté Xsolla, appelez la méthode createOrderByItemSku de la bibliothèque Store ; passez les paramètres suivants :

1. • callback — fonction de rappel en cas de création de commande réussie. Elle reçoit le jeton nécessaire pour ouvrir l'interface de paiement et effectuer le paiement ;

1. • itemSku — UGS de l'objet que l'utilisateur souhaite acheter ;

1. • options — paramètres de paiement (facultatif) ;

1. • quantity — nombre d'objets que l'utilisateur souhaite acheter (facultatif). Si la quantité n'est pas spécifiée, la valeur 1 est fixée par défaut.

2. Implémentez la logique d'ouverture de l'interface UI :

val intent = XPayments.createIntentBuilder(activity)
    .accessToken(AccessToken(<payment token>))
    .isSandbox(<isSandbox>)
    .build()
startActivityForResult(intent, RC_PAYSTATION)

3. implémentez la gestion des résultats des paiements :

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    if (requestCode == RC_PAYSTATION) {
        val (status, _) = XPayments.Result.fromResultIntent(data)
        when (status) {
            XPayments.Status.COMPLETED -> Log.d("MainActivity", "Payment completed")
            XPayments.Status.CANCELLED -> Log.d("MainActivity", "Payment cancelled")
            XPayments.Status.UNKNOWN -> Log.d("MainActivity", "Status unknown")
        }
    }
}

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, appelez la méthode isSandbox et passez true comme argument lors de la création d’un objetIntentBuilder.

1. Lancez votre application.
2. Choisissez le mode de paiement Bank card.
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 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.

Créer une commande et ouvrir l'interface de paiement

1. Pour créer une commande avec les données de l'utilisateur et du bien côté Xsolla, appelez la méthode SDK FetchPaymentToken ; passez les paramètres suivants :

1. • AuthToken — jeton d'authentification utilisateur, obtenu lors de l'authentification via Xsolla Login ;

1. • ItemSKU — UGS de l'objet que l'utilisateur souhaite acheter ;

1. • SuccessCallback — fonction de rappel déclenché lors de la réception du jeton de paiement ;

1. • ErrorCallback — fonction de rappel d'état ;

1. • PurchaseParams — paramètres d'achat et d'interface de paiement de l'utilisateur, tels que la devise et la langue (facultatif).

2. Implémentez l'ouverture de l'interface de paiement. Pour ce faire, appelez la méthode SDK LaunchPaymentConsole ; passez les paramètres suivants :

1. • WorldContextObject — objet de contexte mondial (pour les appels C++) ;

1. • OrderId — ID de la commande ;

1. • AccessToken — jeton de paiement ;

1. • SuccessCallback — fonction de rappel déclenché lors de la réception du jeton de paiement ;

1. • ErrorCallback — fonction de rappel d'état ;

1. • BrowserClosedCallback — fonction de rappel an cas de fermeture du navigateur. L'événement n'est suivi que lorsque l'utilisateur ouvre l'interface de paiement dans le navigateur intégré. Les événements liés à un navigateur externe ne sont pas suivis ;

1. • PayStationVersion — version de Pay Station. Par défaut, la version 4 est utilisée.

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, cochez la case Enable Sandbox dans l’éditeur Unreal, dans la section Settings > Project Settings > Plugins > Xsolla Settings > Purchases (cochée par défaut).

1. Lancez votre application ou la map dans l'éditeur Unreal.
2. Choisissez le mode de paiement Bank card.
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 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.