Подписки 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 · Сообщить о проблеме на этой странице