Продление, приостановка и отключение¶

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

Перед началом¶

Узнайте режим продления каждой услуги. См. Жизненный цикл подписки.
Все запросы на этой странице используют один URL, отличается только операция:

GET https://billing.megogo.net/terminals/{partner_id}/subscription/{operation}?phone={phone}&serviceId={service_id}&sign={sign}

Продление подписки¶

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

ВНИМАНИЕ

В режиме «продление партнером» subscribe не идемпотентен: каждый успешный запрос добавляет еще один период. Перед повторным запросом получите subscriptions для пользователя. См. Повторные запросы.

subscribe можно отправлять и до даты окончания: новый период начнется после текущей даты окончания, а не от текущего момента.

Отключение подписки¶

Отправьте unsubscribe. Доступ прекращается сразу, и после запроса подписки уже нет в subscriptions.

Когда отправлять unsubscribe, решаете вы: в момент отказа пользователя или в конце оплаченного периода.

ОСТОРОЖНО

Используйте тот ID услуги, который subscriptions показывает для пользователя. Если у пользователя два ваших ID услуг одной подписки MEGOGO, unsubscribe с другим ID подписку не отключит. См. Два ID услуг одной подписки.

unsubscribe возвращает "successful": true, даже если подписка не активна. Чтобы убедиться, что подписка отключена, получите subscriptions.

Смена подписки¶

Чтобы сменить подписку пользователя, например с «Легкой» на «Максимальную»:

Отправьте unsubscribe со старым ID услуги.
Отправьте subscribe с новым ID услуги.

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

suspend и resume нужны, если пользователь должен сохранить остаток времени, например на период временной блокировки номера. Если это не нужно, используйте только subscribe и unsubscribe.

Отправьте suspend. Доступ прекращается, подписки нет в subscriptions.
Когда доступ нужно вернуть, отправьте resume. Дата окончания сдвигается на время приостановки.

ВНИМАНИЕ

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

ОСТОРОЖНО

Не отправляйте subscribe, пока подписка приостановлена: будет создана новая подписка, а приостановленный остаток не вернется.

Чтобы отключить приостановленную подписку, отправьте unsubscribe. Остаток времени теряется.

Ошибки¶

Ответ	Причина	Что делать
Код 2023 для `subscribe` или `resume`	Услуга с автоматическим продлением уже активна. Или дата окончания вышла бы дальше чем 15 лет от текущего момента	Ничего делать не нужно
`"message": "Invalid operation passed"`	Операция не `subscribe`, `unsubscribe`, `suspend` или `resume`	Исправьте URL
Таймаут, HTTP 5xx	Временная проблема	См. Повторные запросы

Все ошибки — в Каталоге ошибок.

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