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.
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 un bouton permettant à l’utilisateur de 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
.
Sélectionnez l’icône qui s’affichera sur le bouton. Pour ce faire, passez l’une des valeurs suivantes dans le paramètre close_button_icon
des instances de la classe PurchaseParams
:
“arrow”
— pour afficher l’icône ← (utilisé par défaut) ;“cross”
— pour afficher l’icône ×.
Exemple d’utilisation des paramètres close_button et close_button_icon dans une WebView :
Instructions
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 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.
Configurer les redirections dans le Compte éditeur
- Ouvrez votre projet dans le Compte éditeur.
- Dans le menu latéral, cliquez sur Pay Station.
- Accédez à la section Settings > Redirect policy.
- Dans le champ Return URL, entrez l'URL ou le chemin vers lequel l'utilisateur est redirigé après un paiement.
Pour rediriger les utilisateurs vers une application mobile, l’URL doit correspondre à l’un des schémas suivants :
app://xpayment.<ANDROID_PACKAGE_NAME>
, où<ANDROID_PACKAGE_NAME>
est le nom du package de l’application Android.app://xpayment.<BUNDLE_ID>
, où<BUNDLE_ID>
est l’identifiant de l’application iOS.
Vous pouvez trouver la valeur <ANDROID_PACKAGE_NAME>
/<BUNDLE_ID>
dans les paramètres du projet Unity (
- Pour définir les paramètres de redirection automatique :
- 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.
- 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.
- Dans la liste déroulante, sélectionnez Automatic redirect condition :
- Pour définir les paramètres de redirection manuelle :
- 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.
- Dans le champ Redirect button caption, entrez le texte du bouton de redirection.
- Dans la liste déroulante, sélectionnez Manual redirect condition :
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.
- Cliquez sur Save.
Configurer les redirections dans les paramètres du SDK
- Ouvrez votre projet Unity.
- Dans le menu principal, cliquez sur
Window > Xsolla > Edit Settings . - Ouvrez le panneau
Inspector et accédez à la sectionPay Station > Redirect Policy . - Accédez à la section correspondant à la plateforme de génération de votre application (
Desktop ,WebGL ,Android ouiOS ) et spécifiez les paramètres de redirection :
- Décochez la case
Use setting from Publisher Account ; - Dans le champ
Return URL , entrez l'URL ou le chemin vers lequel l'utilisateur est redirigé après un paiement.
- Décochez la case
Pour rediriger les utilisateurs vers une application mobile, l’URL doit correspondre à l’un des schémas suivants :
app://xpayment.<ANDROID_PACKAGE_NAME>
, où<ANDROID_PACKAGE_NAME>
est le nom du package de l’application Android.app://xpayment.<BUNDLE_ID>
, où<BUNDLE_ID>
est l’identifiant de l’application iOS.
Vous pouvez trouver la valeur <ANDROID_PACKAGE_NAME>
/<BUNDLE_ID>
dans les paramètres du projet Unity (
- Pour définir les paramètres de redirection automatique :
- 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.
- Dans le champ
Redirect Timeout , entrez un délai d'attente avant redirection en seconde.
- Dans la liste déroulante, sélectionnez
- Pour définir les paramètres de redirection automatique :
- Pour définir les paramètres de redirection manuelle :
- Dans la liste déroulante, sélectionnez
Status 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.
- Dans le champ
Redirect Button Caption , entrez le texte du bouton de redirection.
- Dans la liste déroulante, sélectionnez
- Pour définir les paramètres de redirection manuelle :
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.
Poursuivre la lecture
Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.