Обзор

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

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

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

Основное


Базовый адрес	`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. Ключ в коде мини-аппа достанется любому, кто его откроет, вместе со всеми вашими клиентами.

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

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

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

В ответе — название вашего сервиса и наценка. 401 UNAUTHORIZED — ключ не принят.

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

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.

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

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

Уведомления об оплате и об окончании срока на ваш адрес (вебхуки) появятся позже. Пока статус счёта и клиента узнаётся запросом GET.

Дальше

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

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

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

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

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

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

Порядок запуска

От ключа до первых продаж

Начало

Справочник API

Как это работает

Подключение

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

Основное

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

Дальше

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

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

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

Порядок запуска

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

​Основное

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

​Дальше

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

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

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

Порядок запуска

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

Основное

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

Дальше