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

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

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

Дізнайтеся режим продовження кожної послуги. Див. Життєвий цикл передплати.
Усі запити на цій сторінці використовують один URL, відрізняється лише операція:

GET https://billing.megogo.net/terminals/{partner_id}/subscription/{operation}?phone={phone}&serviceId={service_id}&sign={sign}

Продовження передплати¶

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

УВАГА

У режимі «продовження партнером» subscribe не ідемпотентний: кожен успішний запит додає ще один період. Перед повторним запитом отримайте subscriptions для користувача. Див. Повторні запити.

subscribe можна надсилати й до дати закінчення: новий період почнеться після поточної дати закінчення, а не від поточного моменту.

Відключення передплати¶

Надішліть unsubscribe. Доступ припиняється одразу, і після запиту передплати вже немає в subscriptions.

Коли надсилати unsubscribe, вирішуєте ви: у момент відмови користувача або в кінці оплаченого періоду.

ОБЕРЕЖНО

Використовуйте той ID послуги, який subscriptions показує для користувача. Якщо в користувача два ваші ID послуг однієї передплати MEGOGO, unsubscribe з іншим ID передплату не відключить. Див. Два ID послуг однієї передплати.

unsubscribe повертає "successful": true, навіть якщо передплата не активна. Щоб переконатися, що передплату відключено, отримайте subscriptions.

Зміна передплати¶

Щоб змінити передплату користувача, наприклад з «Легкої» на «Максимальну»:

Надішліть unsubscribe зі старим ID послуги.
Надішліть subscribe з новим ID послуги.

Призупинення й відновлення¶

suspend і resume потрібні, якщо користувач має зберегти залишок часу, наприклад на період тимчасового блокування номера. Якщо це не потрібно, використовуйте лише subscribe і unsubscribe.

Надішліть suspend. Доступ припиняється, передплати немає в subscriptions.
Коли доступ потрібно повернути, надішліть resume. Дата закінчення зсувається на час призупинення.

УВАГА

Надсилайте resume лише після власного suspend. Якщо призупиненої передплати немає, resume працює як subscribe: додає період або підключає нову передплату.

ОБЕРЕЖНО

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

Щоб відключити призупинену передплату, надішліть unsubscribe. Залишок часу втрачається.

Помилки¶

Відповідь	Причина	Що робити
Код 2023 для `subscribe` або `resume`	Послуга з автоматичним продовженням уже активна. Або дата закінчення вийшла б далі ніж 15 років від поточного моменту	Нічого робити не потрібно
`"message": "Invalid operation passed"`	Операція не `subscribe`, `unsubscribe`, `suspend` чи `resume`	Виправте URL
Таймаут, HTTP 5xx	Тимчасова проблема	Див. Повторні запити

Усі помилки — у Каталозі помилок.

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