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

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

Учетная запись пользователя¶

MEGOGO идентифицирует пользователя по номеру телефона: один номер — один пользователь MEGOGO.
Если пользователя с таким номером нет, subscribe его создает. subscriptions с номером телефона тоже создает пользователя. Если нужно только проверить номер, сначала отправьте user/phone.
Пользователь входит в MEGOGO по номеру телефона и одноразовому коду, который MEGOGO отправляет в SMS или Viber.
Когда вы подключаете или отключаете подписку, MEGOGO не отправляет пользователю сообщений. Сообщите ему сами. См. Подключение подписки.
Ваша подписка отображается в профиле пользователя рядом с другими его услугами, например подписками, купленными непосредственно в MEGOGO.
Отменить или продлить вашу подписку в MEGOGO пользователь не может. Это можете сделать только вы через API.

Кто списывает оплату¶

Оплату с пользователя списываете вы, и цену устанавливаете тоже вы. MEGOGO не берет с пользователя деньги за вашу подписку. Поля price и tryAndBuy в ответах — это данные MEGOGO, не используйте их.

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

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

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

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

ПРИМЕЧАНИЕ

Если период длинный, в профиле пользователя видна дата окончания далеко в будущем, и пользователь может решить, что подписка оплачена на все это время. Объясните ему, что подписка действует, пока он платит вам.

Режим каждого 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

Состояние	Доступ	В `subscriptions`	Дата окончания
Активна (Active)	Да	Да	`dateFinish`
Приостановлена (Suspended)	Нет	Нет	Остаток времени сохраняется. После `resume` дата окончания сдвигается на время приостановки
Отключена (Stopped)	Нет	Нет	—

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

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

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

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

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

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

ОСТОРОЖНО

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

Ограничения¶

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

Сверка¶

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

Для каждого пользователя, у которого изменилась подписка, получите subscriptions по номеру телефона.
Если подписка активна в MEGOGO, но не в вашем биллинге, отправьте unsubscribe.
Если подписка активна в вашем биллинге, но не в MEGOGO, отправьте subscribe.

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