1
Название сервиса и ключ
Задайте название своего сервиса в кабинете партнёра — оно встаёт в документы клиента и в подписку. Затем напишите менеджеру в Telegram: платформа включит доступ к API и выдаст ключ
vgo_live_…. Нужен пробный период для клиентов — скажите об этом сразу.2
Проверка ключа
GET /account — в ответе название вашего сервиса, наценка и trial_enabled.3
Витрина
Тарифы —
GET /plans, способы оплаты — GET /payment-methods, документы — GET /documents. Ссылки на документы покажите рядом с кнопкой оплаты.4
Первая покупка — на себя
Выставьте счёт своему
client_id (POST /payments с Idempotency-Key), оплатите его и дождитесь succeeded в GET /payments/{payment_id}. Тестового режима нет — это настоящая оплата и настоящий доступ.5
Экран подключения
Из
client.subscription.connect соберите кнопку «Открыть в приложении» и QR-код, ссылки на установку возьмите из GET /apps. Подключитесь сами с телефона и компьютера.6
Обслуживание
Карточка клиента —
GET /clients/{client_id}, устройства — GET …/devices и DELETE …/devices/{device_id}, новая ссылка — POST …/rotate-link. Продление — тот же POST /payments на того же клиента.7
Запуск
Проверьте, что ключ живёт только на сервере, повторы
POST /payments идут с тем же Idempotency-Key, а незнакомые поля и коды ошибок не ломают интеграцию.Помощь
Вопросы по интеграции, выдача и замена ключа, включение пробного периода — менеджеру в Telegram. В обращении укажите метод и путь запроса, время (UTC) иcode из ответа.
Сайт платформы — vargopartners.com. Подключение партнёра — в боте @vargo_robot, кабинет — admin.vargopartners.com. Условия работы — оферта, правила использования, политика конфиденциальности и согласие на обработку данных.
VARGO · ИП · ОГРНИП 324774600437734 · ИНН 772670322402
Скоро
Уведомления на ваш адрес (вебхуки) об оплате счёта и об окончании срока подписки. До их появления состояние счёта и клиента узнаётся запросомGET.