Mode bac à sable

Le mode bac à sable est un environnement autonome qui prend en charge toutes les fonctionnalités d’un environnement réel, à l’exception des paiements réels. Utilisez le mode bac à sable pour tester :

  • le widget de paiement ;
  • le compte bénéficiaire ;
  • les formulaires pour passer la procédure de vérification de l’identité (KYC) et l’entretien fiscal ;
  • l’intégration avec l’API.

Widget de paiement

Pour ouvrir le widget de paiement en mode bac à sable :

  1. Obtenez le jeton. Dans la requête, passez le paramètre Authorization:Basic <your_authorization_basic_key>, où <your_authorization_basic_key> est la paire platform ID:secret key, encodée selon le standard Base64. Pour trouver ces données de test :
    1. Ouvrez votre projet dans le Compte éditeur et accédez à la section Payouts > Settings.
    2. Dans le coin supérieur droit, choisissez Sandbox dans la liste déroulante.
    3. Accédez à la section Settings > Security.

Exemple de requête d’obtention d’un jeton :

Copy
Full screen
Small screen
    curl -X POST 'https://payouts-sandbox-api.xsolla.com/api/v1/merchants/customer/auth' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Basic <your_authorization_basic_key>' \
    -d '{"email": "<your email>", "name": "<your name>"}'
    
    1. Ouvrez le mode bac à sable en suivant le lien https://payouts-sandbox-widget.xsolla.com/?token={token}, où {token} est le jeton obtenu à l'étape 1.
    Note
    Ouvrir le widget à l’aide des SDK

    Pour ouvrir le widget de paiement en mode bac à sable, passez le paramètre sandbox: true dans le script d’ouverture du widget ou dans le code d’initialisation du npm-package.

    Script d’ouverture du widget de paiement :

    Copy
    Full screen
    Small screen
      <script>
          var s = document.createElement('script');
          s.type = "text/javascript";
          s.async = true;
          s.src = "https://static.xsolla.com/payouts/v0/_bundles/santorelli.min.js";
          s.addEventListener('load', function () {
              const widget = new XPayoutsWidget.Widget({
                          token: '<auth token>',
                          theme: 'black',
                          size: 'fixed',
                          sandbox: true
                      });
      
              widget.show('<container_id>');
      
              widget.addEventListener('load', () => {
                  console.log('loaded');
              });
          }, false);
          var head = document.getElementsByTagName('head')[0];
          head.appendChild(s);
      </script>
      

      Code d’initialisation pour ouvrir le widget de paiement :

      Copy
      Full screen
      Small screen
        import {Widget} from '@xsolla/payouts-sdk';
        
        const widget = new Widget({
        	token: '<auth token>',
        	theme: 'black',
        	size: 'fixed',
        	sandbox: true  
        });
        
        widget.show('<container_id>');
        
        widget.addEventListener('load', () => {
        	console.log('loaded');
        });
        

        1. Dans le widget qui s'ouvre, cochez la case pour indiquer que vous avez lu et accepté le contrat de licence.
        2. Dans l'onglet Verification, remplissez les champs avec les données de test :
          • prénom ;
          • nom ;
          • deuxième prénom (non obligatoire) ;
          • pays ;
          • nationalité.
        3. Si vous souhaitez tester un scénario d'échec, cochez la case pour générer une erreur lors de la procédure de vérification d'identité (KYC).
        4. Cliquez sur Send.
        1. Dans l'onglet Tax Interview, sélectionnez un scénario que vous souhaitez tester : un succès ou une erreur.
        2. Effectuer un paiement en utilisant les données de test.
        Note
        Les transactions effectuées en mode bac à sable n’ont aucun effet sur l’environnement de production.

        Compte bénéficiaire

        Pour ouvrir un compte bénéficiaire en mode bac à sable :

        1. Ouvrez votre projet dans le Compte éditeur et accédez à la section Payouts > Settings.
        2. Dans le coin supérieur droit, choisissez Sandbox dans la liste déroulante.

        1. Accédez à l'onglet Users et envoyez-vous une invitation.
        2. Dans l'e-mail que vous recevez à votre adresse e-mail, suivez le lien vers le compte bénéficiaire.
        3. Dans le compte bénéficiaire, choisissez un commerçant et effectuez un paiement en utilisant des données de test.
        Note
        Vous pouvez également accéder au compte bénéficiaire en mode bac à sable en suivant le lien https://payouts-sandbox.xsolla.com/ et en passant la procédure d’authentification.

        Données de test

        Avis
        Toute donnée ne figurant pas dans la liste des données de test ne fonctionnera pas en mode bac à sable.

        Cartes de test

        Numéro de carteCVCDate d’expirationDescription
        42424242424242423 chiffres aléatoiresDate future aléatoirePaiement réussi
        40000000000000023 chiffres aléatoiresDate future aléatoirePaiement échoué

        Transactions de test

        IBANAutres champsDescription
        FI211234569876543210Données aléatoiresRetrait réussi
        AT483200000012345864Données aléatoiresRetrait échoué

        Adresse e-mail de test

        Adresse e-mailAutres champsDescription
        success@xsolla.comDonnées aléatoiresRetrait réussi
        failed@xsolla.comDonnées aléatoiresRetrait échoué

        Tester les numéros de téléphone

        Numéro de téléphoneAutres champsDescription
        +1 (555) 123-4567Données aléatoiresRetrait réussi
        +1 (555) 987-6543Données aléatoiresRetrait échoué
        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.
        Évaluer cette page
        Évaluer cette page
        Que pouvons-nous améliorer ?

        Préfère ne pas répondre

        Merci pour votre commentaire !
        Dernière mise à jour: 22 Janvier 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 !