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

Сколько стоит продление

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

Цена продления без списания: столько спишут renew (без days) или renew-custom (с days) прямо сейчас. Передайте её в max_charge_minor, чтобы продление не прошло дороже показанного покупателю.

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

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

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

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

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

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

Сколько дней (от 3 до 1095). Не задано: полный период тарифа.

Поля ответа

successboolean

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

subscription_iduuid

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

daysinteger

Сколько дней добавит продление.

end_date_afterstring

Каким станет end_date после продления, если оплатить сейчас.

charge_minorinteger

Сколько спишется с депозита, в центах. Годится для max_charge_minor.

charge_usdstring

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

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

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

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

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

409unsupported_for_product: Это действие не подходит к этому виду подписки; subscription_frozen: Подписка заморожена; trial_not_renewable: Пробную подписку нельзя продлить

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

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

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

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

API-ключ

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

subscription_id*days

curl https://api.relayhub.surf/api/v1/vpn/subscriptions/<subscription_id>/renew-quote?days=45 \
  -H "Authorization: Bearer <YOUR_API_KEY>"

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

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

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

{
  "success": true,
  "subscription_id": "01a06315-1270-705a-8d4c-58fea607bf2c",
  "days": 45,
  "end_date_after": "2026-11-16T12:00:00Z",
  "charge_minor": 450,
  "charge_usd": "4.50"
}