Prijímanie platieb cez lava.top
Návod krok za krokom: ako pripojiť účet lava.top ku CreateYourVPN, aby sa platba klienta sama zmenila na predplatné — API kľúč, webhook, priradenie ponúk k tarifám.
lava.top je poskytovateľ platieb, ktorý prijíma karty, SBP a PayPal v rubľoch, dolároch a eurách. Pripojíte ho raz — a platba vo vašom výklade sa sama zmení na aktívne predplatné: prideľovať prístup ručne netreba.
Peniaze idú na váš vlastný účet lava.top. CreateYourVPN nie je v platbách sprostredkovateľom a z vašich predajov si neberie províziu.
Prijímanie platieb patrí k platenému tarifu Max — práve on prepne výklad do predajného režimu. O cenách platformy si prečítajte v lekcii o fakturácii.
Čo budete potrebovať
- účet na lava.top (autorský účet — ten, ktorý predáva);
- 10–15 minút na prvotné nastavenie;
- malú sumu na testovaciu platbu: lava.top nemá testovacie prostredie, takže celé nastavenie sa dá overiť iba skutočným nákupom (minimálne 50 ₽ / 5 $ / 5 €).
Krok 1. Registrácia a overenie
Zaregistrujte sa na lava.top a vyplňte profil — s prázdnym profilom pôsobí platobná stránka na kupujúceho nedorobene.
Potom choďte do Balance → overenie: doklad a selfie, 18+, s vypnutou VPN.
Predávať môžete aj pred overením, ale vybrať peniaze bez neho nie. Neodkladajte ho až na prvú výplatu.
Krok 2. Založte produkty
V lava.top vytvorte produkt pre každý tarif, ktorý predávate.
- Pri opakovanom tarife zvoľte typ produktu „Predplatné“ — potom bude lava.top strhávať sama a každé predĺženie predĺži prístup aj u nás.
- Na jednorazový nákup použite digitálny produkt, kurz alebo konzultáciu s pevnou cenou.
- Overte, že ponuka má cenu aspoň v jednej podporovanej mene: RUB, USD alebo EUR. Mena tarifu je vo výklade predvolená, kupujúci však môže prepnúť na ktorúkoľvek ďalšiu menu dostupnú v ponuke.
- Zosúlaďte obdobie strhávania s dĺžkou tarifu: mesačný produkt ↔ 30 dní, 90 dní ↔ 90 a tak ďalej.
- Skryte produkty z verejnej stránky lava.top pomocou nastavenia viditeľnosti. Nezapínajte „Cenu na vyžiadanie cez API“: CreateYourVPN teraz pracuje s ponukami s pevnou cenou. Priamy nákup na stránke lava.top príde bez našej značky a nemusí sa dať priradiť k tarifu; potom skončí ako „Bez väzby“. Skryté produkty s pevnou cenou zostanú v našom výbere ponúk viditeľné.
Cenu produktu nazýva lava.top ponukou (offer). Jeden produkt môže mať viacero ponúk (rôzne meny a obdobia) — a práve ponuku si potom vyberiete pre každý tarif.
Čo robí opakovaný nákup
Jednorazový produkt nemá predĺženia: keď klient potrebuje viac, jednoducho kúpi znova. Je to bežný scenár a kupovať dopredu je bezpečné — dni sa pripočítajú k zvyšku, nepočítajú sa od nuly. Desať zostávajúcich dní plus čerstvý mesiac dá štyridsať dní.
Jedna výnimka, ak tarif dáva aj dáta: kvóta sa nahradí, nesčíta. Klient, ktorý kúpil 100 GB, minul 30 a kúpi ten istý tarif znova, skončí s čerstvými 100 GB, nie so 170. Rátajte s tým pri cenách dátových tarifov.
Krok 3. Pripojte účet v CreateYourVPN
Všetko potrebné na strane lava.top je na jednom mieste: Integrations v ľavom menu, karta API.

