SDK pour Unity / Informations générales
  Retour à la documentation

SDK pour Unity

Informations générales

Le SDK prend en charge l’achat des objets dans le catalogue en un clic ou via le panier.

Pour tester le processus d’achat, utilisez l’interface de paiement en mode bac à sable et les cartes de test. Le mode bac à sable simule uniquement le comportement d’un mode de paiement, aucun argent réel n’est impliqué. Pour essayer le mode bac à sable, vous n’avez pas besoin de signer de contrat avec Xsolla ni de payer de frais.

Avis
Après le premier paiement réel, une politique de paiement stricte entre en vigueur. Effectuer des paiements en mode bac à sable ne sera disponible qu’aux utilisateurs spécifiés dans le Compte éditeur, sous la section Company settings > Users.

L’interface de paiement est basée sur le produit Pay Station. Pour configurer les modes de paiement disponibles et d’autres paramètres, accédez à la section Pay Station dans le Compte éditeur.

Le mode d’ouverture de l’interface de paiement dépend de la plateforme pour laquelle votre application est conçue :

  • Pour les applications de bureau, le SDK vous permet d’ouvrir l’interface de paiement dans le navigateur intégré ou externe, en fonction des paramètre du projet.
  • Pour les applications mobiles, l’interface de paiement s’ouvre dans un navigateur externe.
  • Pour WebGL, le widget de l’interface de paiement s’ouvre dans un iframe sur la même page de navigateur.

Si vous ouvrez l’interface de paiement dans une WebView de votre application mobile, ajoutez l’icône afin que l’utilisateur puisse fermer l’interface de paiement à n’importe quel stade de l’achat. Pour ce faire, utilisez le paramètre close_button sur les instances de la classe PurchaseParams lors de l’appel à la méthode SDK XsollaCatalog.Purchase ou XsollaCart.Purchase.

Exemple d’utilisation du paramètre close_button dans une WebView :

Instructions

Pour en savoir plus sur les configurations avancées, consultez nos instructions.

Comment configurer la redirection des utilisateurs vers votre application après un paiement

Pour rediriger les utilisateurs vers une autre page après un paiement, vous pouvez configurer deux types de redirections :

  • automatique — une redirection automatique dans un délai défini ;
  • manuelle — une redirection lorsque l’utilisateur ferme l’interface de paiement ou clique sur le bouton de redirection.

Vous pouvez configurer la redirection de la manière suivante :

  • dans le Compte éditeur — utilisez cette option si vous configurez le projet pour une seule application et que vous ne prévoyez pas de créer des builds pour différentes plateformes.

  • dans les paramètres du SDK — utilisez cette option si vous envisagez de :
    • utiliser le projet pour plusieurs applications ;
    • créer des builds pour différentes plateformes ;
    • vendre des objets en jeu via le site Web.
Avis
Si les redirections sont configurées dans les paramètres du Compte éditeur et du SDK, les réglages spécifiés dans les paramètres du SDK sont utilisés.

Configurer les redirections dans le Compte éditeur

  1. Ouvrez votre projet dans le Compte éditeur.
  2. Dans le menu latéral, cliquez sur Pay Station.
  3. Accédez à la section Settings > Redirect policy.
  1. Dans le champ Return URL, entrez l'URL ou le chemin vers lequel l'utilisateur est redirigé après un paiement.
Note

Pour rediriger les utilisateurs vers une application mobile, l’URL doit correspondre à l’un des schémas suivants :

Vous pouvez trouver la valeur <ANDROID_PACKAGE_NAME>/<BUNDLE_ID> dans les paramètres du projet Unity (Edit > Project Settings > Player > Android (iOS) > Other Settings > Bundle Identifier).

  1. Pour définir les paramètres de redirection automatique :
    1. Dans la liste déroulante, sélectionnez Automatic redirect condition :
      • None — do not redirect ;
      • Successful payment — redirection lorsque le paiement est réussi ;
      • Successful or canceled payment — redirection lorsque le paiement est réussi ou annulé ;
      • Any payment — redirection, peu importe le statut du paiement.
    2. Dans le champ Delay, entrez un délai d'attente avant redirection en seconde. Par défaut, la redirection est activée en 0 seconde.

  1. Pour définir les paramètres de redirection manuelle :
    1. Dans la liste déroulante, sélectionnez Manual redirect condition :
      • None — do not redirect ;
      • Successful payment — le bouton de redirection apparaît lorsque le paiement est réussi ;
      • Successful or canceled payment — le bouton de redirection apparaît lorsque le paiement est réussi ou annulé ;
      • Any payment — le bouton de redirection apparaît, peu importe le statut du paiement.
    2. Dans le champ Redirect button caption, entrez le texte du bouton de redirection.
Avis

Par défaut, le texte du bouton de redirection est Revenir au jeu. Ce texte est traduit dans toutes les langues prises en charge par Pay Station.

Si votre projet prend en charge plusieurs langues, vous pouvez saisir le texte du bouton de redirection pour chacune d’entre elles dans les champs correspondants.

Lorsque l’utilisateur ferme l’interface de paiement, il est également redirigé vers l’URL de retour spécifiée.

  1. Cliquez sur Save.

Configurer les redirections dans les paramètres du SDK

  1. Ouvrez votre projet Unity.
  2. Dans le menu principal, cliquez sur Window > Xsolla > Edit Settings.
  3. Ouvrez le panneau Inspector et accédez à la section Pay Station > Redirect Policy.
  4. Accédez à la section correspondant à la plateforme de génération de votre application (Desktop, WebGL, Android ou iOS) et spécifiez les paramètres de redirection :

    1. Décochez la case Use setting from Publisher Account ;
    2. Dans le champ Return URL, entrez l'URL ou le chemin vers lequel l'utilisateur est redirigé après un paiement.
Note

Pour rediriger les utilisateurs vers une application mobile, l’URL doit correspondre à l’un des schémas suivants :

Vous pouvez trouver la valeur <ANDROID_PACKAGE_NAME>/<BUNDLE_ID> dans les paramètres du projet Unity (Edit > Project Settings > Player > Android (iOS) > Other Settings > Bundle Identifier).

    1. Pour définir les paramètres de redirection automatique :
      1. Dans la liste déroulante, sélectionnez Redirect Conditions :
        • None — aucune redirection ;
        • Successful payment — redirection lorsque le paiement est réussi ;
        • Successful or canceled payment — redirection lorsque le paiement est réussi ou annulé ;
        • Any payment — redirection peu importe le statut du paiement.
      2. Dans le champ Redirect Timeout, entrez un délai d'attente avant redirection en seconde.

    1. Pour définir les paramètres de redirection manuelle :
      1. Dans la liste déroulante, sélectionnezStatus for Manual Redirection :
        • None — aucune redirection ;
        • Successful payment — le bouton de redirection apparaît lorsque le paiement est réussi ;
        • Successful or canceled payment — le bouton de redirection apparaît lorsque le paiement est réussi ou annulé ;
        • Any payment — le bouton de redirection apparaît peu importe le statut du paiement.
      2. Dans le champRedirect Button Caption, entrez le texte du bouton de redirection.
Avis

Par défaut, le texte du bouton de redirection est Revenir au jeu. Ce texte est traduit dans toutes les langues prises en charge par Pay Station.

Si votre projet prend en charge plusieurs langues, vous pouvez saisir le texte du bouton de redirection pour chacune d’entre elles dans les champs correspondants.

Lorsque l’utilisateur ferme l’interface de paiement, il est également redirigé vers l’URL de retour spécifiée.

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

Poursuivre la lecture

Dernière mise à jour: 26 Avril 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 !