CreateYourVPN Academy
Průvodci

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.

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

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.

Stránka s API klíči: tlačítko „Create API key“ a odkaz na historii webhooků

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.

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

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

Formulář pro přidání webhooku: URL, typ události, typ ověření a pole API klíče

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.

On this page