Тестовое и боевое окружение

Общая информация

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

В тестовом окружении вы можете использовать любые способы оплаты, которые доступны в платежном интерфейсе, кроме реальных карт. Для тестирования используйте тестовые карты из списка. При совершении оплаты в тестовом окружении деньги не будут списаны с реальных счетов. Для тестирования с помощью тестовых банковских карт и PayPal доступны несколько сценариев.

После проведения тестового платежа вы получите чек об оплате, идентичный чеку, который отправляется пользователю при совершении реальных платежей, на email-адрес, переданный в запросе на получение токена. Если в вашем проекте настроены вебхуки, вы также получите вебхук об успешной оплате.

Чтобы увидеть подробную информацию, включая комиссии, о транзакциях, проведенных в тестовом окружении:

  1. Откройте Личный кабинет и перейдите в раздел Финансы > Реестр транзакций.
  2. Установите переключатель Показать тестовые транзакции в активное положение.

Кроме этого, детали транзакции и оформление возврата доступны в Личном кабинете в разделе Поддержка > Поиск транзакций.

Если при открытии платежного интерфейса возникает ошибка 0004-0008, проверьте в реестре транзакций в Личном кабинете, выполнялись ли реальные платежи в вашем проекте. В таких проектах платежный интерфейс в тестовом окружении могут открывать только пользователи, которые указаны в разделе Настройки компании > Пользователи.

Примечание
Вы можете найти список вебхуков и методов API, которые работают в тестовом окружении, в справочнике API для тестового окружения.
Внимание
При возникновении проблем в работе тестового окружения обратитесь в службу поддержки Xsolla.

Если при совершении тестового платежа в интерфейсе Личного кабинета возникает ошибка, проверьте, включен ли в вашем проекте external ID транзакции. Для этого перейдите в раздел Pay Station > Настройки. Если external ID включен в настройках проекта, этот параметр обязательно должен быть передан для генерации платежного токена. Однако при тестировании через Личный кабинет Xsolla не создает external ID транзакции. Чтобы избежать ошибки при тестировании, временно отключите использование external ID в настройках проекта.

Пример ошибки:

Переключение окружений

Примечание
Тестирование платежей до подписания договора с Xsolla доступно только в тестовом окружении. Если у вас возникли ошибки, изучите их описания.

Чтобы использовать тестовое окружение, передайте параметр “sandbox”: true в теле запроса на получение токена (метод получения токена зависит от вашего сценария интеграции). Для открытия платежного интерфейса используйте URL-адрес https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN, где TOKEN — это полученный токен.

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

  1. Подпишите лицензионный договор с Xsolla в Личном кабинете в разделе Договоры и налоги > Договоры.
  2. Уберите параметр “sandbox”: true из тела запроса при получении токена.
  3. Откройте платежный интерфейс по ссылке https://secure.xsolla.com/paystation4/?token=TOKEN, где TOKEN — это полученный токен.

Внимание
После проведения первого реального платежа в силу вступает строгая политика платежей в тестовом окружении. Проведение платежа в тестовом окружении будет доступно только для пользователей, которые указаны в Личном кабинете в разделе Настройки компании > Пользователи.

Варианты тестирования процесса оплаты

Вы можете изучить основные возможности работы продукта Pay Station, протестировав процесс оплаты через API или через платежный интерфейс. Доступны следующие варианты тестирования:

Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Последнее обновление: 9 июля 2025

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

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