Przyjmowanie płatności przez lava.top
Przewodnik krok po kroku: jak podłączyć lava.top do CreateYourVPN, żeby klienci doładowywali saldo w Twojej witrynie. Klucz API, webhook, kwoty doładowania i automatyczne doładowanie.
lava.top przyjmuje karty, SBP i PayPal w rublach, dolarach i euro. Przez niego klienci doładowują saldo w panelu użytkownika na Twojej witrynie, a plany kupują z salda: nie musisz nadawać dostępu ręcznie.
lava.top działa ze stałymi kwotami: klient wybiera jedną z kwot doładowania, które utworzysz, a każda kwota ma własną ofertę z tą samą ceną. Własnej kwoty klient wpisać nie może. Jeśli potrzebujesz dowolnej kwoty, podłącz też PayHot.
Pieniądze trafiają na Twoje własne konto lava.top. CreateYourVPN nie pośredniczy w płatnościach i nie pobiera prowizji od Twojej sprzedaży.
Przyjmowanie płatności jest dostępne w płatnym planie Max: w nim Twoja witryna zaczyna sprzedawać, a saldo klientów włącza się samo. O planach platformy przeczytasz w lekcji o rozliczeniach.
Czego potrzebujesz
- konta na lava.top (konta autora, czyli tego, które sprzedaje);
- 10–15 minut na wstępną konfigurację;
- niewielkiej kwoty na testowe doładowanie: lava.top nie ma środowiska testowego, więc całą konfigurację da się sprawdzić tylko prawdziwą płatnością (minimum 50 ₽ / 5 $ / 5 €).
Krok 1. Rejestracja i weryfikacja
Zarejestruj się na lava.top i wypełnij profil: z pustym profilem strona płatności wygląda dla kupującego na niedokończoną.
Następnie wejdź w Balance → weryfikacja i przejdź weryfikację: dokument i selfie, 18+, bez włączonego VPN-a.
Sprzedawać możesz jeszcze przed weryfikacją, ale bez niej nie wypłacisz pieniędzy. Nie odkładaj jej do pierwszej wypłaty.
Krok 2. Załóż produkty
Cena oferty w lava.top jest kwotą doładowania. Utwórz tyle ofert, ile kwot chcesz zaproponować klientom.
- Doładowanie jednorazowe: produkt cyfrowy, kurs lub konsultacja ze stałą ceną. Jedna oferta daje jedną kwotę, na przykład 300, 500 lub 1000 ₽.
- Automatyczne doładowanie: produkt typu „Subskrypcja”. lava.top sam pobiera cenę oferty według jej harmonogramu (co miesiąc, co 3 miesiące, co pół roku lub co rok), a każde obciążenie doładowuje saldo klienta.
- Oferta musi mieć cenę w walucie konta klientów. Walutę znajdziesz w sekcji „Monetyzacja”, na karcie „Saldo klientów”. lava.top przyjmuje ruble, dolary i euro.
- Ukryj produkty na publicznej stronie lava.top za pomocą ustawienia widoczności. Nie włączaj „Ceny na zapytanie przez API”: CreateYourVPN działa z ofertami o stałej cenie. Zakup prosto z Twojej strony lava.top przychodzi bez naszego znacznika i nie będziemy wiedzieć, czyja to płatność. Ukryte produkty o stałej cenie nadal będą widoczne w panelu.
Oferta w lava.top to wariant sprzedaży produktu z określoną ceną i okresem rozliczeniowym. Jeden produkt może mieć kilka ofert, a w panelu wybierzesz właściwą dla każdej kwoty.
Krok 3. Podłącz konto w CreateYourVPN
Wszystko, co potrzebne po stronie lava.top, jest w jednym miejscu: Integrations w menu po lewej, karta API.
Utwórz klucz API
Otwórz kartę API i naciśnij „Create API key”. Klucz pokazuje się tylko raz, więc skopiuj go od razu: lava.top nie pokaże go ponownie, a zgubiony klucz można tylko zastąpić nowym.
Wklej klucz w panelu
W CreateYourVPN otwórz sekcję „Monetyzacja”, naciśnij „Podłącz” na karcie lava.top, wklej klucz w pole „Klucz API lava.top” i zapisz.
Od razu sprawdzimy klucz i odpowiemy „Klucz zaakceptowany” z liczbą produktów znalezionych na koncie albo „lava.top nie przyjął tego klucza”.
Zaraz po zapisaniu w tym samym formularzu pojawią się jeszcze dwie wartości: Webhook URL i klucz webhooka. To je wkleisz do lava.top w następnym kroku. Klucz webhooka generujemy my, nie musisz nic wymyślać.
Załóż webhook
lava.top zaproponuje to zaraz po utworzeniu klucza: naciśnij „+ Add Webhook”. Ten sam przycisk jest dostępny także później, na stronie API.
Wystarczy jeden webhook: w polu typu zdarzenia zaznacza się od razu wszystkie zdarzenia.
URL: adres webhooka z Twojego panelu. lava.top przyjmuje tylko HTTPS, a nasz adres właśnie taki jest.
Typ zdarzenia: zaznacz wszystkie zdarzenia z listy. Wybór jest wielokrotny, więc drugi webhook nie jest potrzebny.
Type of authentication for Webhook: wybierz „API key of your service” i wklej w pole „API key” klucz webhooka z panelu. Basic też zadziała, przyjmujemy go, ale to dwa pola zamiast jednego.
Comment: opcjonalny, dla Ciebie. Podpis w stylu „CreateYourVPN, płatności” pomaga, gdy integracji jest kilka.
lava.top nie dodaje kryptograficznego podpisu treści żądania, dlatego dostawę potwierdza klucz webhooka. Traktuj go jak hasło.
Nie zostawiaj żadnych zdarzeń niezaznaczonych: bez zdarzeń o płatnościach cyklicznych automatyczne doładowania klientów nigdy nie dotrą na saldo. Zaznaczenie wszystkiego jest zawsze bezpieczne.
Co daje nam klucz API
Kluczy „tylko do odczytu” lava.top nie ma: klucz API daje pełny dostęp do konta autora. Używamy go dokładnie do trzech rzeczy: utworzenia płatności w chwili, gdy klient kliknie „Zapłać”; odczytania Twojego katalogu produktów, żebyś mógł wybrać oferty w panelu; anulowania subskrypcji, gdy klient wyłączy automatyczne doładowanie lub automatyczne odnawianie w panelu użytkownika. Nigdy nie zmieniamy cen, nie eksportujemy Twojej sprzedaży i niczego innego nie ruszamy. Klucz jest przechowywany w postaci zaszyfrowanej, nigdzie więcej się nie pokazuje i nie trafia do naszych logów. Jeśli zechcesz odciąć dostęp, usuń połączenie w panelu: klucz zniknie razem z nim.
Krok 4. Dodaj kwoty doładowania
Otwórz „Plany” i znajdź blok „Doładowanie salda”.
Kliknij „Dodaj doładowanie”, wybierz na liście „Oferta lava.top” ofertę jednorazową i kliknij „Dodaj doładowanie” w oknie. Kwotą stanie się cena oferty. W ten sposób dodaj każdą kwotę, maksymalnie 20.
Dla automatycznego doładowania kliknij „Dodaj automatyczne doładowanie”, wybierz subskrypcję lava.top i kliknij „Dodaj automatyczne doładowanie” w oknie. Kwotę i częstotliwość określa oferta, na przykład 500 ₽ co miesiąc. Panel podpowie, na jaki plan wystarczy takie doładowanie.
Sprawdź ostrzeżenia przy wierszach, jeśli się pojawią. Panel powie, kiedy oferta nie ma ceny w walucie salda, kiedy cena oferty różni się od kwoty i kiedy oferty nie ma już w lava.top.
Właśnie założyłeś produkt w lava.top i nie widzisz go na liście? Naciśnij „Odśwież listę”: katalog jest buforowany przez minutę.
Dopóki nie dodasz żadnej kwoty ani nie podłączysz PayHot, klienci nie mają czym doładować salda: w oknie „Doładuj saldo” zobaczą „Doładowanie nie jest jeszcze dostępne”. Dodaj co najmniej jedną kwotę nie niższą niż cena Twojego najdroższego planu: wtedy klient z pustym saldem doładuje je i kupi plan jedną płatnością, przyciskiem „Doładuj i kup”.
W samym planie oferty się nie wybiera: plan w walucie konta klientów klient kupuje z salda. Wyjątek: plan z ceną w innej walucie, przypisany wcześniej do oferty, klient opłaca bezpośrednio przez lava.top.
Co zobaczy klient
W panelu użytkownika na Twojej witrynie klient klika „Doładuj”. W zakładce „Jednorazowo” wybiera jedną z Twoich kwot i metodę płatności: kartę, SBP (tylko ruble) albo PayPal, jeśli oferta ma cenę w dolarach lub euro. W zakładce „Automatycznie” włącza automatyczne doładowanie: kartą albo przez PayPal, bo subskrypcje lava.top nie obsługują SBP. Na saldo zawsze wpływa kwota doładowania w walucie konta klientów, nawet jeśli klient zapłacił w innej walucie.
Automatyczne doładowanie wymaga planu typu subskrypcja z okresem i ceną w walucie konta klientów: bez niego klient nie ma zakładki „Automatycznie”. Automatyczne doładowanie działa razem z automatycznym odnawianiem planu z salda: automatyczne odnawianie włączy się samo, gdy klient włączy automatyczne doładowanie, a jeśli klient nie ma jeszcze planu, pierwsze obciążenie go kupi. Klient może mieć tylko jedno automatyczne doładowanie.
Krok 5. Sprawdź prawdziwą płatnością
Z konta klienta na swojej witrynie doładuj saldo najmniejszą kwotą. W ciągu minuty pieniądze powinny pojawić się na saldzie, a w sekcji „Monetyzacja”, w bloku „Dziennik płatności”, powinno pojawić się doładowanie salda ze statusem „Przetworzono”. Potem kup plan z salda.
Jeśli tak się nie stanie:
- zdarzenia w ogóle nie ma w dzienniku: webhook w lava.top wskazuje zły adres, nie ma zaznaczonych wszystkich zdarzeń albo jego klucz nie zgadza się z tym w panelu. W lava.top jest historia webhooków z przyciskiem ponownego wysłania, zacznij od niej;
- zdarzenie jest, ale pieniędzy nie ma na saldzie: zdarzenie ma adnotację „Nie zaksięgowano na saldzie” ze wskazówką. Sprawdź płatność w lava.top i zaksięguj kwotę korektą w karcie klienta;
- „Bez powiązania”: nie rozpoznaliśmy, czyja to płatność. Tak bywa, gdy klient kupił produkt bezpośrednio na Twojej stronie lava.top, z pominięciem witryny. Znajdź klienta i zaksięguj kwotę korektą w jego karcie;
- „Wymaga uwagi”: zdarzenie wymaga Twojej decyzji, a co zrobić, jest napisane przy samym zdarzeniu.
Jeśli obciążenie za subskrypcję się nie uda, lava.top wykona jeszcze dwie próby, po 8 i 24 godzinach, i wyśle powiadomienie o nieudanej płatności dopiero po ostatniej. Klient zobaczy w panelu użytkownika, że ostatnie obciążenie się nie udało. Pieniądze, które już są na saldzie, zostają u klienta.
O pieniądzach
- Prowizja lava.top: 8 % od każdej udanej płatności. Pobierana jest od razu i przy zwrocie dla klienta nie wraca.
- Zwrot robi się z panelu lava.top, w sekcji „Sprzedaż”; zwrot przy subskrypcji anuluje subskrypcję. Powiadomienie o zwrocie lub chargebacku trafia do dziennika ze statusem „Wymaga uwagi”. Saldo klienta po zwrocie samo się nie zmniejszy: odejmij tę samą kwotę korektą w karcie klienta.
- Wyłączenie automatycznego doładowania. Klient wyłącza je sam w panelu użytkownika na Twojej witrynie, a my prosimy lava.top o anulowanie subskrypcji. Jeśli klient wyłączy automatyczne odnawianie planu, automatyczne doładowanie wyłączy się razem z nim. Subskrypcję możesz też anulować w panelu lava.top. Pieniądze na saldzie w żadnym wypadku nie przepadają.
- Chargeback można zainicjować w ciągu 540 dni od płatności, a na dostarczenie dowodów masz 3 dni. Przechowuj warunki sprzedaży, korespondencję z klientem i potwierdzenia, że dostęp został zapewniony.
- Limity zależą od typu produktu. Minimum zawsze wynosi 50 ₽ / 5 $ / 5 €. Dla subskrypcji maksimum to 300 000 ₽ / 3 000 $ / 3 000 €, a dla produktu jednorazowego 1 000 000 ₽ / 10 000 $ / 10 000 €.
Jeśli klucz wycieknie
Na karcie lava.top są dwa różne przyciski i robią różne rzeczy:
- „Wygeneruj nowy klucz webhooka” wydaje nowy klucz dla przychodzących powiadomień. Nową wartość trzeba wkleić do webhooka w lava.top; dopóki tego nie zrobisz, płatności nie będą potwierdzane.
- „Zmień URL webhooka” wydaje nowy adres. Stary przestaje działać natychmiast, jego też trzeba zaktualizować w webhooku.
Jeśli wyciekł sam klucz API, odwołaj go w lava.top, utwórz nowy i wklej go w panelu.
Jak skonfigurować własny serwer (tryb «Jeden serwer»)
Przewodnik krok po kroku: jak podłączyć swój VPS do CreateYourVPN w trybie «Jeden serwer» — od wynajęcia serwera po gotowy osobisty VPN w kilka minut.
Przyjmowanie płatności przez PayHot
Przewodnik krok po kroku: jak podłączyć PayHot do CreateYourVPN, żeby klienci doładowywali saldo dowolną kwotą kartą, przez SBP lub kryptowalutą. Wniosek, klucz API, webhook, metody płatności i automatyczne doładowanie.