Обзор - VARGO Partner API

API даёт всё, что нужно для продажи VPN под вашим брендом. Во что это завернуть — бот, приложение, сайт или ваш собственный продукт — решаете вы. Всё, что клиент видит в своём кабинете, API отдаёт готовым: тарифы и оплату, статус подписки и срок, подключение, устройства. Серверы, выдача доступа и приём оплаты остаются на платформе. Экраны и общение с клиентом — у вас.

Что показать клиенту

Экран	Откуда взять
Тарифы и цены	`GET /plans`
Оплата подписки или продления	`POST /payments` → ссылка `payment_url`
Подписка: активна ли, до какого числа, сколько дней осталось	`GET /clients/{client_id}` → `subscription.status`, `expires_at`, `days_left`
Подключение: кнопка «Открыть в приложении» и QR-код	тот же ответ → `subscription.connect`
Устройства: сколько подключено из скольких, список с платформой и моделью	`GET /clients/{client_id}/devices` → `devices_count`, `devices_limit`, `devices`
Удалить устройство	`DELETE /clients/{client_id}/devices/{device_id}`
Докупить устройства	`POST /payments` с `purpose: devices`
Пробный период, если он у вас включён	`POST /clients/{client_id}/trial`
Перевыпустить ссылку подписки — старая сразу перестаёт работать	`POST /clients/{client_id}/rotate-link`
Где скачать VPN-приложение	`GET /apps`
Соглашение и политика для клиента	`GET /documents`

Как устроены деньги

Клиент платит платформе на странице оплаты по ссылке из счёта. Цена для клиента — цена платформы плюс ваша наценка; после оплаты наценка ложится на ваш баланс партнёра. Подробно — Тарифы и деньги.

Основное


Базовый адрес	`https://api.vargopartners.com/api/partner/v1`
Формат	REST, JSON, UTF-8
Ключ	`Authorization: Bearer vgo_live_…` на каждом запросе
Деньги	строки в рублях: `"150.00"`, рядом `currency: "RUB"`
Даты	ISO-8601, UTC
Ошибки	`{"error": {"code", "message", "fields"}}` — ветвиться по `code`
Язык текстов	заголовок `Accept-Language`: `ru` или `en`, без заголовка — `en`
События	вебхуки на ваш сервер: оплата, истёкший счёт, конец подписки

Ключ живёт только на вашем сервере. Мини-апп и сайт ходят к вашему серверу, ваш сервер — к API. Ключ в коде мини-аппа достанется любому, кто его откроет, вместе со всеми вашими клиентами.

Быстрый старт

Выпустите ключ

В кабинете партнёра откройте раздел «API» и нажмите «Выпустить ключ». Значение vgo_live_… показывается один раз — сразу сохраните его на своём сервере. Подробно — Начало работы.

Проверьте ключ

curl https://api.vargopartners.com/api/partner/v1/account \
  -H "Authorization: Bearer vgo_live_…"

В ответе — название вашего сервиса, наценка и ссылка поддержки. 401 UNAUTHORIZED — ключ не принят. Наценка, пока её не задали, равна 0 — задайте её запросом PATCH /account до первой продажи, иначе продажа идёт по цене платформы без вашего заработка.

Возьмите тарифы и способы оплаты

curl https://api.vargopartners.com/api/partner/v1/plans \
  -H "Authorization: Bearer vgo_live_…" \
  -H "Accept-Language: ru"

curl https://api.vargopartners.com/api/partner/v1/payment-methods \
  -H "Authorization: Bearer vgo_live_…" \
  -H "Accept-Language: ru"

Покажите клиенту price тарифа как есть — пересчитывать сумму у себя не нужно.

Выставьте счёт

curl -X POST https://api.vargopartners.com/api/partner/v1/payments \
  -H "Authorization: Bearer vgo_live_…" \
  -H "Idempotency-Key: order-1001" \
  -H "Content-Type: application/json" \
  -d '{"client_id": "user-42", "purpose": "subscription", "plan_id": 3, "method": "sbp", "return_url": "https://example.com/thanks"}'

Клиента user-42 ещё нет — он заведётся этим счётом. Ответ 201:

{
  "payment_id": "5b0c9d0e-7c1a-4f3e-9b8e-2a6d1c0f4e21",
  "status": "pending",
  "purpose": "subscription",
  "client_id": "user-42",
  "plan_id": 3,
  "devices": null,
  "method": "sbp",
  "amount": "150.00",
  "platform_amount": "100.00",
  "partner_share": "50.00",
  "currency": "RUB",
  "payment_url": "https://…",
  "created_at": "2026-09-25T12:00:00Z",
  "expires_at": "2026-09-25T12:30:00Z",
  "paid_at": null,
  "client": null,
  "replayed": false
}

Отдайте клиенту payment_url.

Дождитесь оплаты

Пока клиент на странице оплаты, опрашивайте счёт:

curl https://api.vargopartners.com/api/partner/v1/payments/5b0c9d0e-7c1a-4f3e-9b8e-2a6d1c0f4e21 \
  -H "Authorization: Bearer vgo_live_…"

Когда status станет succeeded, в поле client придёт клиент со ссылкой подписки subscription.subscription_url и готовыми ссылками подключения subscription.connect.Чтобы не опрашивать, подключите вебхуки: событие payment.succeeded придёт на ваш сервер само.

Подключите клиента

Покажите кнопку «Открыть в приложении» (connect[].connect_url) или QR-код (connect[].qr_payload). Ссылки на установку приложений — GET /apps. Подробно — Клиент и подключение.

Дальше

Начало работы

Ключ, id клиента, повтор запроса, язык ответов

Все эндпоинты

Что умеет API — одной таблицей

Клиент и подключение

Подписка, экран подключения, устройства

Вебхуки

События об оплате и сроке подписки

Ошибки и лимиты

Коды ошибок, лимиты, версии

Перед запуском

Что проверить до первых клиентов

​Что показать клиенту

​Как устроены деньги

​Основное

​Быстрый старт

​Дальше

Начало работы

Все эндпоинты

Клиент и подключение

Вебхуки

Ошибки и лимиты

Перед запуском

Что показать клиенту

Как устроены деньги

Основное

Быстрый старт

Дальше