Приймання платежів через lava.top
Покроковий гайд: як підключити lava.top до CreateYourVPN, щоб клієнти поповнювали баланс на вашій вітрині. API-ключ, вебхук, суми поповнення й автопоповнення.
lava.top приймає картки, СБП і PayPal у рублях, доларах та євро. Через нього клієнти поповнюють баланс у кабінеті на вашій вітрині, а тарифи купують з балансу: видавати доступ руками не треба.
У lava.top фіксовані суми: клієнт обирає одну із сум поповнення, які ви заведете, і в кожної суми своя оферта з тією самою ціною. Ввести свою суму клієнт не може. Якщо потрібна будь-яка сума, підключіть ще й PayHot.
Гроші йдуть на ваш акаунт lava.top. CreateYourVPN не є посередником у платежах і комісії з ваших продажів не бере.
Приймання платежів доступне на платному тарифі Max: на ньому вітрина починає продавати, а баланс клієнтів вмикається сам. Про тарифи платформи розказано в уроці про білінг.
Що знадобиться
- акаунт на lava.top (акаунт автора, тобто той, що продає);
- 10–15 хвилин на первинне налаштування;
- невелика сума на тестове поповнення: тестового середовища в lava.top немає, і перевірити налаштування цілком можна лише реальною оплатою (мінімум 50 ₽ / 5 $ / 5 €).
Крок 1. Реєстрація та верифікація
Зареєструйтеся на lava.top і заповніть профіль: із порожнім профілем сторінка оплати виглядає для покупця недоробленою.
Потім зайдіть у Balance → верифікація і пройдіть її: документ і селфі, 18+, без увімкненого VPN.
Продавати можна й до верифікації, а от вивести гроші без неї не вийде. Не відкладайте її до першої виплати.
Крок 2. Заведіть продукти
Ціна оферти в lava.top і є сумою поповнення. Заведіть стільки оферт, скільки сум хочете запропонувати клієнтам.
- Разове поповнення: цифровий продукт, курс або консультація з фіксованою ціною. Одна оферта дає одну суму, наприклад 300, 500 або 1000 ₽.
- Автопоповнення: продукт типу «Підписка». lava.top сам списує ціну оферти за її графіком (щомісяця, раз на 3 місяці, раз на пів року або раз на рік), і кожне списання поповнює баланс клієнта.
- В оферти має бути ціна у валюті кабінету клієнтів. Валюту видно в розділі «Монетизація», у картці «Баланс клієнтів». lava.top приймає рублі, долари та євро.
- Сховайте продукти зі своєї публічної сторінки lava.top за допомогою налаштування видимості. Не вмикайте «Ціну на запит через API»: CreateYourVPN працює з офертами з фіксованою ціною. Покупка просто зі сторінки lava.top приходить без нашої мітки, і ми не дізнаємося, чий це платіж. Приховані продукти з фіксованою ціною залишаться доступними в кабінеті.
Оферта в lava.top: варіант продажу продукту з певною ціною та періодом списання. В одного продукту може бути кілька оферт, потрібну ви оберете в кабінеті для кожної суми.
Крок 3. Підключіть акаунт у CreateYourVPN
Усе, що потрібно на боці lava.top, лежить в одному місці: пункт Integrations у лівому меню, картка API.

Створіть API-ключ
Відкрийте картку API й натисніть «Create API key». Ключ показується один раз, тому скопіюйте його одразу: вдруге lava.top його не покаже, а загублений ключ можна лише замінити новим.

Вставте ключ у кабінеті
У CreateYourVPN відкрийте розділ «Монетизація», натисніть «Підключити» на картці lava.top, вставте ключ у поле «API-ключ lava.top» і збережіть.
Ми одразу перевіримо ключ і відповімо або «Ключ прийнято» з кількістю знайдених в акаунті продуктів, або «lava.top не прийняв цей ключ».
Одразу після збереження в цій самій формі з'являться ще два значення: Webhook URL і ключ вебхука. Їх ви вставите в lava.top на наступному кроці. Ключ вебхука генеруємо ми, вигадувати нічого не треба.
Заведіть вебхук
lava.top запропонує це одразу після створення ключа: натисніть «+ Add Webhook». Та сама кнопка є й потім, на сторінці API.

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

