Передплати MEGOGO для інтернет-провайдерів¶

Посібник для розробників інтернет-провайдерів та інших партнерів, які продають передплати MEGOGO своїм абонентам. Тут описано, як підключити, продовжити й відключити передплату MEGOGO і як видати абоненту акаунт для входу в MEGOGO.

Як це працює¶

Абонент купує у вас передплату MEGOGO, наприклад як опцію до інтернет-тарифу.
Ваш сервер надсилає subscribe з ідентифікатором абонента у вашому білінгу (наприклад, номером договору) та ID послуги передплати. MEGOGO підключає передплату.
Ваш сервер створює для абонента логін (адресу e-mail) і пароль та передає їх запитом changeCredentials. MEGOGO створює акаунт абонента.
В особистому кабінеті абонента на вашому сайті ви показуєте логін, пароль і кнопку, яка відкриває сторінку входу MEGOGO.
Абонент входить у MEGOGO з цим логіном і паролем: у браузері або в застосунках MEGOGO для Android та iOS.

Рахунки абоненту виставляєте ви. MEGOGO не стягує з абонента плату за вашу передплату.

sequenceDiagram
    participant User as Абонент
    participant Server as Ваш сервер
    participant API as MEGOGO Partner Billing API
    participant Site as MEGOGO
    User->>Server: Купує передплату
    Server->>API: subscription/subscribe (userId, serviceId)
    API-->>Server: "successful": true
    Server->>API: user/changeCredentials (isdn, email, password)
    API-->>Server: "successful": true
    Server-->>User: Логін, пароль і кнопка «Продовжити»
    User->>Site: Входить з логіном і паролем
    Site-->>User: Передплата доступна

API¶

Параметр	Значення
Базовий URL	`https://billing.megogo.net/partners/{partner_id}/`
Методи	`GET`; `POST` для `user/changeCredentials`
Ідентифікація абонента	Ваш ідентифікатор абонента: номер договору, особового рахунку або інший ID у вашому білінгу
Безпека	Список IP-адрес ваших серверів

Запити API:

Запит	Призначення
`subscription/{operation}`	Підключити (`subscribe`), відключити (`unsubscribe`), призупинити (`suspend`) або відновити (`resume`) передплату
`user/subscriptions`	Отримати активні передплати абонента
`user/changeCredentials`	Задати логін і пароль акаунта MEGOGO абонента
`user/innerId`	Отримати ID користувача MEGOGO і поточний логін абонента
`user/create`	Створити користувача MEGOGO для абонента без передплати
`user/changeLogin`	Змінити ідентифікатор абонента

Чого API не робить¶

MEGOGO не надсилає сповіщень на ваш сервер: колбеків і вебхуків немає. Щоб дізнатися стан передплати, надішліть user/subscriptions.
MEGOGO не надсилає абоненту повідомлень про вашу передплату. Як увійти, пояснюєте абоненту ви.
Абонент не може відключити або продовжити вашу передплату в MEGOGO. Змінити її можуть лише ваші запити.
MEGOGO не виставляє абоненту рахунків за вашу передплату. Це робите ви.
Джерело істини — ваш білінг. Регулярно звіряйте його з MEGOGO. Див. Звірка.

З чого почати¶

Облікові дані: що вам дає MEGOGO.
Початок роботи: перші запити.
Абонент і акаунт MEGOGO: ідентифікатори, логіни й паролі.
Підключення передплати і Продовження, призупинення й відключення.
Чек-лист запуску.

Підтримка¶

Облікові дані та ID послуг вам видає менеджер MEGOGO. З технічних питань пишіть на supportpartners@megogo.net. Вкажіть свій ID партнера, час запиту (UTC) і відповідь.

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