Přijímání plateb přes lava.top
Návod krok za krokem: jak připojit lava.top ke CreateYourVPN, aby si zákazníci dobíjeli zůstatek na vaší výloze. API klíč, webhook, částky dobití a automatické dobití.
lava.top přijímá karty, SBP a PayPal v rublech, dolarech a eurech. Přes něj si zákazníci dobíjejí zůstatek v uživatelském účtu na vaší výloze a tarify kupují ze zůstatku: přidělovat přístup ručně není potřeba.
lava.top pracuje s pevnými částkami: zákazník si vybere jednu z částek dobití, které založíte, a každá částka má vlastní nabídku se stejnou cenou. Vlastní částku zákazník zadat nemůže. Pokud chcete libovolnou částku, připojte také PayHot.
Peníze jdou na váš vlastní účet lava.top. CreateYourVPN není v platbách prostředníkem a z vašich prodejů si nebere provizi.
Přijímání plateb je dostupné s placeným tarifem Max: s ním začne vaše výloha prodávat a zůstatek zákazníků se zapne sám. O tarifech platformy se dočtete v lekci o fakturaci.
Co budete potřebovat
- účet na lava.top (autorský účet, tedy ten, který prodává);
- 10–15 minut na prvotní nastavení;
- malou částku na testovací dobití: lava.top nemá testovací prostředí, takže celé nastavení lze ověřit jedině skutečnou platbou (minimálně 50 ₽ / 5 $ / 5 €).
Krok 1. Registrace a ověření
Zaregistrujte se na lava.top a vyplňte profil: s prázdným profilem působí platební stránka na kupujícího nedodělaně.
Pak jděte do Balance → ověření a ověření dokončete: doklad a selfie, 18+, s vypnutou VPN.
Prodávat můžete i před ověřením, ale vybrat peníze bez něj nelze. Neodkládejte ho až k první výplatě.
Krok 2. Založte produkty
Cena nabídky v lava.top je zároveň částkou dobití. Založte tolik nabídek, kolik částek chcete zákazníkům nabídnout.
- Jednorázové dobití: digitální produkt, kurz nebo konzultace s pevnou cenou. Jedna nabídka dává jednu částku, například 300, 500 nebo 1000 ₽.
- Automatické dobití: produkt typu „Předplatné“. lava.top sám strhává cenu nabídky podle jejího plánu (každý měsíc, jednou za 3 měsíce, jednou za půl roku nebo jednou za rok) a každé stržení zákazníkovi dobije zůstatek.
- Nabídka musí mít cenu v měně zákaznického účtu. Měnu najdete v sekci „Monetizace“, na kartě „Zůstatek zákazníků“. lava.top přijímá rubly, dolary a eura.
- Skryjte produkty z veřejné stránky lava.top pomocí nastavení viditelnosti. Nezapínejte „Cenu na vyžádání přes API“: CreateYourVPN pracuje s nabídkami s pevnou cenou. Nákup přímo z vaší stránky lava.top přijde bez naší značky a nebudeme vědět, čí platba to je. Skryté produkty s pevnou cenou v panelu zůstanou vidět.
Nabídka je v lava.top způsob, jak prodávat produkt za určitou cenu a s určitým obdobím strhávání. Jeden produkt může mít několik nabídek a v panelu pro každou částku vyberete tu správnou.
Krok 3. Připojte účet v CreateYourVPN
Vše potřebné na straně lava.top je na jednom místě: Integrations v levém menu, karta API.

Vytvořte API klíč
Otevřete kartu API a stiskněte „Create API key“. Klíč se zobrazí jen jednou, proto ho hned zkopírujte: lava.top ho podruhé neukáže a ztracený klíč lze pouze nahradit novým.

Vložte klíč do svého panelu
V CreateYourVPN otevřete sekci „Monetizace“, stiskněte „Připojit“ na kartě lava.top, vložte klíč do pole „API klíč lava.top“ a uložte.
Klíč hned zkontrolujeme a odpovíme buď „Klíč přijat“ s počtem produktů nalezených na účtu, nebo „lava.top tento klíč nepřijal“.
Hned po uložení se ve stejném formuláři objeví další dvě hodnoty: Webhook URL a klíč webhooku. Ty v dalším kroku vložíte do lava.top. Klíč webhooku generujeme my, nic si vymýšlet nemusíte.
Založte webhook
lava.top to nabídne hned po vytvoření klíče: stiskněte „+ Add Webhook“. Totéž tlačítko najdete i později na stránce API.

