Тестирование карт в тестовом окружении
Тестовое окружение (sandbox-режим) — это автономная рабочая среда, в которой доступны все функции live-режима, кроме проведения реальных платежей и отмены платежей. Чтобы получить доступ к тестовому окружению, передайте параметр “mode”:“sandbox”
при получении токена.
Для открытия платежного интерфейса используйте ссылку, в которой укажите полученный токен: https://sandbox-secure.xsolla.com/paystation4/?token={token}
.
В тестовом окружении вы можете протестировать следующие сценарии взаимодействия с платежным интерфейсом при оплате банковской картой:
- совершение тестового платежа;
- возврат платежа;
- частичный возврат платежа;
- блокировка фродовой транзакции;
- имитация возвратного платежа (chargeback);
- сохранение карты;
- удаление сохраненной карты;
- списание с сохраненной карты;
- получение списка сохраненных карт.
Тестирование разовой оплаты
Совершение тестового платежа
- Откройте платежный интерфейс в тестовом окружении.
- Выберите способ оплаты Карта банка.
- Введите реквизиты карты. Остальные поля (например, имя или адрес) могут быть заполнены любыми данными. Вы также можете указать неверные реквизиты (номер карты или срок действия) для генерации ошибки.
- Нажмите Оплатить.
Кроме реквизитов карты вам потребуется указать индекс, если выполняется хотя бы одно из условий:
- Страна пользователя определена как США или Канада.
- ID карты (БИН) указывает на то, что карта выпущена в США.
Вы можете указать произвольное числовое значение в качестве индекса (например, 12345). Он используется для определения ставки налога на продажу и не влияет на прохождение тестового платежа.
Платежи банковской картой в тестовом окружении могут проводиться в следующих валютах: USD, EUR, RUB, GBP, AED, ALL, AMD, ARS, AUD, AZN, BGN, BRL, BYN, CAD, CHF, CLP, CNY, COP, CZK, DKK, DZD, EGP, GEL, HKD, HRK, HUF, IDR, ILS, INR, ISK, JPY, KES, KGS, KRW, KZT, MAD, MDL, MKD, MNT, MXN, MYR, NGN, PEN, PHP, PKR, PLN, RON, RSD, SAR, SEK, SGD, THB, TRY, TWD, UAH, UYU, UZS, VEF, VND, ZAR.
Чтобы увидеть подробную информацию, включая комиссии, о транзакциях, проведенных в тестовом окружении:
- Откройте Личный кабинет.
- Перейдите в раздел Финансы > Реестр транзакций.
- Установите флажок Показать тестовые транзакции.
Кроме этого, детали транзакции и оформление возврата доступны в Личном кабинете в разделе Поддержка > Поиск транзакций.
Возврат платежа
- Настройте обработку вебхука Возврат платежа.
- Совершите успешный тестовый платеж.
- Вызовите API-метод Возврат платежа.
Вы получите уведомление о возврате платежа на URL-адрес вебхука.
Частичный возврат платежа
- Настройте обработку вебхука Частичный возврат платежа.
- Совершите успешный тестовый платеж.
- Вызовите API-метод Частичный возврат платежа.
Вы получите уведомление о частичном возврате платежа на URL-адрес вебхука.
Блокировка фродовой транзакции
- Настройте обработку вебхука Транзакция отклонена при проверке AFS.
- Совершите тестовый платеж картой:
Карта | Страна | 3-D Secure |
---|---|---|
Номер карты: 5159084825528450 Срок действия: 12/40 CVV2: Любые 3 цифры Бренд карты: Mastercard | США | Нет |
Имитация возвратного платежа (chargeback)
Для тестирования этой возможности без участия банка реализован отдельный метод тестового окружения.
Чтобы протестировать возвратный платеж (chargeback):
- Настройте обработку вебхука Возврат платежа.
- Совершите успешный тестовый платеж.
- Вызовите API-метод Возврат платежа (chargeback).
В ответе вы получите вебхук возврата платежа:
Код | Причина отмены | Описание |
---|---|---|
2 | Chargeback | Используется, если по транзакции был chargeback. |
Тестирование сохраненных карт
Сохранение карты
Вы можете протестировать сохранение карты двумя способами:Сохранение карты при совершении тестового платежа
- Настройте обработку вебхука Добавление платежного аккаунта.
- Откройте платежный интерфейс в тестовом окружении.
- Выберите способ оплаты Карта банка.
- Введите реквизиты карты. Вы также можете указать неверные реквизиты (номер карты или срок действия) для генерации ошибки.
- Установите флажок Запомнить карту.
- Нажмите Оплатить.
Вы получите уведомление о добавлении карты на URL-адрес вебхука.
Сохраненная карта будет доступна в разделе Сохраненные способы.
Кроме реквизитов карты вам потребуется указать индекс, если выполняется хотя бы одно из условий:
- Страна пользователя определена как США или Канада.
- ID карты (БИН) указывает на то, что карта выпущена в США.
Вы можете указать произвольное числовое значение в качестве индекса (например, 12345). Он используется для определения ставки налога на продажу и не влияет на прохождение тестового платежа.
Платежи банковской картой в тестовом окружении могут проводиться в следующих валютах: USD, EUR, RUB, GBP, AED, ALL, AMD, ARS, AUD, AZN, BGN, BRL, BYN, CAD, CHF, CLP, CNY, COP, CZK, DKK, DZD, EGP, GEL, HKD, HRK, HUF, IDR, ILS, INR, ISK, JPY, KES, KGS, KRW, KZT, MAD, MDL, MKD, MNT, MXN, MYR, NGN, PEN, PHP, PKR, PLN, RON, RSD, SAR, SEK, SGD, THB, TRY, TWD, UAH, UYU, UZS, VEF, VND, ZAR.
Чтобы увидеть подробную информацию, включая комиссии, о транзакциях, проведенных в тестовом окружении:
- Откройте Личный кабинет.
- Перейдите в раздел Финансы > Реестр транзакций.
- Установите флажок Показать тестовые транзакции.
Кроме этого, детали транзакции и оформление возврата доступны в Личном кабинете в разделе Поддержка > Поиск транзакций.
Сохранение карты в аккаунте пользователя
- Настройте обработку вебхука Добавление платежного аккаунта.
- Откройте платежный интерфейс в тестовом окружении.
- Перейдите в раздел Сохраненные.
- Нажмите значок карандаша и выберите Добавить способ.
- Выберите способ оплаты Карта банка.
- Введите реквизиты карты. Вы также можете указать неверные реквизиты (номер карты или срок действия) для генерации ошибки.
- Нажмите Сохранить.
Вы получите уведомление о добавлении карты на URL-адрес вебхука.
Сохраненная карта будет доступна в разделе Сохраненные способы.
Удаление сохраненной карты
Вы можете протестировать удаление сохраненной карты двумя способами:Удаление сохраненной карты через метод API
- Настройте обработку вебхука Удаление платежного аккаунта.
- Вызовите API-метод Удаление сохраненного платежного аккаунта.
Вы получите уведомление об удалении карты на URL-адрес вебхука.
Удаление сохраненной карты через платежный интерфейс
- Настройте обработку вебхука Удаление платежного аккаунта.
- Откройте платежный интерфейс в тестовом окружении.
- Перейдите в раздел Сохраненные.
- Нажмите значок карандаша.
- Нажмите Редактировать.
- Выберите карту и нажмите значок корзины.
Вы получите уведомление об удалении карты на URL-адрес вебхука.
Списание с сохраненной карты
Вы можете протестировать списание с сохраненной карты двумя способами:- единовременные списания, например, совершение платежа с помощью PayPal;
- регулярные списания, например, оплата подписок.
Списание с сохраненной карты через метод API
- Настройте обработку вебхука Успешный платеж.
- Сохраните карту в тестовом окружении.
- Вызовите API-метод Оплата по сохраненному платежному аккаунту.
Вы получите уведомление об успешном платеже на URL-адрес вебхука.
Списание с сохраненной карты через платежный интерфейс
- Настройте обработку вебхука Успешный платеж.
- Сохраните аккаунт в тестовом окружении.
- Откройте платежный интерфейс в тестовом окружении.
- В списке сохраненных платежных аккаунтов выберите нужную карту.
- Нажмите Оплатить.
Вы получите уведомление об успешном платеже на URL-адрес вебхука.
Получение списка сохраненных карт
- Сохраните карты в тестовом окружении.
- Вызовите API-метод Список сохраненных платежных аккаунтов.
В ответе вы получите данные в обфусцированном виде.
Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.