URL: адреса вебхука з вашого кабінету. lava.top приймає лише HTTPS, наша адреса саме така.
Тип події: відмітьте всі події зі списку. Вибір множинний, другий вебхук заводити не потрібно.
Type of authentication for Webhook: оберіть «API key of your service» і вставте в поле «API key» ключ вебхука з кабінету. Basic теж підійде, ми його приймаємо, але це два поля замість одного.
Comment: необов'язковий, для себе. Підпис на кшталт «CreateYourVPN, платежі» допомагає, коли інтеграцій кілька.
lava.top не додає криптографічний підпис тіла запиту, тому доставку підтверджує ключ вебхука. Ставтеся до нього як до пароля.
Не залишайте події невідміченими: без подій про регулярні платежі автопоповнення клієнтів до балансу не дійдуть. Відмітити всі завжди безпечно.
Що дає нам API-ключ
Ключів «лише для читання» в lava.top немає: API-ключ дає повний доступ до акаунта автора. Ми використовуємо його рівно для трьох речей: створити оплату в момент, коли клієнт натиснув «Оплатити»; прочитати ваш каталог продуктів, щоб ви обрали оферти в кабінеті; скасувати підписку, коли клієнт вимикає автопоповнення або автопродовження в кабінеті. Цін ми не змінюємо, вивантаження продажів не чіпаємо, нічого іншого цим ключем не робимо. Ключ зберігається зашифрованим, більше ніде не показується й не потрапляє в наші логи. Якщо захочете відрізати доступ, видаліть підключення в кабінеті: ключ видалиться разом із ним.
Крок 4. Додайте суми поповнення
Відкрийте «Тарифи» і знайдіть блок «Поповнення балансу».
Натисніть «Додати поповнення», у списку «Оферта lava.top» оберіть разову оферту й натисніть «Додати поповнення» у вікні. Сума стане ціною оферти. Так додайте кожну суму, до 20 штук.
Для автопоповнення натисніть «Додати автопоповнення», оберіть підписку lava.top і натисніть «Додати автопоповнення» у вікні. Суму й частоту задає оферта: наприклад, 500 ₽ щомісяця. Кабінет підкаже, на який тариф вистачає такого поповнення.
Перевірте попередження біля рядків, якщо вони з'являться. Кабінет скаже, коли в оферти немає ціни у валюті балансу, коли оферта коштує інакше, ніж сума, і коли оферти більше немає в lava.top.
Щойно завели продукт у lava.top і не бачите його в списку? Натисніть «Оновити список»: каталог кешується на хвилину.
Поки сум немає і не підключено PayHot, клієнтам нічим поповнити баланс: у вікні «Поповнити баланс» вони побачать «Поповнення поки недоступне». Заведіть хоча б одну суму, не меншу за ціну вашого найдорожчого тарифу: тоді клієнт із порожнім балансом поповнить його й купить тариф однією оплатою, кнопкою «Поповнити й купити».
У самому тарифі оферту не обирають: тариф у валюті кабінету клієнт купує з балансу. Виняток: тариф із ціною в іншій валюті, раніше прив'язаний до оферти, клієнт оплачує через lava.top напряму.
Що побачить клієнт
У кабінеті на вітрині клієнт натискає «Поповнити». На вкладці «Разово» він обирає одну з ваших сум і спосіб оплати: картку, СБП (лише рублі) або PayPal, якщо в оферти є ціна в доларах чи євро. На вкладці «Автоматично» він підключає автопоповнення: карткою або через PayPal, СБП у підписок lava.top немає. На баланс завжди надходить сума поповнення у валюті кабінету, навіть якщо клієнт заплатив в іншій валюті.
Автопоповненню потрібен тариф-підписка зі строком і ціною у валюті кабінету: без нього вкладки «Автоматично» в клієнта немає. Автопоповнення працює разом з автопродовженням тарифу з балансу: під час підключення автопродовження ввімкнеться саме, а якщо тарифу в клієнта ще немає, перше списання його купить. Автопоповнення в клієнта одне.
Крок 5. Перевірте реальним платежем
З клієнтського акаунта на своїй вітрині поповніть баланс на найменшу суму. Протягом хвилини гроші мають з'явитися на балансі, а в розділі «Монетизація», у блоці «Журнал платежів», має з'явитися поповнення балансу зі статусом «Оброблено». Потім купіть тариф з балансу.
Якщо цього не сталося:
- події в журналі немає взагалі: вебхук у lava.top дивиться не на ту адресу, у ньому відмічені не всі події або ключ вебхука не збігається з тим, що в кабінеті. У lava.top є історія вебхуків із кнопкою повторного надсилання, почніть із неї;
- подія є, але грошей на балансі немає: у події буде позначка «Не зараховано на баланс» з підказкою. Перевірте оплату в lava.top і зарахуйте суму коригуванням у картці клієнта;
- «Без прив'язки»: ми не зрозуміли, чий це платіж. Так буває, якщо клієнт купив продукт просто на сторінці lava.top в обхід вітрини. Знайдіть клієнта й зарахуйте суму коригуванням у його картці;
- «Потребує уваги»: за подією потрібне ваше рішення, що зробити, написано в самій події.
Якщо списання за підпискою не вдалося, lava.top зробить ще дві спроби, через 8 і 24 години, і надішле повідомлення про невдачу лише після останньої. Клієнт побачить у кабінеті, що останнє списання не пройшло. Гроші, які вже лежать на балансі, залишаються в клієнта.
Про гроші
- Комісія 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, створіть новий і вставте в кабінет.
Як налаштувати власний сервер (режим «Один сервер»)
Покроковий гайд: як підключити свій VPS до CreateYourVPN у режимі «Один сервер» — від оренди сервера до готового особистого VPN за кілька хвилин.
Приймання платежів через PayHot
Покроковий гайд: як підключити PayHot до CreateYourVPN, щоб клієнти поповнювали баланс на будь-яку суму карткою, через СБП або криптовалютою. Заявка, API-ключ, вебхук, способи оплати й автопоповнення.