Приём платежей через lava.top

lava.top принимает карты, СБП и PayPal в рублях, долларах и евро. Через неё клиенты пополняют баланс в кабинете на вашей витрине, а тарифы покупают с баланса: выдавать доступ руками не нужно.

У lava.top фиксированные суммы: клиент выбирает одну из сумм пополнения, которые вы заведёте, и у каждой суммы свой оффер с той же ценой. Ввести свою сумму клиент не может. Если нужна любая сумма, подключите ещё и PayHot.

Деньги идут на ваш аккаунт lava.top. CreateYourVPN не посредник в платежах и комиссию с ваших продаж не берёт.

Что понадобится

• аккаунт на lava.top (аккаунт автора, то есть тот, что продаёт);
• 10–15 минут на первичную настройку;
• небольшая сумма на тестовое пополнение: тестовой среды у lava.top нет, и проверить настройку целиком можно только реальной оплатой (минимум 50 ₽ / 5 $ / 5 €).

Шаг 1. Регистрация и верификация

Зарегистрируйтесь на lava.top и заполните профиль: с пустым профилем страница оплаты выглядит для покупателя недоделанной.

Затем зайдите в Баланс → пройти верификацию: документ и селфи, 18+, без включённого VPN.

Шаг 2. Заведите продукты

Цена оффера в lava.top и есть сумма пополнения. Заведите столько офферов, сколько сумм хотите предложить клиентам.

• Разовое пополнение: цифровой продукт, курс или консультация с фиксированной ценой. Один оффер даёт одну сумму, например 300, 500 или 1000 ₽.
• Автопополнение: продукт типа «Подписка». lava.top сама списывает цену оффера по его графику (каждый месяц, раз в 3 месяца, раз в полгода или раз в год), и каждое списание пополняет баланс клиента.
• У оффера должна быть цена в валюте кабинета клиентов. Валюта видна в разделе «Монетизация», в карточке «Баланс клиентов». lava.top принимает рубли, доллары и евро.
• Скройте продукты со своей публичной страницы lava.top с помощью настройки видимости. Не включайте «Цену по запросу через API»: CreateYourVPN работает с офферами с фиксированной ценой. Покупка прямо со страницы lava.top приходит без нашей метки, и мы не узнаем, чей это платёж. Скрытые продукты с фиксированной ценой останутся доступны в кабинете.

Шаг 3. Подключите аккаунт в CreateYourVPN

Всё, что нужно на стороне lava.top, лежит в одном месте: пункт «Интеграции» в левом меню, карточка API.

Создайте API-ключ

Откройте карточку API и нажмите «Создать API-ключ». Ключ показывается один раз, поэтому скопируйте его сразу: второй раз lava.top его не покажет, а потерянный ключ можно только заменить новым.

Вставьте ключ в кабинете

В CreateYourVPN откройте раздел «Монетизация», нажмите «Подключить» на карточке lava.top, вставьте ключ в поле «API-ключ lava.top» и сохраните.

Мы сразу проверим ключ и ответим либо «Ключ принят» с числом найденных в аккаунте продуктов, либо «lava.top не приняла этот ключ».

Сразу после сохранения в этой же форме появятся ещё два значения: Webhook URL и ключ вебхука. Их вы вставите в lava.top на следующем шаге. Ключ вебхука генерируем мы, придумывать ничего не нужно.

Заведите вебхук

lava.top предложит это сразу после создания ключа: нажмите «+ Добавить Webhook». Та же кнопка есть и потом, на странице API.

Вебхук нужен один: в поле «Тип события» отмечаются сразу все события.

lava.top не добавляет криптографическую подпись тела запроса, поэтому доставку подтверждает ключ вебхука. Относитесь к нему как к паролю.

Что даёт нам API-ключ

Ключей «только для чтения» у lava.top нет: API-ключ даёт полный доступ к аккаунту автора. Мы используем его ровно для трёх вещей: создать оплату в момент, когда клиент нажал «Оплатить»; прочитать ваш каталог продуктов, чтобы вы выбрали офферы в кабинете; отменить подписку, когда клиент отключает автопополнение или автопродление в кабинете. Цены мы не меняем, выгрузку продаж не трогаем, ничего другого этим ключом не делаем. Ключ хранится зашифрованным, больше нигде не показывается и не попадает в наши логи. Если захотите отрезать доступ, удалите подключение в кабинете: ключ удалится вместе с ним.

Шаг 4. Добавьте суммы пополнения

Откройте «Тарифы» и найдите блок «Пополнение баланса».

Пока сумм нет и не подключён PayHot, клиентам нечем пополнить баланс: в окне «Пополнить баланс» они увидят «Пополнение пока недоступно». Заведите хотя бы одну сумму не меньше цены вашего самого дорогого тарифа: тогда клиент с пустым балансом пополнит его и купит тариф одной оплатой, кнопкой «Пополнить и купить».

В самом тарифе оффер не выбирают: тариф в валюте кабинета клиент покупает с баланса. Исключение: тариф с ценой в другой валюте, привязанный к офферу раньше, клиент оплачивает через lava.top напрямую.

Что увидит клиент

В кабинете на витрине клиент нажимает «Пополнить». На вкладке «Разово» он выбирает одну из ваших сумм и способ оплаты: карту, СБП (только рубли) или PayPal, если у оффера есть цена в долларах или евро. На вкладке «Автоматически» он подключает автопополнение: картой или через PayPal, СБП у подписок lava.top нет. На баланс всегда поступает сумма пополнения в валюте кабинета, даже если клиент заплатил в другой валюте.

Автопополнению нужен тариф-подписка со сроком и ценой в валюте кабинета: без него вкладки «Автоматически» у клиента нет. Автопополнение работает вместе с автопродлением тарифа с баланса: при подключении автопродление включится само, а если тарифа у клиента ещё нет, первое списание его купит. Автопополнение у клиента одно.

Шаг 5. Проверьте реальным платежом

Из клиентского аккаунта на своей витрине пополните баланс на самую маленькую сумму. В течение минуты деньги должны появиться на балансе, а в разделе «Монетизация», в «Журнале платежей», должно появиться пополнение баланса со статусом «Обработано». Потом купите с баланса тариф.

Если этого не произошло:

• события в журнале нет вообще: вебхук в lava.top смотрит не на тот адрес, в нём отмечены не все события либо ключ вебхука не совпадает с тем, что в кабинете. В lava.top есть история вебхуков с кнопкой переотправки, начните с неё;
• событие есть, но деньги не на балансе: у события будет пометка «Не зачислено на баланс» с подсказкой. Проверьте оплату в lava.top и зачислите сумму корректировкой в карточке клиента;
• «Без привязки»: мы не поняли, чей это платёж. Так бывает, если клиент купил продукт прямо на странице lava.top в обход витрины. Найдите клиента и зачислите сумму корректировкой в его карточке;
• «Требует внимания»: по событию нужно ваше решение, что сделать, написано у самого события.

Про деньги

• Комиссия lava.top: 8 % с каждой успешной оплаты. Списывается сразу и при возврате клиенту не возвращается.
• Возврат делается из кабинета 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, создайте новый и вставьте в кабинет.