Stačí jeden webhook: v poli typu události se zaškrtávají všechny události najednou.

URL: adresa webhooku z vašeho panelu. lava.top přijímá jen HTTPS a naše adresa už taková je.
Typ události: zaškrtněte všechny události v seznamu. Výběr je vícenásobný, takže druhý webhook není potřeba.
Type of authentication for Webhook: zvolte „API key of your service“ a do pole „API key“ vložte klíč webhooku z panelu. Basic také funguje, přijímáme ho, ale jsou to dvě pole místo jednoho.
Comment: nepovinný, pro vás. Poznámka typu „CreateYourVPN, platby“ pomůže, když máte integrací víc.
lava.top nepřidává k tělu požadavku kryptografický podpis, proto doručení potvrzuje klíč webhooku. Chovejte se k němu jako k heslu.
Nenechávejte žádnou událost nezaškrtnutou: bez událostí o opakovaných platbách se automatická dobití zákazníků na zůstatek nikdy nedostanou. Zaškrtnout všechno je vždy bezpečné.
Co nám API klíč dává
Klíče „jen pro čtení“ lava.top nemá: API klíč dává plný přístup k autorskému účtu. Používáme ho přesně na tři věci: vytvořit platbu ve chvíli, kdy zákazník klikne na „Zaplatit“; přečíst váš katalog produktů, abyste mohli v panelu vybrat nabídky; zrušit předplatné, když zákazník ve svém uživatelském účtu vypne automatické dobití nebo automatické prodlužování. Ceny nikdy neměníme, vaše prodeje neexportujeme a ničeho jiného se nedotýkáme. Klíč je uložen zašifrovaně, už se nikdy nezobrazí a nedostane se do našich logů. Pokud budete chtít přístup odříznout, smažte připojení v panelu: klíč se smaže s ním.
Krok 4. Přidejte částky dobití
Otevřete „Tarify“ a najděte blok „Dobití zůstatku“.
Klikněte na „Přidat dobití“, v seznamu „Nabídka lava.top“ vyberte jednorázovou nabídku a v okně klikněte na „Přidat dobití“. Částkou se stane cena nabídky. Takto přidejte každou částku, nejvýše 20.
Pro automatické dobití klikněte na „Přidat automatické dobití“, vyberte předplatné lava.top a v okně klikněte na „Přidat automatické dobití“. Částku a četnost určuje nabídka, například 500 ₽ každý měsíc. Panel ukáže, na jaký tarif takové dobití stačí.
Zkontrolujte varování u řádků, pokud nějaká jsou. Panel řekne, když nabídka nemá cenu v měně zůstatku, když se cena nabídky liší od částky a když nabídka v lava.top už není.
Právě jste v lava.top založili produkt a nevidíte ho v seznamu? Stiskněte „Obnovit seznam“: katalog se kešuje na minutu.
Dokud nezaložíte žádnou částku a nepřipojíte PayHot, zákazníci nemají čím zůstatek dobít: v okně „Dobít zůstatek“ uvidí „Dobití zatím není k dispozici“. Založte alespoň jednu částku, která není nižší než cena vašeho nejdražšího tarifu: pak zákazník s prázdným zůstatkem dobije a koupí tarif jedinou platbou, tlačítkem „Dobít a koupit“.
V samotném tarifu se nabídka nevybírá: tarif v měně zákaznického účtu zákazník kupuje ze zůstatku. Výjimka: tarif s cenou v jiné měně, který byl dříve přiřazen k nabídce, zákazník platí přímo přes lava.top.
Co uvidí zákazník
V uživatelském účtu na vaší výloze zákazník klikne na „Dobít“. Na záložce „Jednorázově“ vybere jednu z vašich částek a platební metodu: kartu, SBP (jen rubly) nebo PayPal, pokud má nabídka cenu v dolarech nebo eurech. Na záložce „Automaticky“ zapne automatické dobití: kartou nebo přes PayPal, protože předplatné lava.top SBP nepodporuje. Na zůstatek vždy přijde částka dobití v měně zákaznického účtu, i když zákazník zaplatil v jiné měně.
Automatické dobití vyžaduje tarif typu předplatné s dobou platnosti a cenou v měně zákaznického účtu: bez něj zákazník záložku „Automaticky“ nemá. Automatické dobití funguje společně s automatickým prodlužováním tarifu ze zůstatku: automatické prodlužování se zapne samo, když zákazník automatické dobití zapne, a pokud zákazník ještě nemá tarif, první stržení ho koupí. Zákazník může mít jen jedno automatické dobití.
Krok 5. Ověřte skutečnou platbou
Z účtu zákazníka na své výloze dobijte zůstatek nejmenší částkou. Do minuty by se peníze měly objevit na zůstatku a v sekci „Monetizace“, v bloku „Deník plateb“, by se mělo objevit dobití zůstatku se stavem „Zpracováno“. Pak ze zůstatku kupte tarif.
Pokud se to nestalo:
- událost v deníku vůbec není: webhook v lava.top míří na špatnou adresu, nemá zaškrtnuté všechny události nebo se jeho klíč neshoduje s tím v panelu. lava.top má historii webhooků s tlačítkem pro opětovné odeslání, začněte u ní;
- událost tam je, ale peníze na zůstatku nejsou: u události je poznámka „Nepřipsáno na zůstatek“ s nápovědou. Zkontrolujte platbu v lava.top a připište částku úpravou v kartě zákazníka;
- „Bez vazby“: nepoznali jsme, čí platba to je. Stává se to, když zákazník koupil produkt přímo na vaší stránce lava.top, mimo výlohu. Najděte zákazníka a připište částku úpravou v jeho kartě;
- „Vyžaduje pozornost“: událost potřebuje vaše rozhodnutí a co udělat, je napsáno přímo u ní.
Pokud se stržení u předplatného nepodaří, lava.top provede ještě dva pokusy, za 8 a 24 hodin, a oznámení o neúspěšné platbě pošle až po posledním. Zákazník ve svém uživatelském účtu uvidí, že poslední platba neprošla. Peníze, které už na zůstatku jsou, zákazníkovi zůstávají.
O penězích
- Provize lava.top: 8 % z každé úspěšné platby. Strhává se okamžitě a při vrácení peněz zákazníkovi se nevrací.
- Vrácení peněz se dělá z panelu lava.top, v sekci „Prodeje“; vrácení u předplatného předplatné zruší. Oznámení o vrácení peněz nebo chargebacku přijde do deníku se stavem „Vyžaduje pozornost“. Zůstatek zákazníka se po vrácení sám nesníží: odepište stejnou částku úpravou v kartě zákazníka.
- Vypnutí automatického dobití. Zákazník ho vypne sám ve svém uživatelském účtu na vaší výloze a my požádáme lava.top o zrušení předplatného. Pokud zákazník vypne automatické prodlužování svého tarifu, automatické dobití se vypne spolu s ním. Předplatné můžete zrušit i v panelu lava.top. Peníze na zůstatku v žádném případě nepropadají.
- Chargeback lze zahájit do 540 dnů od platby a na doložení důkazů máte 3 dny. Uchovávejte podmínky prodeje, komunikaci se zákazníkem a doklady o tom, že přístup byl poskytnut.
- Limity závisí na typu produktu. Minimum je vždy 50 ₽ / 5 $ / 5 €. U předplatného je maximum 300 000 ₽ / 3 000 $ / 3 000 €, u jednorázového produktu 1 000 000 ₽ / 10 000 $ / 10 000 €.
Když klíč unikne
Na kartě lava.top jsou dvě různá tlačítka a dělají různé věci:
- „Vygenerovat nový klíč webhooku“ vydá nový klíč pro příchozí oznámení. Novou hodnotu je třeba vložit do webhooku v lava.top; dokud to neuděláte, platby se nebudou potvrzovat.
- „Změnit URL webhooku“ vydá novou adresu. Stará hned přestane fungovat, i tu je nutné aktualizovat ve webhooku.
Pokud unikl samotný API klíč, zrušte ho v lava.top, vytvořte nový a vložte ho do panelu.
Jak nastavit vlastní server (režim „Jeden server“)
Podrobný průvodce krok za krokem: jak připojit svůj VPS ke CreateYourVPN v režimu „Jeden server“ — od pronájmu serveru po hotovou osobní VPN během několika minut.
Přijímání plateb přes PayHot
Návod krok za krokem: jak připojit PayHot ke CreateYourVPN, aby si zákazníci dobíjeli zůstatek libovolnou částkou kartou, přes SBP nebo kryptoměnou. Žádost, API klíč, webhook, platební metody a automatické dobití.