Ваш сайт или программа сама выдаёт подписки из нашего VPN. Нужен разработчик.

Сколько стоит апгрейд

GET/api/v1/vpn/subscriptions/{subscription_id}/upgrade-quote

Доплата за переход: полная цена нового тарифа минус неиспользованный остаток текущего. Апгрейд перезапускает срок с текущего момента.

Авторизация и общие правила

Параметры пути

subscription_idобязательно

Идентификатор подписки: subscription.subscription_id из ответа покупки или списка.

Параметры запроса

new_plan_uuidобязательно

Тариф из GET /plans.

Поля ответа

successboolean

true у любого успешного ответа.

subscription_iduuid

Идентификатор подписки.

new_plan_uuiduuid

Тариф, на который переходим.

new_plan_namestring

Его название.

remaining_daysinteger

Сколько дней текущего тарифа засчитано в доплату.

charge_minorinteger

Доплата за переход, в центах: столько спишет upgrade.

charge_usdstring

То же, строкой для показа.

Когда откажет

401unauthorized: Неверный или отсутствующий API-ключ

403api_disabled: Доступ к API для этого аккаунта закрыт; ip_not_allowed: Адрес запроса не входит в список разрешённых

404subscription_not_found: Подписка не найдена; plan_not_found: Тариф не найден или недоступен

409unsupported_for_product: Это действие не подходит к этому виду подписки; subscription_frozen: Подписка заморожена; subscription_expired: Подписка истекла; subscription_state: Операция не подходит к текущему состоянию подписки

422validation_error: Неверные параметры запроса

429rate_limited: Слишком много запросов

503upstream_unavailable: Поставщик VPN временно недоступен

Попробовать запрос

API-ключ

Подставится в примеры и в запрос. Хранится только в этом браузере.

subscription_id*new_plan_uuid*

curl https://api.relayhub.surf/api/v1/vpn/subscriptions/<subscription_id>/upgrade-quote?new_plan_uuid=6ba7b810-9dad-11d1-80b4-00c04fd430c8 \
  -H "Authorization: Bearer <YOUR_API_KEY>"

Вставьте свой ключ, и он подставится вместо <YOUR_API_KEY>.

Вставьте API-ключ

Пример ответа

{
  "success": true,
  "subscription_id": "01a06315-1270-705a-8d4c-58fea607bf2c",
  "new_plan_uuid": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
  "new_plan_name": "Pro 30d",
  "remaining_days": 20,
  "charge_minor": 300,
  "charge_usd": "3.00"
}