Приём платежей через lava.top
Пошаговый гайд: как подключить аккаунт lava.top к CreateYourVPN, чтобы оплата клиента сама превращалась в подписку — API-ключ, вебхук, привязка офферов к тарифам.
lava.top — платёжный провайдер, который принимает карты, СБП и PayPal в рублях, долларах и евро. Подключаете его один раз — и оплата на витрине сама превращается в активную подписку: выдавать доступ руками не нужно.
Деньги идут на ваш аккаунт lava.top. CreateYourVPN не посредник в платежах и комиссию с ваших продаж не берёт.
Приём платежей доступен на платном тарифе Max — на нём на витрине включается режим продаж. Про тарифы платформы — в уроке о биллинге.
Что понадобится
- аккаунт на lava.top (аккаунт автора — тот, что продаёт);
- 10–15 минут на первичную настройку;
- небольшая сумма на тестовую покупку: тестовой среды у lava.top нет, и проверить настройку целиком можно только реальной оплатой (минимум 50 ₽ / 5 $ / 5 €).
Шаг 1. Регистрация и верификация
Зарегистрируйтесь на lava.top и заполните профиль — с пустым профилем страница оплаты выглядит для покупателя недоделанной.
Затем зайдите в Баланс → пройти верификацию: документ и селфи, 18+, без включённого VPN.
Продавать можно и до верификации, а вот вывести деньги без неё нельзя. Не откладывайте её до первой выплаты.
Шаг 2. Заведите продукты
В lava.top создайте один или несколько продуктов для своих тарифов. Каждому тарифу CreateYourVPN нужен подходящий оффер, но у одного продукта lava.top может быть несколько офферов — например, с оплатой за месяц и за год.
- Для регулярного тарифа выберите тип продукта «Подписка» — тогда lava.top будет автоматически списывать оплату, а каждое продление будет продлевать доступ у нас.
- Для разовой покупки используйте цифровой продукт, курс или консультацию с фиксированной ценой.
- Убедитесь, что у оффера есть цена хотя бы в одной поддерживаемой валюте: RUB, USD или EUR. Валюта тарифа будет выбрана на витрине по умолчанию, но покупатель сможет переключиться на любую другую валюту, доступную у оффера.
- Сверьте период списания со сроком тарифа: месячный продукт ↔ 30 дней, 90 дней ↔ 90 и так далее.
- Скройте продукты со своей публичной страницы lava.top с помощью настройки видимости. Не включайте «Цену по запросу через API»: CreateYourVPN сейчас работает с офферами с фиксированной ценой. Покупка прямо со страницы lava.top приходит без нашей метки, поэтому мы можем не определить тариф; такой платёж попадёт в журнал со статусом «Без привязки» и будет ждать ручной привязки. Скрытые продукты с фиксированной ценой останутся доступны в нашем селекторе офферов.
Оффер — это вариант продажи продукта с определённой ценой и периодом списания. У одного продукта может быть несколько офферов — подходящий вариант вы дальше выберете для каждого тарифа.
Что происходит при повторной покупке
У разового продукта продлений не бывает: когда клиенту нужно ещё, он просто покупает заново. Это штатный сценарий, и покупать заранее безопасно — дни прибавляются к остатку, а не отсчитываются заново. Десять оставшихся дней плюс новый месяц дают сорок дней.
Одно исключение, если тариф выдаёт ещё и трафик: квота заменяется, а не складывается. Клиент, купивший 100 ГБ, потративший 30 и купивший тот же тариф снова, получит свежие 100 ГБ, а не 170. Учитывайте это в ценах трафиковых тарифов.
Шаг 3. Подключите аккаунт в CreateYourVPN
Всё, что нужно на стороне lava.top, лежит в одном месте: пункт «Интеграции» в левом меню, карточка API.
Создайте API-ключ
Откройте карточку API и нажмите «Создать API-ключ». Ключ показывается один раз — скопируйте его сразу: второй раз lava.top его не покажет, а потерянный ключ можно только заменить новым.
Вставьте ключ в кабинете
В CreateYourVPN откройте раздел «Монетизация», нажмите «Подключить» на карточке lava.top, вставьте ключ в поле «API-ключ lava.top» и сохраните.
Мы сразу проверим ключ и ответим либо «Ключ принят» — с числом найденных в аккаунте продуктов, — либо «lava.top не приняла этот ключ».
Сразу после сохранения в этой же форме появятся ещё два значения: URL вебхука и ключ вебхука. Их вы вставите в lava.top на следующем шаге. Ключ вебхука генерируем мы — придумывать ничего не нужно.
Заведите вебхук
lava.top предложит это сразу после создания ключа — нажмите «+ Добавить Webhook». Та же кнопка есть и потом, на странице API.
Вебхук нужен один — в поле «Тип события» отмечаются сразу все нужные типы:
URL — адрес вебхука из вашего кабинета. lava.top принимает только HTTPS; наш адрес такой и есть.
Тип события — отметьте оба типа: «Результат платежа» и «Регулярный платёж». Список с множественным выбором, второй вебхук заводить не нужно.
Тип аутентификации для Webhook — выберите «API-ключ вашего сервиса» и вставьте в поле «API key» ключ вебхука из кабинета. (Basic тоже подойдёт — мы его принимаем, — но это два поля вместо одного.)
Комментарий — необязательный, для себя: подпись вроде «CreateYourVPN — платежи» помогает, когда интеграций несколько.
lava.top не добавляет криптографическую подпись тела запроса, поэтому доставку подтверждает ключ вебхука — относитесь к нему как к паролю.
Не снимайте отметку с «Регулярного платежа», если продаёте подписки: без этого типа события продления до нас не дойдут и доступ у платящего клиента закончится. Для разовых продуктов хватает «Результата платежа», но отмеченными можно оставить оба.
Что даёт нам API-ключ
Ключей «только для чтения» у lava.top нет — API-ключ даёт полный доступ к аккаунту автора. Мы используем его ровно для трёх вещей: создать оплату в момент, когда клиент нажал «Оплатить»; прочитать ваш каталог продуктов для селектора офферов; отменить подписку, когда клиент отключает автопродление в кабинете. Цены мы не меняем, выгрузку продаж не трогаем, ничего другого этим ключом не делаем. Ключ хранится зашифрованным, больше нигде не показывается и не попадает в наши логи. Если захотите отрезать доступ — удалите подключение в кабинете, ключ удалится вместе с ним.
Шаг 4. Привяжите офферы к тарифам
Откройте «Тарифы», зайдите в тариф и найдите блок lava.top:
Нажмите «Подтянуть продукты» — мы заберём каталог из вашего аккаунта lava.top.
Выберите оффер, которым продаётся этот тариф. В списке видно продукт, цену и период списания.
Проверьте предупреждения, если они появятся. Кабинет скажет, когда у оффера нет цены в валюте тарифа и когда период списания расходится со сроком тарифа («списывает раз в 30 дн., а тариф выдаёт 365»).
Только что завели продукт в lava.top и не видите его в списке? Нажмите «Обновить список» — каталог кэшируется на минуту.
Покупатель может переключаться между всеми валютами, доступными у выбранного оффера. Для разовой оплаты в рублях мы показываем карту и СБП, для рублёвой подписки — только карту. В долларах и евро доступны карта и PayPal.
Шаг 5. Проверьте реальным платежом
Купите самый дешёвый тариф сами, из клиентского аккаунта на своей витрине. В течение минуты тариф должен появиться в этом аккаунте, а платёж — в журнале со статусом «Обработано» (раздел «Монетизация»).
Если этого не произошло:
- события в журнале нет вообще — вебхук в lava.top смотрит не на тот адрес, в нём не отмечены нужные типы событий либо ключ вебхука не совпадает с тем, что в кабинете. В lava.top есть история вебхуков с кнопкой переотправки — начните с неё;
- событие есть, но «Без привязки» — мы не поняли, чей это платёж и за какой тариф. Привяжите его руками прямо в журнале: подписка выдастся тем же кодом, что и при автоматической оплате;
- «Требует внимания» — по платежу нужно решение человека: клиент заблокирован в кабинете либо тариф уже после создания оплаты переехал на другой продукт lava.top. Сами доступ мы здесь не трогаем — решаете вы.
Если оплату продления списать не удалось, lava.top сделает ещё две попытки — через 8 и 24 часа — и отправит уведомление о неудаче только после последней. Из-за неудачного списания мы не отзываем доступ: уже оплаченный период всегда действует до конца. Уведомление об отмене лишь сообщает, что следующего продления не будет.
Про деньги
- Комиссия lava.top — 8 % с каждой успешной оплаты. Списывается сразу и при возврате клиенту не возвращается.
- Возврат делается из кабинета lava.top, раздел «Продажи»; возврат по подписке отменяет подписку. Отдельного типа вебхука под возвраты и чарджбэки у lava.top пока нет, поэтому видны они в кабинете lava.top, а не в нашем журнале.
- Отмена автопродления. Клиент может отменить его сам в кабинете на вашей витрине — мы попросим lava.top отменить подписку — либо в своём аккаунте lava.top; вы тоже можете отменить её за него из кабинета lava.top. Отмена не отбирает доступ: он действует до конца уже оплаченного периода, а мы просто перестаём ждать следующее списание.
- Чарджбэк можно инициировать в течение 540 дней после оплаты, а на предоставление доказательств у вас 3 дня. Храните условия продажи, переписку с клиентом и подтверждения того, что доступ был предоставлен.
- Лимиты зависят от типа продукта. Минимум всегда составляет 50 ₽ / 5 $ / 5 €. Для подписки максимум — 300 000 ₽ / 3 000 $ / 3 000 €, для разового продукта — 1 000 000 ₽ / 10 000 $ / 10 000 €.
Если ключ утёк
На карточке lava.top две разные кнопки, и делают они разное:
- «Перевыпустить ключ вебхука» — выдаёт новый ключ для входящих уведомлений. Новое значение нужно вставить в вебхук в lava.top; пока не вставите, оплаты не будут подтверждаться.
- «Сменить webhook URL» — выдаёт новый адрес. Старый перестаёт работать сразу, его тоже надо обновить в вебхуке.
Если утёк сам API-ключ — отзовите его в lava.top, создайте новый и вставьте в кабинет.
Как настроить свой сервер (режим «Один сервер»)
Пошаговый гайд: как подключить свой VPS к CreateYourVPN в режиме «Один сервер» — от аренды сервера до готового личного VPN за несколько минут.
Happ
Как установить приложение Happ на телефон или компьютер, что делать, если оно недоступно в вашей стране, и как подключиться по ссылке из личного кабинета.