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

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

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

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

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

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

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

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

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

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

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

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

Чтобы использовать тестовое окружение, передайте параметр “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 или через платежный интерфейс. Доступны следующие варианты тестирования:

• тестирование банковских карт в тестовом окружении;
• тестирование PayPal в тестовом окружении;
• проведение реального платежа и оформление возврата.