Vytvorte API kľúč
Otvorte kartu API a stlačte „Create API key“. Kľúč sa zobrazí iba raz — skopírujte ho hneď: lava.top ho druhýkrát neukáže a stratený kľúč sa dá len nahradiť novým.

Vložte kľúč vo svojom paneli
V CreateYourVPN otvorte sekciu „Monetizácia“, stlačte „Pripojiť“ na karte lava.top, vložte kľúč do poľa „API kľúč lava.top“ a uložte.
Kľúč hneď skontrolujeme a odpovieme buď „Kľúč prijatý“ — s počtom produktov nájdených na účte — alebo „lava.top tento kľúč neprijala“.
Hneď po uložení sa v tom istom formulári objavia ďalšie dve hodnoty: URL webhooku a kľúč webhooku. Tie v ďalšom kroku vložíte do lava.top. Kľúč webhooku generujeme my — nič si vymýšľať nemusíte.
Založte webhook
lava.top to ponúkne hneď po vytvorení kľúča — stlačte „+ Add Webhook“. To isté tlačidlo je aj neskôr na stránke API.

Webhook stačí jeden — v poli typu udalosti sa označia rovno všetky potrebné typy:

URL — adresa webhooku z vášho panela. lava.top prijíma len HTTPS; naša adresa taká je.
Event type — označte oba typy: „Payment result“ aj „Recurring payment“. Zoznam umožňuje viacnásobný výber, druhý webhook zakladať netreba.
Type of authentication for Webhook — zvoľte „API key of your service“ a do poľa „API key“ vložte kľúč webhooku z panela. (Basic tiež funguje — prijímame ho — ale sú to dve polia namiesto jedného.)
Comment — nepovinný, pre vás: poznámka typu „CreateYourVPN — platby“ pomôže, keď máte integrácií viac.
Podpis požiadavky lava.top nemá vôbec, takže práve kľúč webhooku hovorí nášmu prijímaču, že doručenie prišlo z vášho účtu — správajte sa k nemu ako k heslu.
Neodznačujte „Recurring payment“, ak predávate predplatné: bez tohto typu udalosti sa k nám predĺženia nedostanú a prístup platiaceho klienta jednoducho skončí. Pri jednorazových produktoch stačí „Payment result“, ale nechať označené oba je v poriadku.
Čo nám API kľúč dáva
Kľúče „len na čítanie“ lava.top nemá — API kľúč dáva plný prístup k autorskému účtu. Používame ho presne na tri veci: vytvoriť platbu vo chvíli, keď klient klikne na „Zaplatiť“; prečítať váš katalóg produktov pre výber ponuky; zrušiť predplatné, keď klient vypne automatické obnovovanie vo svojom paneli. Ceny nemeníme, exportu predajov sa nedotýkame a nič iné s týmto kľúčom nerobíme. Kľúč je uložený zašifrovane, nikde sa znova nezobrazuje a nedostane sa do našich logov. Ak budete chcieť prístup odrezať — vymažte pripojenie v paneli, kľúč sa vymaže s ním.
Krok 4. Priraďte ponuky k tarifám
Otvorte „Tarify“, vojdite do tarifu a nájdite blok lava.top:
Stlačte „Načítať produkty“ — stiahneme katalóg z vášho účtu lava.top.
Vyberte ponuku, ktorou sa tento tarif predáva. V zozname vidno produkt, cenu a obdobie strhávania.
Skontrolujte upozornenia, ak sa objavia. Panel povie, kedy ponuka nemá cenu v mene tarifu a kedy sa obdobie strhávania rozchádza s dĺžkou tarifu („strháva raz za 30 dní, ale tarif dáva 365“).
Práve ste v lava.top založili produkt a nevidíte ho v zozname? Stlačte „Obnoviť zoznam“ — katalóg sa kešuje na minútu.
Kupujúci môže prepínať medzi všetkými menami dostupnými vo vybranej ponuke. Pri jednorazovej platbe v rubľoch zobrazujeme kartu a SBP, pri predplatnom v rubľoch len kartu. V dolároch a eurách sú dostupné karta a PayPal.
Krok 5. Overte skutočnou platbou
Kúpte si najlacnejší tarif sami, z klientskeho účtu na svojom výklade. Do minúty by sa tarif mal objaviť na tomto účte a platba v denníku so stavom „Spracované“ (sekcia „Monetizácia“).
Ak sa to nestalo:
- udalosť v denníku vôbec nie je — webhook v lava.top mieri na zlú adresu, nemá označené potrebné typy udalostí, alebo sa kľúč webhooku nezhoduje s tým v paneli. lava.top má históriu webhookov s tlačidlom na opätovné odoslanie — začnite pri nej;
- udalosť tam je, ale „Bez väzby“ — nespoznali sme, čia platba to je a za aký tarif. Priraďte ju ručne priamo v denníku: predplatné sa pridelí rovnakým kódom ako pri automatickej platbe;
- „Vyžaduje pozornosť“ — platba potrebuje ľudské rozhodnutie: klient je v paneli zablokovaný, alebo bol tarif už po vytvorení platby prepnutý na iný produkt lava.top. Prístupu sa tu sami nedotýkame — rozhodujete vy.
Ak sa nepodarí strhnúť platbu za predĺženie, lava.top vykoná ešte dva pokusy — o 8 a 24 hodín — a oznámenie o neúspechu odošle až po poslednom. Prístup neodoberáme: už zaplatené obdobie vždy dobehne do konca. Oznámenie o zrušení len znamená, že ďalšie predĺženie nepríde.
O peniazoch
- Provízia lava.top je 8 % z každej úspešnej platby. Strháva sa okamžite a pri vrátení peňazí klientovi sa nevracia.
- Vrátenie peňazí sa robí z panela lava.top, sekcia „Predaje“; vrátenie pri predplatnom predplatné zruší. Vlastný typ webhooku pre vrátenia a chargebacky lava.top zatiaľ nemá, takže ich uvidíte v paneli lava.top, nie v našom denníku.
- Zrušenie automatického obnovovania. Klient ho môže zrušiť sám vo svojom paneli na vašom výklade — my potom požiadame lava.top o zrušenie predplatného — alebo vo svojom účte lava.top; zrušiť ho zaňho môžete aj vy zo svojho panela lava.top. Zrušenie neberie prístup: platí do konca už zaplateného obdobia a my jednoducho prestaneme čakať na ďalšie stiahnutie.
- Chargeback možno začať do 540 dní od platby a na doloženie dôkazov máte 3 dni. Uchovávajte podmienky svojho výkladu a komunikáciu s klientom — takto vyzerajú dôkazy.
- Limity závisia od typu produktu. Minimum je vždy 50 ₽ / 5 $ / 5 €. Pri predplatnom je maximum 300 000 ₽ / 3 000 $ / 3 000 €, pri jednorazovom produkte 1 000 000 ₽ / 10 000 $ / 10 000 €.
Ak kľúč unikne
Na karte lava.top sú dve rôzne tlačidlá a robia rôzne veci:
- „Vydať nový kľúč webhooku“ — vydá nový kľúč pre prichádzajúce oznámenia. Novú hodnotu treba vložiť do webhooku v lava.top; kým to neurobíte, platby sa nebudú potvrdzovať.
- „Zmeniť URL webhooku“ — vydá novú adresu. Stará hneď prestane fungovať, aj tú treba aktualizovať vo webhooku.
Ak unikol samotný API kľúč — zrušte ho v lava.top, vytvorte nový a vložte ho do panela.
Ako nastaviť vlastný server (režim «Jeden server»)
Návod krok za krokom: ako pripojiť svoj VPS k CreateYourVPN v režime «Jeden server» — od prenájmu servera až po hotovú osobnú VPN za pár minút.
Happ
Ako nainštalovať aplikáciu Happ do telefónu alebo počítača, čo robiť, ak nie je vo vašej krajine dostupná, a ako sa pripojiť pomocou odkazu z vášho konta.