Життєвий цикл передплати¶

Як 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

Для кожного абонента зі зміною передплати отримайте user/subscriptions.
Якщо передплата активна в MEGOGO, але не у вашому білінгу, надішліть unsubscribe.
Якщо передплата активна у вашому білінгу, але не в MEGOGO, надішліть subscribe.

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