Перейти до змісту

Продовження, призупинення й відключення

Що робити, коли абонент оплатив наступний період, коли ви тимчасово блокуєте його доступ і коли він відмовляється від передплати або змінює її.

Перед початком

  • Дізнайтеся режим продовження кожної послуги. Див. Життєвий цикл передплати.
  • Усі запити на цій сторінці використовують один 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 · Повідомити про проблему на цій сторінці