Payments / Тестирование карт в тестовом окружении
  На главную

Payments

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

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

Для открытия платежного интерфейса используйте ссылку, в которой укажите полученный токен: https://sandbox-secure.xsolla.com/paystation4/?token={token}.

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

Тестирование разовой оплаты

Совершение тестового платежа

  1. Откройте платежный интерфейс в тестовом окружении.
  2. Выберите способ оплаты Карта банка.
  3. Введите реквизиты карты. Остальные поля (например, имя или адрес) могут быть заполнены любыми данными. Вы также можете указать неверные реквизиты (номер карты или срок действия) для генерации ошибки.
  4. Нажмите Оплатить.
Список тестовых карт
Посмотрите список тестовых банковских карт.
Примечание

Кроме реквизитов карты вам потребуется указать индекс, если выполняется хотя бы одно из условий:

  • Страна пользователя определена как США или Канада.
  • 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.

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

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

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

Возврат платежа

  1. Настройте обработку вебхука Возврат платежа.
  2. Совершите успешный тестовый платеж.
  3. Вызовите API-метод Возврат платежа.

Вы получите уведомление о возврате платежа на URL-адрес вебхука.

Частичный возврат платежа

  1. Настройте обработку вебхука Частичный возврат платежа.
  2. Совершите успешный тестовый платеж.
  3. Вызовите API-метод Частичный возврат платежа.

Вы получите уведомление о частичном возврате платежа на URL-адрес вебхука.

Блокировка фродовой транзакции

  1. Настройте обработку вебхука Транзакция отклонена при проверке AFS.
  2. Совершите тестовый платеж картой:
КартаСтрана3-D Secure
Номер карты: 5159084825528450
Срок действия: 12/40
CVV2: Любые 3 цифры
Бренд карты: Mastercard
СШАНет
При совершении такого платежа в платежном интерфейсе будет отображаться ошибка оплаты и вы получите уведомление об отклонении транзакции при проверке AFS на URL-адрес вебхука.

Имитация возвратного платежа (chargeback)

Для тестирования этой возможности без участия банка реализован отдельный метод тестового окружения.

Чтобы протестировать возвратный платеж (chargeback):

  1. Настройте обработку вебхука Возврат платежа.
  2. Совершите успешный тестовый платеж.
  3. Вызовите API-метод Возврат платежа (chargeback).

В ответе вы получите вебхук возврата платежа:

КодПричина отменыОписание
2ChargebackИспользуется, если по транзакции был chargeback.

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

Сохранение карты

Вы можете протестировать сохранение карты двумя способами:

Сохранение карты при совершении тестового платежа

  1. Настройте обработку вебхука Добавление платежного аккаунта.
  2. Откройте платежный интерфейс в тестовом окружении.
  3. Выберите способ оплаты Карта банка.
  4. Введите реквизиты карты. Вы также можете указать неверные реквизиты (номер карты или срок действия) для генерации ошибки.
  5. Установите флажок Запомнить карту.
  6. Нажмите Оплатить.
Список тестовых карт
Посмотрите список тестовых банковских карт.

Вы получите уведомление о добавлении карты на 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.

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

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

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

Сохранение карты в аккаунте пользователя

  1. Настройте обработку вебхука Добавление платежного аккаунта.
  2. Откройте платежный интерфейс в тестовом окружении.
  3. Перейдите в раздел Сохраненные.
  4. Нажмите значок карандаша и выберите Добавить способ.
  5. Выберите способ оплаты Карта банка.
  6. Введите реквизиты карты. Вы также можете указать неверные реквизиты (номер карты или срок действия) для генерации ошибки.
  7. Нажмите Сохранить.

Вы получите уведомление о добавлении карты на URL-адрес вебхука.
Сохраненная карта будет доступна в разделе Сохраненные способы.

Удаление сохраненной карты

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

Удаление сохраненной карты через метод API

  1. Настройте обработку вебхука Удаление платежного аккаунта.
  2. Вызовите API-метод Удаление сохраненного платежного аккаунта.

Вы получите уведомление об удалении карты на URL-адрес вебхука.

Удаление сохраненной карты через платежный интерфейс

  1. Настройте обработку вебхука Удаление платежного аккаунта.
  2. Откройте платежный интерфейс в тестовом окружении.
  3. Перейдите в раздел Сохраненные.
  4. Нажмите значок карандаша.
  5. Нажмите Редактировать.
  6. Выберите карту и нажмите значок корзины.

Вы получите уведомление об удалении карты на URL-адрес вебхука.

Списание с сохраненной карты

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

Списание с сохраненной карты через метод API

  1. Настройте обработку вебхука Успешный платеж.
  2. Сохраните карту в тестовом окружении.
  3. Вызовите API-метод Оплата по сохраненному платежному аккаунту.

Вы получите уведомление об успешном платеже на URL-адрес вебхука.

Списание с сохраненной карты через платежный интерфейс

  1. Настройте обработку вебхука Успешный платеж.
  2. Сохраните аккаунт в тестовом окружении.
  3. Откройте платежный интерфейс в тестовом окружении.
  4. В списке сохраненных платежных аккаунтов выберите нужную карту.
  5. Нажмите Оплатить.

Вы получите уведомление об успешном платеже на URL-адрес вебхука.

Получение списка сохраненных карт

  1. Сохраните карты в тестовом окружении.
  2. Вызовите API-метод Список сохраненных платежных аккаунтов.

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

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

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