Přijímání plateb přes lava.top
Návod krok za krokem: jak připojit účet lava.top ke CreateYourVPN, aby se platba klienta sama proměnila v předplatné — API klíč, webhook, propojení nabídek s tarify.
lava.top je poskytovatel plateb, který přijímá karty, SBP a PayPal v rublech, dolarech a eurech. Připojíte ho jednou — a platba na vašem výkladu se sama promění v aktivní předplatné: přidělovat přístup ručně není potřeba.
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 součástí placeného tarifu Max — právě on přepne výklad do prodejního režimu. O cenách platformy si přečtěte v lekci o fakturaci.
Co budete potřebovat
- účet na lava.top (autorský účet — ten, který prodává);
- 10–15 minut na prvotní nastavení;
- malou částku na testovací platbu: lava.top nemá testovací prostředí, takže celé nastavení lze ověřit jedině skutečným nákupem (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í: 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
V lava.top vytvořte produkt pro každý tarif, který prodáváte.
- U opakovaného tarifu zvolte typ produktu „Předplatné“ — pak bude lava.top strhávat sama a každé prodloužení prodlouží přístup i u nás.
- Pro jednorázový nákup použijte digitální produkt, kurz nebo konzultaci s pevnou cenou.
- Ověřte, že nabídka má cenu alespoň v jedné podporované měně: RUB, USD nebo EUR. Měna tarifu je ve výkladu předvolená, kupující však může přepnout na kteroukoli další měnu dostupnou v nabídce.
- Sladíte-li období strhávání s délkou tarifu: měsíční produkt ↔ 30 dní, 90 dní ↔ 90 a tak dále.
- Skryjte produkty z veřejné stránky lava.top pomocí nastavení viditelnosti. Nezapínejte „Cenu na vyžádání přes API“: CreateYourVPN nyní pracuje s nabídkami s pevnou cenou. Přímý nákup na stránce lava.top přijde bez naší značky a nemusí jít přiřadit k tarifu; pak skončí jako „Bez vazby“. Skryté produkty s pevnou cenou zůstávají v našem výběru nabídek viditelné.
Cenu produktu nazývá lava.top nabídkou (offer). Jeden produkt může mít několik nabídek (různé měny a období) — a právě nabídku pak vyberete pro každý tarif.
Co dělá opakovaný nákup
Jednorázový produkt nemá prodloužení: když klient potřebuje víc, prostě koupí znovu. To je běžný scénář a kupovat dopředu je bezpečné — dny se přičtou ke zbytku, nepočítají se od nuly. Deset zbývajících dnů plus čerstvý měsíc dá čtyřicet dnů.
Jedna výjimka, pokud tarif dává i data: kvóta se nahradí, nesčítá. Klient, který koupil 100 GB, spotřeboval 30 a koupí tentýž tarif znovu, skončí s čerstvými 100 GB, ne se 170. Počítejte s tím u cen datových tarifů.
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 — zkopírujte ho hned: lava.top ho podruhé neukáže a ztracený klíč lze pouze nahradit novým.

Vložte klíč ve svém 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řijala“.
Hned po uložení se ve stejném formuláři objeví další dvě hodnoty: URL webhooku 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 je i později na stránce API.

Webhook stačí jeden — v poli typu události se zaškrtnou rovnou všechny potřebné typy:

URL — adresa webhooku z vašeho panelu. lava.top přijímá jen HTTPS; naše adresa taková je.
Event type — zaškrtněte oba typy: „Payment result“ i „Recurring payment“. Seznam umožňuje vybrat víc možností, druhý webhook zakládat nemusíte.
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.
Podpis požadavku lava.top nemá vůbec, takže právě klíč webhooku říká našemu přijímači, že doručení přišlo z vašeho účtu — chovejte se k němu jako k heslu.
Neodškrtávejte „Recurring payment“, pokud prodáváte předplatné: bez tohoto typu události se k nám prodloužení nedostanou a přístup platícího klienta prostě skončí. U jednorázových produktů stačí „Payment result“, ale nechat zaškrtnuté oba je v pořádku.
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 klient klikne na „Zaplatit“; přečíst váš katalog produktů pro výběr nabídky; zrušit předplatné, když klient vypne automatické obnovování ve svém panelu. Ceny neměníme, exportu prodejů se nedotýkáme a nic jiného s tímto klíčem neděláme. Klíč je uložen zašifrovaně, nikde se znovu nezobrazuje 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. Propojte nabídky s tarify
Otevřete „Tarify“, vstupte do tarifu a najděte blok lava.top:
Stiskněte „Načíst produkty“ — stáhneme katalog z vašeho účtu lava.top.
Vyberte nabídku, kterou se tento tarif prodává. V seznamu je vidět produkt, cena a období strhávání.
Zkontrolujte varování, pokud se objeví. Panel řekne, kdy nabídka nemá cenu v měně tarifu a kdy se období strhávání rozchází s délkou tarifu („strhává jednou za 30 dní, ale tarif dává 365“).
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.
Kupující může přepínat mezi všemi měnami dostupnými ve vybrané nabídce. U jednorázové platby v rublech zobrazujeme kartu a SBP, u předplatného v rublech jen kartu. V dolarech a eurech jsou dostupné karta a PayPal.
Krok 5. Ověřte skutečnou platbou
Kupte si nejlevnější tarif sami, z klientského účtu na svém výkladu. Do minuty by se tarif měl objevit na tomto účtu a platba v deníku se stavem „Zpracováno“ (sekce „Monetizace“).
Pokud se to nestalo:
- událost v deníku vůbec není — webhook v lava.top míří na špatnou adresu, nemá zaškrtnuté potřebné typy událostí, nebo se klíč webhooku 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 „Bez vazby“ — nepoznali jsme, čí platba to je a za jaký tarif. Přiřaďte ji ručně přímo v deníku: předplatné se přidělí stejným kódem jako u automatické platby;
- „Vyžaduje pozornost“ — platba potřebuje lidské rozhodnutí: klient je v panelu zablokovaný, nebo byl tarif už po vytvoření platby přepnut na jiný produkt lava.top. Přístupu se tu sami nedotýkáme — rozhodujete vy.
Pokud se nepodaří strhnout platbu za prodloužení, lava.top provede ještě dva pokusy — za 8 a 24 hodin — a oznámení o neúspěchu odešle až po posledním. Přístup neodebíráme: již zaplacené období vždy doběhne do konce. Oznámení o zrušení jen znamená, že další prodloužení nepřijde.
O penězích
- Provize lava.top je 8 % z každé úspěšné platby. Strhává se okamžitě a při vrácení peněz klientovi se nevrací.
- Vrácení peněz se dělá z panelu lava.top, sekce „Prodeje“; vrácení u předplatného předplatné zruší. Vlastní typ webhooku pro vrácení a chargebacky lava.top zatím nemá, takže je uvidíte v panelu lava.top, ne v našem deníku.
- Zrušení automatického obnovování. Klient ho může zrušit sám ve svém panelu na vašem výkladu — my pak požádáme lava.top o zrušení předplatného — nebo ve svém účtu lava.top; zrušit ho za něj můžete i vy ze svého panelu lava.top. Zrušení nebere přístup: platí do konce už zaplaceného období a my prostě přestaneme čekat na další stržení.
- Chargeback lze zahájit do 540 dnů od platby a na doložení důkazů máte 3 dny. Uchovávejte podmínky svého výkladu a komunikaci s klientem — takto vypadají důkazy.
- 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.
Happ
Jak nainstalovat aplikaci Happ do telefonu nebo počítače, co dělat, když není ve vaší zemi dostupná, a jak se připojit pomocí odkazu z vašeho účtu.