Настройка оповещений

Для продукта Подписки доступны оповещения при следующих событиях: 

Note
Для отмены подписки необходимо отменить последний платеж. Если подписка продлевалась вручную и оплачены несколько периодов, необходимо отменить все платежи.

  • Отмена платежа:
    • Отмена платежа (Платеж отменен через Личный кабинет);
    • Изменение подписки (Платеж отменен, но подписка продолжает действовать. Ситуация возможна, если пользователь случайно дважды оплатил подписку и отменил последний платеж);
    • Отмена подписки (Подписка отменена через Личный кабинет или отменены все платежи за все действующие периоды).

Note
Подробнее об оповещениях вы можете узнать в справочнике API.

Чтобы настроить оповещения:

  1. В Личном кабинете перейдите в раздел Настройки проекта > Оповещения.
  2. Установите переключатель в блоке Оповещения в положение Вкл.

  1. Укажите URL, на который будут приходить оповещения. Нажмите Сохранить настройки.

  1. Протестируйте оповещения в Личном кабинете.
  2. Протестируйте оплату подписки.
  3. Протестируйте продление подписки.
  4. Протестируйте отмену подписки.

Тестирование оповещений в Личном кабинете

  1. В Личном кабинете в разделе Настройки проекта > Оповещения перейдите на вкладку Подписки.

  1. Чтобы проверить работу системы оповещений, укажите значения из вашего проекта (User ID, Invoice ID), которые будут отправлены в запросе на указанный URL. При отсутствии реальных значений допускается ввод произвольных значений. Заполните поля:

Note
В Личном кабинете вы можете протестировать только базовые оповещения Проверка существования пользователя и Успешный платеж. Для тестирования остальных оповещений перейдите к разделам:

  1. Нажмите Тестировать.
  2. Убедитесь, что получено сообщение об успешном завершении тестирования. При успешной обработке запроса необходимо возвращать 204 HTTP код. В случае возникновения ошибки — 400-е или 500-е HTTP коды вместе с описанием ошибки.

Тестирование оплаты подписки

При тестировании оплаты на указанный при настройке оповещений URL будут отправлены оповещения Проверка существования пользователя, Успешный платеж, Создание подписки. Для тестирования процесса оплаты вы можете:

Note
Тестирование подписок с пробным периодом возможно только на реальных платежах, так как в тестовом окружении к подписке нельзя привязать платежный аккаунт.

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

  1. Получите токен для перехода к тестовому окружению. Для параметра Пробный период (trial_days) передайте значение 0.
  2. Выберите группу способов оплаты Банковские карты.
  3. Введите реквизиты тестовой банковской карты. Остальные поля могут быть заполнены любыми данными. Вы также можете указать неверные реквизиты (номер карты, срок действия или CVV) для генерации ошибки.

Note
Оплатить покупку в тестовом окружении возможно только тестовой банковской картой. Платежи могут проводиться в следующих валютах: 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. Получите оповещения Проверка существования пользователя, Успешный платеж, Изменение подписки на URL, указанный при настройке оповещений.

Реальный платеж

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

  1. Выполните тестирование оповещений в Личном кабинете и активируйте модуль Подписки.
  2. Подпишите Лицензионный договор. Для этого в Личном кабинете перейдите в раздел Финансы > Лицензионный договор, заполните договор и дождитесь подтверждения согласования.
  3. Получите токен для проведения реальных платежей.

Notice
Удалите из запроса на получение токена параметр "mode":"sandbox" перед тем, как начать принимать реальные платежи.

  1. Откройте платежный интерфейс. Для этого используйте ссылку https://secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN, где ACCESS_TOKEN — токен, полученный на предыдущем шаге.
  2. Выберите группу способов оплаты Банковские карты.
  3. Введите реквизиты действующей карты.

Note
Тестовые банковские карты подходят только для тестового окружения. Для реальных платежей рекомендуется использовать карты Visa и MasterCard.

  1. Получите оповещения Проверка существования пользователя, Успешный платеж, Изменение подписки на URL, указанный при настройке оповещений.
  2. Выполните возврат платежа. Для этого перейдите в Личный кабинет в раздел Поддержка > Поиск транзакций.
  3. Выберите тестовую транзакцию, нажмите значок расширенные настройки (•••), чтобы открыть меню. Затем нажмите Возврат (транзакция должна находиться в статусе Выполнена). При этом будут отправлены оповещения Отмена подписки, Отмена платежа.

Тестирование продления подписки

Notice
Доступно только для подписок без пробного периода.

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

  1. Получите токен для перехода к тестовому окружению. Для параметра Пробный период (trial_days) передайте значение 0.
  2. Оплатите подписку любым способом оплаты.
  3. Повторно откройте платежный интерфейс в тестовом окружении.
  4. Повторно оплатите подписку любым способом оплаты.
  5. Получите оповещения Проверка существования пользователя, Успешный платеж, Изменение подписки на URL, указанный при настройке оповещений.

Тестирование отмены подписки

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

Поиск по подписке

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

Поиск по транзакциям

  1. В Личном кабинете перейдите в раздел Поддержка > Поиск транзакций.
  2. Выполните поиск транзакции, которую необходимо отменить.
  3. Нажмите на значок Расширенные настройки (•••), чтобы открыть меню. Затем нажмите Возврат для получения оповещений Отмена подписки, Отмена платежа.

Note
Если подписка была оплачена несколько раз, необходимо отменить все платежи.

Через методы API

Используйте метод Изменение подписки, чтобы изменить статус подписки на Canceled и получить оповещение Отмена подписки.

Открытие платежного интерфейса в тестовом окружении

Чтобы открыть тестовый платежный интерфейс, необходимо получить токен с активированным режимом sandbox. Ссылку с таким токеном можно получить двумя способами:

Через Личный кабинет

  1. Протестируйте оповещения в Личном кабинете. Для тестирования подписки без пробного периода в поле Пробный период укажите значение 0.
  2. После получения сообщения об успешном завершении тестирования установите переключатель Включить модуль Подписки в положение Вкл в появившемся блоке. Под заголовком URL тестового окружения появится ссылка с нужным токеном.

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

  1. Перейдите по ссылке URL тестового окружения.

Через метод API

  1. Передайте в метод Создание токена параметр "settings":{"mode":"sandbox"}. Для тестирования подписки без пробного периода передайте параметр "purchase": {"subscription":{"trial_days": 0}}.
  2. Используйте ссылку https://sandbox-secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN, где ACCESS_TOKEN — токен, полученный на предыдущем шаге.

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

В другой раз

Спасибо за обратную связь!

Продолжить чтение

Последнее обновление: 1 сентября 2021

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

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