С чего начать

Сценарий интеграции

Чтобы подключить Подписки:

  1. Зарегистрируйтесь в Личном кабинете Иксолла.
  2. Настройте план.
  3. Настройте оповещения.
  4. Получите токен.
  5. Настройте открытие интерфейса подписок.

Как это работает

Шаг 1 — получение токена для открытия платежного интерфейса

Шаг 2 — совершение покупки

Шаг 3 — совершение оплаты

Сценарий пользователя

Глоссарий

План подписки
Условия оплаты (сумма, валюта, периодичность), на основе которых пользователь приобретает доступ к услуге. Настройка плана — обязательный этап интеграции.
Продукт подписки
Услуга или пакет услуг, предоставляемые пользователю при подписке. Создание продуктов необходимо, если вы настраиваете продажу отдельных подписок на разные услуги или хотите дать пользователю возможность оформлять несколько подписок одновременно. Пример продукта подписки — канал стримера или инфлюенсера.

Подписка

Сочетание продукта и выбранного плана. Подписка создается, когда пользователь выбирает план подписки и получает доступ к услуге. Количество созданных подписок, которые пользователь может оформить одновременно, зависит от количества продуктов в проекте. Условия подписки (расчетный период, стоимость и другие) соответствуют условиям выбранного плана. Если условия плана изменяются после создания подписки, условия существующей подписки не меняются.

ПРИМЕР 1

Продукт: Доступ к игре

  • План подписки Silver: $10 за 1 месяц
  • План подписки Gold: $100 за 1 год

Пользователь может выбрать один из вариантов подписки:

  • Подписка 1: Доступ к игре за $10 в месяц
  • Подписка 2: Доступ к игре за $100 в год

ПРИМЕР 2

Продукт 1: Доступ к игре1

Продукт 2: Доступ к игре2

  • План подписки: $10 за 1 месяц

Пользователь может одновременно оформить две подписки:

  • Подписка 1: Доступ к игре1 за $10 в месяц
  • Подписка 2: Доступ к игре2 за $10 в месяц

Note
Если продукт подписки не настроен, пользователь может оформить только одну подписку одновременно. Чтобы у пользователя появилась возможность оформить несколько подписок одновременно, необходимо настроить продукты.
Группа планов
Набор планов, которые имеют одинаковое значение параметра group_id. Создание группы планов необходимо, если вы хотите:
  • ограничить количество планов, которые можно выбрать для подписки на продукт;
  • дать возможность пользователю перейти на другой план из группы.
Вы можете не создавать группы, если в вашем проекте:
  • нет созданных продуктов;
  • несколько созданных продуктов и подписка на каждый из продуктов может продаваться с любым планов проекта.
Особенности:
  • Один план может входить только в одну группу.
  • Одна группа может участвовать в создании множества продуктов.
  • Один продукт может быть создан на основе только одной группы.
  • По умолчанию планы создаются с параметром group_id: null и входят в общую группу.
Пробный (триальный) период
Период, в течение которого пользователь может опробовать подписку, не оплачивая ее. Особенности:
  • При покупке подписки с пробным периодом создается платежный аккаунт и выполняется авторизационный платеж — со счета клиента списывается небольшая сумма, после чего происходит возврат средств. При списании платежа оповещение о совершенном платеже не отправляется на указанный URL.
  • После окончания пробного периода списывается полная стоимость плана подписки, при этом на указанный URL отправляются оповещения о платеже и продлении подписки или об отмене, если оплата подписки не удалась. Пробный период не входит в период действия плана и его длительность считается отдельно.
  • Пробный период может быть добавлен в качестве бонуса в промоакцию.
  • Льготный (грейс) период
    Период отсрочки платежа по подписке. В течение этого периода пользователи, не оплатившие вовремя подписку, могут продолжать пользоваться услугами. Особенности:
    • Льготный период предусмотрен только для подписок с единоразовым платежом. Для автопродлеваемых подписок средства списываются автоматически.
    • Длительность льготного периода можно изменять в настройках плана подписки в Личном Кабинете Иксолла. Система уведомляет пользователя о необходимости произвести оплату в момент активации льготного периода и каждый последующий день действия льготного периода.
    • При оплате пользователем подписки во время действия льготного периода, оплата производится за полный платежный период. Количество дней, которое пользователь находился в льготном периоде, вычитается из общего числа доступных пользователю дней, так как они считаются использованными.
    • Если в настройке плана в поле Льготный период установлено значение 0, такой план не имеет льготного периода.
    Период попыток списания (ретрай период)
    Период, в течение которого совершаются попытки списания средств с сохраненного платежного аккаунта. Настраивается только для подписок с автоматическим типом продления и активируется при неудачном автоматическом списании. Особенности:
    • Попытки списания средств осуществляются с сохраненного платежного аккаунта раз в сутки.
    • Попытки списания продолжаются до тех пор, пока подписка не будет продлена, отменена пользователем или отменена в связи с окончанием количества попыток.
    • При активации настройки доступ к услугам сохраняется, пока попытки не будут истрачены.
    • При продлении подписки пользователем до окончания количества попыток списания, дни, в течение которых пользователю сохранялся доступ к сервису партнера без фактической оплаты, вычитаются из общего числа доступных пользователю дней, так как они считаются использованными.
    Автоматический платеж
    Тип продления подписки, при котором списания происходят автоматически с сохраненного платежного аккаунта. Участие пользователя при этом не требуется. Если платежный аккаунт не сохранен, подписка с автоматическим типом платежей переходит в статус Non renewing.
    Единовременный платеж
    Тип продления подписки, при котором списания осуществляются пользователем через ссылку на оплату, полученную по электронной почте. Используется, если пользователь выбирает способ оплаты, не поддерживающий автоматические платежи.

    Статусы подписок

    Подписка может находиться в одном из следующих статусов:

    • Active. Основной статус подписки. Подписка создается и активируется после первого успешного платежа. Повторные списания средств осуществляются только у активных подписок.

    Notice
    Подписку нельзя создать вручную, через API. Она создается только автоматически при совершении покупки.

    • Canceled. Подписка отменена. При переходе в статус Canceled подписка перестает действовать немедленно. Возможные причины отмены:
      • Изменился статус подписки через вызов API метода или настройки в Личном кабинете Иксолла.
      • Пользователь отменил подписку.
      • Закончился срок действия подписки (если был задан параметр expiration date).
      • Превышено максимальное количество попыток списания средств при продлении подписки (значение по умолчанию — 3, может быть изменено через обращение к аккаунт-менеджеру проекта).
      • Пользователь, у которого была данная подписка, не был найден при проверке существования пользователя в игре.
      • Платежный аккаунт пользователя, к которому привязана данная подписка, был удален.

    Note
    Отмена подписки может осуществляться с возвратом последнего платежа. Данная опция доступна и для партнера, и для пользователя.

    • Non renewing. Продление подписки отменено. Подписка будет действовать до окончания текущего платежного цикла и затем перейдет в статус Canceled. Возможные причины отмены продления:
      • Изменился статус подписки через вызов API метода или настройки в Личном кабинете Иксолла.
      • Пользователь отменил продление по ссылке в письме.
      • Платежный аккаунт пользователя, к которому привязана данная подписка, был удален.

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

    В другой раз

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

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

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

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

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