Перейти к содержанию

Жизненный цикл подписки

Как MEGOGO хранит подписки, которые вы подключаете: режимы продления, состояния подписки и ограничения.

Кто выставляет счета абоненту

Счета абоненту выставляете вы, и цену определяете тоже вы. MEGOGO не взимает с абонента плату за вашу подписку.

Ваша подписка отображается в профиле MEGOGO абонента вместе с другими его услугами, например подписками, которые он купил в MEGOGO напрямую. Абонент не может отключить или продлить вашу подписку в MEGOGO. Это можете сделать только вы через API.

Режимы продления

Режим продления каждой услуги вы согласовываете с MEGOGO. MEGOGO настраивает его в ID услуги.

Режим Что делаете вы Новый subscribe для активной подписки
Автоматическое продление Отправляете subscribe, когда абонент покупает, и unsubscribe, когда отказывается Обычно код 2023: подписка уже активна. Ничего делать не нужно
Продление партнером Отправляете subscribe за каждый новый оплаченный период Добавляет один период после текущей даты окончания

При автоматическом продлении MEGOGO продлевает подписку перед концом каждого периода, пока вы не отправите unsubscribe.

ПРИМЕЧАНИЕ

Код 2023 — следствие настройки услуги на стороне MEGOGO: новый subscribe не может продлить активную подписку. Обычно MEGOGO включает эту настройку для услуг с автоматическим продлением. Режим продления и эту настройку каждого ID услуги уточняйте у менеджера MEGOGO.

Обычно период составляет 30 дней. Период и режим каждого ID услуги уточняйте у менеджера MEGOGO.

Состояния подписки

stateDiagram-v2
    [*] --> Active: subscribe
    Active --> Active: subscribe (продление партнером)
    Active --> Suspended: suspend
    Suspended --> Active: resume
    Active --> Stopped: unsubscribe
    Suspended --> Stopped: unsubscribe
    Active --> Stopped: дата окончания (без продления)
    Stopped --> Active: subscribe
Состояние Доступ В user/subscriptions Дата окончания
Активна (Active) Да Да dateFinish
Приостановлена (Suspended) Нет Нет Остаток времени сохраняется. После resume дата окончания сдвигается на время приостановки
Отключена (Stopped) Нет Нет —

Правила приостановки и возобновления

  • Отправляйте resume только после собственного suspend. Если приостановленной подписки нет, resume работает как subscribe: добавляет период к активной подписке или подключает новую.
  • Не отправляйте subscribe, пока подписка приостановлена: будет создана новая подписка, а приостановленный остаток не вернется.
  • unsubscribe отключает и приостановленную подписку. Остаток времени теряется.

Для большинства интеграций достаточно subscribe и unsubscribe. suspend и resume нужны, только если абонент должен сохранить остаток времени, например когда вы блокируете доступ к интернету за долг.

Два ID услуг одной подписки

Два ваших ID услуг могут давать одну и ту же подписку MEGOGO, например «Легкая, 1 месяц» и «Легкая, 12 месяцев». Если у абонента есть оба:

  • MEGOGO хранит для абонента одну подписку;
  • user/subscriptions показывает один элемент с ID услуги последнего subscribe;
  • unsubscribe с другим ID услуги возвращает "successful": true, но подписка не отключается.

ОСТОРОЖНО

Отправляйте unsubscribe с тем ID услуги, который user/subscriptions показывает для абонента.

Ограничения

  • Дата окончания подписки не может быть дальше 15 лет от текущего момента. subscribe, который выходит за эту границу, дает код 2023.
  • unsubscribe и suspend возвращают "successful": true, даже если подписка не активна. Состояние проверяйте через user/subscriptions.

Сверка

Источник истины по подпискам ваших абонентов — ваш биллинг. Регулярно сверяйте его с MEGOGO:

flowchart TD
    A[Абонент с изменением подписки] --> B[user/subscriptions]
    B --> C{Активна в MEGOGO?}
    C -- Да --> D{Активна в вашем биллинге?}
    C -- Нет --> E{Активна в вашем биллинге?}
    D -- Да --> OK[Ничего не делать]
    D -- Нет --> U[unsubscribe]
    E -- Да --> S[subscribe]
    E -- Нет --> OK
  1. Для каждого абонента с изменением подписки получите user/subscriptions.
  2. Если подписка активна в MEGOGO, но не в вашем биллинге, отправьте unsubscribe.
  3. Если подписка активна в вашем биллинге, но не в MEGOGO, отправьте subscribe.

Версия руководства 1.0.2, 2026-11-08 · Сообщить о проблеме на этой странице