Приймання платежів через lava.top

lava.top — платіжний провайдер, який приймає картки, СБП і PayPal у рублях, доларах та євро. Підключаєте його один раз — і оплата на вітрині сама перетворюється на активну підписку: видавати доступ руками не треба.

Гроші йдуть на ваш акаунт lava.top. CreateYourVPN не є посередником у платежах і комісії з ваших продажів не бере.

Що знадобиться

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

Крок 1. Реєстрація та верифікація

Зареєструйтеся на lava.top і заповніть профіль — із порожнім профілем сторінка оплати виглядає для покупця недоробленою.

Потім зайдіть у Balance → верифікація: документ і селфі, 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, лежить в одному місці: пункт Integrations у лівому меню, картка API.

Створіть API-ключ

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

Вставте ключ у кабінеті

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

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

Одразу після збереження в цій самій формі з'являться ще два значення: URL вебхука і ключ вебхука. Їх ви вставите в lava.top на наступному кроці. Ключ вебхука генеруємо ми — вигадувати нічого не треба.

Заведіть вебхук

lava.top запропонує це одразу після створення ключа — натисніть «+ Add Webhook». Та сама кнопка є й потім, на сторінці API.

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

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

Що дає нам API-ключ

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

Крок 4. Прив'яжіть офери до тарифів

Відкрийте «Тарифи», зайдіть у тариф і знайдіть блок lava.top:

Покупець може перемикатися між усіма валютами, доступними у вибраному офері. Для разової оплати в рублях ми показуємо картку і СБП, для рублевої підписки — лише картку. У доларах і євро доступні картка і PayPal.

Крок 5. Перевірте реальним платежем

Купіть найдешевший тариф самі, з клієнтського акаунта на своїй вітрині. Протягом хвилини тариф має з'явитися в цьому акаунті, а платіж — у журналі зі статусом «Оброблено» (розділ «Монетизація»).

Якщо цього не сталося:

• події в журналі немає взагалі — вебхук у lava.top дивиться не на ту адресу, у ньому не позначені потрібні типи подій або ключ вебхука не збігається з тим, що в кабінеті. У lava.top є історія вебхуків із кнопкою повторного надсилання — почніть із неї;
• подія є, але «Без прив'язки» — ми не зрозуміли, чий це платіж і за який тариф. Прив'яжіть його руками просто в журналі: підписка видасться тим самим кодом, що й при автоматичній оплаті;
• «Потребує уваги» — за платежем потрібне рішення людини: клієнта заблоковано в кабінеті або тариф уже після створення оплати переїхав на інший продукт lava.top. Самі доступ ми тут не чіпаємо — вирішуєте ви.

Про гроші

• Комісія 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, створіть новий і вставте в кабінет.