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

Як 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 · Повідомити про проблему на цій сторінці