CreateYourVPN Academy
Návody

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.

Sekcia „Integrations“ v lava.top: karty API a Web-Widget

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.

Stránka s API kľúčmi: tlačidlo „Create API key“ a odkaz na históriu webhookov

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.

Okno „API key successfully added“ s tlačidlom „+ Add Webhook“

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

Formulár na pridanie webhooku: URL, typ udalosti, typ overenia a pole API kľúča

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.

On this page