Тестовое окружение (sandbox-режим)

Тестовое окружение (sandbox-режим) — это автономная рабочая среда, в которой доступны все функции live-режима, кроме проведения реальных платежей. Вы можете использовать тестовое окружение, чтобы протестировать работу:

  • платежного виджета;
  • аккаунта получателя выплат;
  • форм прохождения идентификации пользователя (KYC) и налогового интервью;
  • интеграции с API.

Платежный виджет

Чтобы открыть платежный виджет в тестовом окружении:

  1. Получите токен. Передайте в запросе параметр Authorization:Basic <your_authorization_basic_key>, где <your_authorization_basic_key> — пара ID платформы: секретный ключ, закодированная по стандарту Base64. Чтобы найти эти тестовые данные:
    1. Откройте проект в Личном кабинете и перейдите в раздел Payouts > Настройки.
    2. В правом верхнем углу в раскрывающемся списке режимов выберите Тестовый.
    3. Перейдите в раздел Настройки > Безопасность.

Пример запроса на получение токена:

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. Откройте тестовое окружение по ссылке https://payouts-sandbox-widget.xsolla.com/?token={token}, где {token} — токен, полученный на шаге 1.
    Примечание
    Открытие виджета с помощью SDK

    Чтобы открыть платежный виджет в тестовом окружении, передайте параметр sandbox: true в скрипте открытия виджета или в коде инициализации npm-пакета.

    Скрипт для открытия платежного виджета:

    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>
      

      Код инициализации для открытия платежного виджета:

      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. В открывшемся виджете установите флажок о прочтении и согласии с лицензионным договором.
        2. На вкладке Verification заполните поля тестовыми данными:
          • имя;
          • фамилия;
          • отчество (не обязательно);
          • страна;
          • национальность.
        3. Если вы хотите протестировать неуспешный сценарий, установите флажок для генерации ошибки при прохождении идентификации (KYC).
        4. Нажмите Send.
        1. На вкладке Tax Interview выберите сценарий, который вы хотите протестировать: успешный или с ошибкой.
        2. Совершите платеж, используя тестовые данные.
        Примечание
        Транзакции, выполненные в тестовом окружении, не влияют на боевое окружение.

        Аккаунт получателя выплат

        Чтобы открыть аккаунт получателя выплат в тестовом окружении:

        1. Откройте проект в Личном кабинете и перейдите в раздел Payouts > Настройки.
        2. В правом верхнем углу в раскрывающемся списке режимов выберите Тестовый.

        1. Перейдите на вкладку Пользователи и отправьте себе приглашение.
        2. В электронном письме, которое было отправлено на вашу почту, перейдите по ссылке в аккаунт получателя выплат.
        3. В аккаунте получателя выплат выберите мерчанта и совершите платеж, используя тестовые данные.
        Примечание
        Вы также можете перейти в тестовый аккаунт получателя выплат по прямой ссылке https://payouts-sandbox.xsolla.com/ и пройти авторизацию.

        Тестовые данные

        Внимание
        Любые данные не из списка тестовых, не будут работать в тестовом окружении.

        Тестовые карты

        Номер картыCVCСрок действияОписание
        4242424242424242Любые 3 цифрыЛюбая дата в будущемУспешный платеж
        4000000000000002Любые 3 цифрыЛюбая дата в будущемНеуспешный платеж

        Тестовые транзакции

        IBANДругие поляОписание
        FI211234569876543210Любые данныеУспешная выплата
        AT483200000012345864Любые данныеНеуспешная выплата

        Тестовые email-адреса

        Email-адресДругие поляОписание
        success@xsolla.comЛюбые данныеУспешная выплата
        failed@xsolla.comЛюбые данныеНеуспешная выплата

        Тестовые номера телефонов

        Номер телефонаДругие поляОписание
        +1 (555) 123-4567Любые данныеУспешная выплата
        +1 (555) 987-6543Любые данныеНеуспешная выплата
        Была ли статья полезна?
        Спасибо!
        Что может сделать страницу еще лучше? Сообщение
        Жаль, что так произошло
        Расскажите, почему статья не была полезна. Сообщение
        Спасибо за обратную связь!
        Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
        Оценить страницу
        Оценить страницу
        Что может сделать страницу еще лучше?

        В другой раз

        Спасибо за обратную связь!
        Последнее обновление: 22 января 2024

        Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

        Сообщите о проблеме
        Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
        Укажите email-адрес, чтобы мы могли связаться с вами
        Спасибо за обратную связь!