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

Як надати користувачеві доступ до передплати MEGOGO після того, як він купив її у вас.

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

Переконайтеся, що:

• У вас є ID партнера, ключі та ID послуг ваших передплат. Див. Облікові дані.
• MEGOGO додав IP-адреси ваших серверів до списку вашого ID партнера.
• Ваш код правильно обчислює підпис. Див. Підпис запиту.
• Ви знаєте режим продовження кожної послуги. Див. Життєвий цикл передплати.

Схема

sequenceDiagram
    participant User as Користувач
    participant Server as Ваш сервер
    participant API as MEGOGO Terminals API
    User->>Server: Купує передплату
    Server->>Server: Перевіряє формат номера
    Server->>API: subscription/subscribe (phone, serviceId)
    API-->>Server: "successful": true
    Server->>Server: Списує оплату
    Server-->>User: Повідомлення: як увійти в MEGOGO

Крок 1. Перевірте номер телефону

Номер має складатися лише з цифр у міжнародному форматі: код країни й номер, наприклад 380000000001. На початку допускається +.

ОБЕРЕЖНО

MEGOGO не перевіряє довжину номера. Для помилкового номера буде створено користувача MEGOGO. Перевіряйте номер на своєму боці.

За бажанням: щоб дізнатися, чи є в користувача обліковий запис MEGOGO, надішліть user/phone:

GET https://billing.megogo.net/terminals/{partner_id}/user/phone?phone={phone}&sign={sign}

{"successful": true} означає, що обліковий запис є. Передплата буде додана до нього, поряд з іншими послугами користувача.

Крок 2. Підключіть передплату

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

Параметр	Опис
partner_id	Ваш ID партнера
phone	Номер телефону користувача
serviceId	ID послуги передплати
sign	Підпис. Див. Підпис запиту

Очікувана відповідь:

{"successful": true}

Якщо користувача з таким номером у MEGOGO немає, запит його створить.

Крок 3. Спишіть оплату

Списуйте оплату з користувача лише після "successful": true. За будь-якої іншої відповіді не списуйте. Див. Помилки.

Крок 4. Повідомте користувачеві, як увійти

MEGOGO не надсилає користувачеві повідомлень. Надішліть повідомлення самі, наприклад SMS. Приклад тексту:

Приклад повідомлення

MEGOGO «Легка» підключено. Щоб дивитися, встановіть застосунок MEGOGO або відкрийте megogo.net. Оберіть вхід за номером телефону, введіть цей номер і код з SMS або Viber.

Крок 5. Перевірте передплату

GET https://billing.megogo.net/terminals/{partner_id}/subscriptions?phone={phone}&sign={sign}

Очікувана відповідь (скорочено):

[
  {
    "serviceId": "example_light_30d",
    "serviceName": "Light (partner)",
    "dateFinish": 1796221882,
    "dateFinishString": "2026-12-02 14:31:22"
  }
]

• dateFinish — кінець поточного періоду, Unix-час (секунди). dateFinishString — той самий момент в UTC.
• Не обчислюйте дату закінчення самостійно, беріть її з цієї відповіді.

Помилки

Відповідь	Причина	Що робити
"successful": false, код 2023	Передплата вже активна, а послуга з автоматичним продовженням. Або дата закінчення вийшла б далі ніж 15 років від поточного моменту	Нічого робити не потрібно
"message": "Service is not configured for this partner"	ID послуги не налаштований для вашого ID партнера	Перевірте, що використовуєте ID послуги від менеджера MEGOGO
"message": "General error"	У номері телефону є не лише цифри	Повторіть крок 1
"successful": false, код 40009	Ця передплата не продається через партнерів	Зверніться до свого менеджера MEGOGO
HTTP 401 Not Authorized	Підпис, ключі або IP-адреса	Див. Розв'язання проблем
Таймаут, HTTP 5xx	Тимчасова проблема	Див. Повторні запити

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

Що далі

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

---

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