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

На цій сторінці описано, у яких станах можуть бути послуги користувача в білінгу MEGOGO — передплати (SVOD), оренди (TVOD) і купівлі (DTO), — та як підтримувати однаковий стан у вашій системі й у MEGOGO.

Головна система — ваша: ви продаєте послуги й списуєте оплату з користувачів, а MEGOGO лише реєструє послуги, які ви надсилаєте. Billing API не надсилає сповіщень у вашу систему.

Передплата (SVOD)¶

stateDiagram-v2
    state "Активна" as Active
    state "Призупинена" as Suspended
    state "Завершена" as Ended
    [*] --> Active: subscribe
    Active --> Active: subscribe (продовження партнером, +1 період)
    Active --> Suspended: suspend
    Suspended --> Active: resume
    Active --> Ended: unsubscribe
    Suspended --> Ended: unsubscribe
    Active --> Ended: дата завершення (продовження партнером)
    Ended --> Active: subscribe

Стан	У `user/subscriptions`	Користувач може дивитися
Активна	Так, у `svod`, з `dateFinish`	Так
Призупинена	Ні	Ні. Оплачений час зберігається до `resume`
Завершена	Ні	Ні

Те, як передплата залишається активною, залежить від режиму продовження послуги:

Режим	Що підтримує передплату активною
Автоматичне продовження	MEGOGO продовжує передплату на кожен наступний період, доки ви не надішлете `unsubscribe`
Продовження партнером	Кожен `subscribe` додає один період. Якщо нового `subscribe` не буде, передплата завершиться в момент `dateFinish`

Запити описано в розділі Продаж передплати.

ПРИМІТКА

У user/subscriptions призупинена й завершена передплати виглядають однаково: передплати у відповіді немає. Тому стан «призупинена» зберігайте у своїй системі.

Оренда (TVOD)¶

stateDiagram-v2
    state "Перегляд не почато" as Unwatched
    state "Перегляд почато" as Started
    [*] --> Unwatched: buyMovie
    Unwatched --> Started: перший /stream із src
    Started --> [*]: dateFinish

Стан	`status` у `user/subscriptions`	`dateFinish`
Перегляд не почато	`unwatched`	Немає
Перегляд почато	`started`	Кінець періоду оренди

Період оренди відлічується не з моменту купівлі, а з першої відповіді /stream, що містить src. Див. Продаж окремого відео.

Купівля (DTO)¶

buyMovie з тарифом DTO відкриває користувачеві доступ на період тарифу, наприклад на 3 650 днів. Купівля з'являється в масиві dto відповіді user/subscriptions без полів status і dateFinish.

Скасування купівлі¶

У Billing API немає запиту, який скасовує оренду або купівлю (buyMovie). Якщо вам потрібно повернути користувачеві гроші, зверніться до свого менеджера MEGOGO.

Звіряння¶

Регулярно звіряйте свої дані з даними MEGOGO — наприклад, раз на день, — а також після кожного запиту, який завершився помилкою або тайм-аутом:

Надішліть user/subscriptions для кожного користувача, який має активну послугу у вашій системі.
Порівняйте послуги та дати завершення.
Усуньте розбіжності:

Ваша система	MEGOGO	Дія
Активна передплата	Немає в `svod`	Якщо у вашій системі передплату призупинено, нічого робити не потрібно. Інакше надішліть `subscribe`
Передплати немає	Є в `svod`	Надішліть `unsubscribe`
Дата завершення	Інше значення `dateFinish`	Беріть `dateFinish` з MEGOGO. Не обчислюйте дату завершення самостійно
Купівля (DTO) або оренда, яка ще не завершилася	Немає в `tvod` чи `dto`	Надішліть `buyMovie` ще раз із тим самим `tariff_id`. Код 400 означає, що купівлю вже зареєстровано

У режимі «продовження партнером» перш ніж надіслати subscribe, переконайтеся, що передплати немає в svod: кожен subscribe додає ще один період.

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