Продажа VPN через API: свой сайт вместо готового бота

Готовый бот и VPN API продают одни и те же подписки по одной закупочной цене. Отличаются витрина, касса и то, кто чинит код, когда что-то ломается.

#Два способа рядом

#Что даёт готовый бот

Бот уже умеет показывать тарифы, принимать оплату, выдавать подписку, продлевать её и напоминать о конце срока. У него есть сайт-витрина, первую страницу которого можно заменить своим HTML. Вы задаёте наценку и оформление, остальное работает без вас.

Границы у этого способа такие: сценарий покупки общий для всех партнёров, оплата идёт через кассы платформы, VPN живёт отдельно от других ваших продуктов.

#Что даёт своя интеграция

API отдаёт выдачу и обслуживание подписки: тарифы, покупку, продление, смену тарифа, устройства, пробный период. Витрину, оплату и учёт пользователей вы пишете сами. Для платформы ваш пользователь это строка external_user_id, больше о нём знать не нужно.

Это нужно в двух случаях. Первый: у вас уже есть продукт со своим личным кабинетом, и VPN должен стать в нём ещё одной строкой. Второй: своя платёжная схема, например юрлицо с кассой или корпоративные счета. Вы принимаете деньги как хотите, а подписку выдаёте запросом после оплаты.

#Деньги: депозит вместо удержания

В боте закупка удерживается с каждой продажи. Через API она списывается с депозита, который вы пополняете заранее. Депозит состоит из двух частей: paid (пополнения) и earned (заработанное на продажах в ботах). Покупка через API списывает сначала первое, потом второе.

curl https://api.relayhub.surf/api/v1/vpn/balance \
  -H "Authorization: Bearer $VPN_API_KEY"

Если денег на депозите не хватает, покупка отбивается кодом insufficient_balance (HTTP 402) до обращения к сети VPN, и подписка не создаётся. Проверяйте остаток до того, как ваш покупатель заплатит: отказ после его оплаты оставит человека без подписки. Наценку API не видит, розничную цену вы держите у себя.

#Сроки и поддержка

Прототип, который выдаёт первую подписку, собирается за вечер вместе с чтением справочника. Рабочая интеграция занимает несколько дней: кроме покупки нужны продление, приём событий, повторы при обрывах сети и понятные тексты на отказы.

Дальше это ваш код. Платформа отвечает за серверы и подписки, но не за вашу витрину. Если поддерживать интеграцию некому, оставайтесь на готовом боте.

#Обычный порядок

Запустить готового бота и посмотреть, покупают ли. Когда поток стабилен и боту не хватает своей кассы или встраивания в ваш продукт, дописать витрину через API. Шаги с запросами собраны в статье про запуск продаж через API.

#Чек-лист

• определить, куда встраивается VPN: в ваш продукт или живёт отдельно
• решить, нужна ли своя касса
• назначить человека, который будет поддерживать интеграцию
• заложить запас на депозите до первой продажи
• начать с бота, если на большинство пунктов ответ «нет»