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

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

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

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

  • Узнайте режим продления каждой услуги. См. Жизненный цикл подписки.
  • Все запросы на этой странице используют один URL, отличается только операция:
GET https://billing.megogo.net/partners/{partner_id}/subscription/{operation}?userId={identifier}&serviceId={service_id}

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

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

ВНИМАНИЕ

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

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

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

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

ОСТОРОЖНО

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

После unsubscribe аккаунт MEGOGO абонента остается. Когда абонент снова купит подписку, отправьте только subscribe.

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

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

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

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

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

sequenceDiagram
    participant Server as Ваш сервер
    participant API as MEGOGO Partner Billing API
    Server->>API: subscription/suspend (userId, serviceId)
    API-->>Server: "successful": true
    Note over API: Доступа нет. Остаток времени сохраняется
    Server->>API: subscription/resume (userId, serviceId)
    API-->>Server: "successful": true
    Note over API: Доступ снова есть. Дата окончания сдвигается вперед
  1. Отправьте suspend. Доступ прекращается, подписки нет в user/subscriptions.
  2. Когда доступ нужно вернуть, отправьте resume. Дата окончания сдвигается на время приостановки.

ВНИМАНИЕ

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

ОСТОРОЖНО

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

Ошибки

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

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

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