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

SDK pour Cocos Creator

Informations générales

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

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

  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

Passez les paramètres de redirection à la méthode init. Pour ce faire, ajoutez les lignes du code source de votre projet dans Cocos Creator conformément à l’exemple pour un build Android ci-dessous. Définissez les paramètres de redirection :

  1. Dans le paramètre useSettingsFromPublisherAccount, passez false.
  2. Dans le paramètre returnUrl, passez une URL ou un 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 :

  1. Pour définir les paramètres de redirection automatique :
    1. Dans le paramètre redirectCondition, passez la condition d'activation d'une redirection :
      • PaymentRedirectCondition.none — aucune redirection ;
      • PaymentRedirectCondition.successful — redirection lorsque le paiement est réussi ;
      • PaymentRedirectCondition.successful_or_canceled — redirection lorsque le paiement est réussi ou annulé ;
      • PaymentRedirectCondition.any — redirection peu importe le statut du paiement.
    2. Dans le paramètre redirectDelay, passez un délai d'attente avant redirection en secondes.

  1. Pour définir les paramètres de redirection manuelle :
    1. Dans le paramètre redirectStatusManual, passez le statut de paiement auquel le bouton de redirection apparaît :
      • PaymentRedirectCondition.none — aucune redirection ;
      • PaymentRedirectCondition.successful — redirection lorsque le paiement est réussi ;
      • PaymentRedirectCondition.successful_or_canceled — redirection lorsque le paiement est réussi ou annulé ;
      • PaymentRedirectCondition.any — redirection, peu importe le statut du paiement.
    2. Dans le paramètre redirectButtonCaption, passez 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.

Exemple de configuration des redirections pour un build Android :

Copy
Full screen
Small screen
let redirectPolicySettingsAndroid: RedirectPolicySettings = {
                useSettingsFromPublisherAccount: false,
                returnUrl: 'app://xpayment.com.example.myapp',
                redirectCondition: PaymentRedirectCondition.successful,
                redirectDelay: 0,
                redirectStatusManual: PaymentRedirectStatusManual.successful,
                redirectButtonCaption: 'Back to the game'
        };
var settings: XsollaSettings = {
            loginId: '<yourLoginId>',
            projectId: '<yourProjectId>',
            clientId: '<yourClientId>',
            enableSandbox: IsSandbox,
            redirectPolicySettingsAndroid: redirectPolicySettingsAndroid
        }

        Xsolla.init(settings);
Note
Vous pouvez définir différents paramètres de redirection pour différentes plateformes du build de votre application. Pour ce faire, utilisez les paramètres :
  • redirectPolicySettingsAndroid
  • redirectPolicySettingsIOS
  • redirectPolicySettingsWebGL
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: 6 Mars 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 !