CreateYourVPN Academy
Guider

Ta emot betalningar med lava.top

Steg-för-steg-guide: hur du kopplar ditt lava.top-konto till CreateYourVPN så att en kunds betalning av sig själv blir en prenumeration — API-nyckel, en webhook, koppling av erbjudanden till dina planer.

lava.top är en betalleverantör som tar emot kort, SBP och PayPal i rubel, dollar och euro. Du kopplar in den en gång — och en betalning i din butik blir av sig själv en aktiv prenumeration: du behöver inte ge åtkomst för hand.

Pengarna går till ditt eget lava.top-konto. CreateYourVPN är ingen mellanhand i betalningarna och tar ingen provision på din försäljning.

Att ta emot betalningar ingår i den betalda planen Max — det är den som sätter butiken i säljläge. Om plattformens priser, se lektionen om fakturering.

Det här behöver du

  • ett konto på lava.top (ett författarkonto — det som säljer);
  • 10–15 minuter för den första inställningen;
  • en liten summa för en testbetalning: lava.top har ingen testmiljö, så hela inställningen kan bara kontrolleras med ett riktigt köp (minst 50 ₽ / 5 $ / 5 €).

Steg 1. Registrering och verifiering

Registrera dig på lava.top och fyll i din profil — med tom profil ser betalsidan ofärdig ut för köparen.

Gå sedan till Balance → verifiering: ett dokument och en selfie, 18+, utan påslagen VPN.

Du kan sälja även före verifieringen, men du kan inte ta ut pengar utan den. Skjut inte upp den till första utbetalningen.

Steg 2. Skapa dina produkter

Skapa i lava.top en produkt för varje plan du säljer.

  • För en återkommande plan väljer du produkttypen ”Prenumeration” — då drar lava.top själv, och varje förnyelse förlänger åtkomsten hos oss.
  • För ett engångsköp använder du en digital produkt, kurs eller konsultation med fast pris.
  • Kontrollera att erbjudandet har ett pris i minst en valuta som stöds: RUB, USD eller EUR. Planens valuta är förvald i butiken, men köparen kan byta till valfri annan valuta som finns i erbjudandet.
  • Stäm av dragningsperioden mot planens längd: månadsprodukt ↔ 30 dagar, 90 dagar ↔ 90 och så vidare.
  • Dölj produkterna från din offentliga lava.top-sida med inställningen synlighet. Aktivera inte ”Pris på begäran via API”: CreateYourVPN fungerar för närvarande med erbjudanden med fast pris. Ett direktköp på lava.top kommer utan vår markering och kanske inte kan kopplas till en plan; då visas det som ”Utan koppling”. Dolda produkter med fast pris syns fortfarande i vår erbjudandeväljare.

Priset på en produkt kallar lava.top för ett erbjudande (offer). En produkt kan ha flera erbjudanden (olika valutor och perioder) — och det är just erbjudandet du sedan väljer för varje plan.

Vad ett upprepat köp gör

En engångsprodukt har inga förnyelser: när kunden behöver mer köper hen helt enkelt igen. Det är ett normalt scenario, och att köpa i förväg är säkert — dagarna läggs till det som är kvar, de räknas inte om från noll. Tio återstående dagar plus en färsk månad blir fyrtio dagar.

Ett undantag, om planen även ger trafik: kvoten ersätts, den summeras inte. En kund som köpt 100 GB, gjort av med 30 och köper samma plan igen hamnar på färska 100 GB, inte 170. Ha det i åtanke när du prissätter trafikplaner.

Steg 3. Koppla kontot i CreateYourVPN

Allt som behövs på lava.top-sidan finns på ett ställe: Integrations i vänstermenyn, kortet API.

Avsnittet ”Integrations” i lava.top: korten API och Web-Widget

Skapa en API-nyckel

Öppna kortet API och tryck på ”Create API key”. Nyckeln visas en enda gång — kopiera den direkt: lava.top visar den inte en andra gång, och en förlorad nyckel kan bara ersättas med en ny.

Sidan med API-nycklar: knappen ”Create API key” och länken till webhook-historiken

Klistra in nyckeln i din panel

Öppna avsnittet ”Monetarisering” i CreateYourVPN, tryck på ”Anslut” på kortet lava.top, klistra in nyckeln i fältet ”lava.top API-nyckel” och spara.

Vi kontrollerar nyckeln direkt och svarar antingen ”Nyckeln godkänd” — med antalet produkter som hittats på kontot — eller ”lava.top godtog inte den här nyckeln”.

Direkt efter att du sparat dyker två värden till upp i samma formulär: webhook-URL och webhook-nyckeln. Dem klistrar du in i lava.top i nästa steg. Webhook-nyckeln genererar vi — du behöver inte hitta på något.

Lägg upp webhooken

lava.top föreslår det direkt efter att nyckeln skapats — tryck på ”+ Add Webhook”. Samma knapp finns även senare, på API-sidan.

Fönstret ”API key successfully added” med knappen ”+ Add Webhook”

Det räcker med en webhook — i fältet för händelsetyp bockar du i alla typer du behöver på en gång:

Formuläret för att lägga till en webhook: URL, händelsetyp, autentiseringstyp och fältet för API-nyckeln

URL — webhook-adressen från din panel. lava.top godtar bara HTTPS; vår adress är just det.

Event type — bocka i båda typerna: ”Payment result” och ”Recurring payment”. Listan tillåter flerval, så någon andra webhook behövs inte.

Type of authentication for Webhook — välj ”API key of your service” och klistra in webhook-nyckeln från panelen i fältet ”API key”. (Basic fungerar också — vi godtar det — men det är två fält i stället för ett.)

Comment — valfritt, för dig själv: en notering som ”CreateYourVPN — betalningar” hjälper när du har flera integrationer.

Någon signatur på anropet har lava.top inte alls, så det är just webhook-nyckeln som talar om för vår mottagare att leveransen kommer från ditt konto — behandla den som ett lösenord.

Bocka inte ur ”Recurring payment” om du säljer prenumerationer: utan den händelsetypen når förnyelserna oss inte och en betalande kunds åtkomst tar helt enkelt slut. För engångsprodukter räcker ”Payment result”, men det är lika säkert att låta båda vara ibockade.

Vad API-nyckeln ger oss

Nycklar ”endast för läsning” har lava.top inte — en API-nyckel ger full åtkomst till författarkontot. Vi använder den till exakt tre saker: att skapa en betalning i det ögonblick kunden trycker ”Betala”; att läsa din produktkatalog för erbjudandeväljaren; att säga upp en prenumeration när kunden stänger av den automatiska förnyelsen i sin panel. Vi ändrar inga priser, rör inte exporten av din försäljning och gör inget annat med den här nyckeln. Nyckeln lagras krypterad, visas inte igen någonstans och hamnar inte i våra loggar. Vill du klippa åtkomsten — ta bort kopplingen i panelen, nyckeln raderas med den.

Steg 4. Koppla erbjudanden till dina planer

Öppna ”Planer”, gå in i en plan och hitta blocket lava.top:

Tryck på ”Hämta produkter” — vi hämtar katalogen från ditt lava.top-konto.

Välj det erbjudande som den här planen säljs som. I listan syns produkt, pris och dragningsperiod.

Kolla varningarna, om några dyker upp. Panelen säger till när erbjudandet saknar pris i planens valuta och när dragningsperioden inte stämmer med planens längd (”drar var 30:e dag, men planen ger 365”).

Nyss skapat en produkt i lava.top och ser den inte i listan? Tryck på ”Uppdatera listan” — katalogen cachas i en minut.

Köparen kan växla mellan alla valutor som finns i det valda erbjudandet. Vid en engångsbetalning i rubel visar vi kort och SBP, vid en prenumeration i rubel endast kort. I dollar och euro finns kort och PayPal.

Steg 5. Kontrollera med en riktig betalning

Köp den billigaste planen själv, från ett kundkonto i din butik. Inom en minut bör planen dyka upp på det kontot, och betalningen i journalen med statusen ”Behandlad” (avsnittet ”Monetarisering”).

Om det inte händer:

  • händelsen finns inte alls i journalen — webhooken i lava.top pekar på fel adress, har inte de nödvändiga händelsetyperna ibockade, eller så stämmer inte webhook-nyckeln med den i panelen. lava.top har en webhook-historik med en knapp för att skicka om — börja där;
  • händelsen finns, men ”Utan koppling” — vi kunde inte avgöra vems betalningen är eller vilken plan den gäller. Koppla den för hand direkt i journalen: prenumerationen tilldelas av samma kod som vid en automatisk betalning;
  • ”Kräver åtgärd” — betalningen kräver ett mänskligt beslut: kunden är blockerad i din panel, eller så har planen kopplats om till en annan lava.top-produkt efter att betalningen skapades. Här rör vi inte åtkomsten på eget bevåg — det är du som bestämmer.

Om en prenumerationsförnyelse inte kan debiteras gör lava.top ytterligare två försök — efter 8 och 24 timmar — och skickar meddelandet om misslyckad betalning först efter det sista. Vi tar inte bort åtkomsten: den redan betalda perioden löper alltid till slut. Ett uppsägningsmeddelande betyder bara att ingen ny förnyelse kommer.

Om pengarna

  • lava.tops provision är 8 % av varje lyckad betalning. Den dras direkt och betalas inte tillbaka om du senare återbetalar kunden.
  • Återbetalning görs från lava.top-panelen, avsnittet ”Försäljning”; en återbetalning på en prenumeration säger upp prenumerationen. Någon egen webhook-typ för återbetalningar och chargebacks har lava.top ännu inte, så dem ser du i lava.top-panelen och inte i vår journal.
  • Avsluta automatisk förnyelse. Kunden kan göra det själv i sin panel i din butik — då ber vi lava.top säga upp prenumerationen — eller på sitt eget lava.top-konto; du kan också säga upp den åt hen från din lava.top-panel. En uppsägning tar inte bort åtkomsten: den gäller till slutet av den redan betalda perioden, och vi slutar helt enkelt vänta på nästa dragning.
  • En chargeback kan inledas upp till 540 dagar efter betalningen, och du har 3 dagar på dig att lämna bevis. Spara villkoren i din butik och korrespondensen med kunden — så ser bevis ut.
  • Betalningsgränserna beror på produkttypen. Minimum är alltid 50 ₽ / 5 $ / 5 €. För prenumerationer är maximum 300 000 ₽ / 3 000 $ / 3 000 €, och för engångsprodukter 1 000 000 ₽ / 10 000 $ / 10 000 €.

Om en nyckel läcker

På lava.top-kortet finns två olika knappar, och de gör olika saker:

  • ”Förnya webhook-nyckeln” — utfärdar en ny nyckel för inkommande aviseringar. Det nya värdet måste klistras in i webhooken i lava.top; tills du gjort det bekräftas inga betalningar.
  • ”Rotera webhook-URL” — utfärdar en ny adress. Den gamla slutar fungera omedelbart, och även den måste uppdateras i webhooken.

Har själva API-nyckeln läckt — återkalla den i lava.top, skapa en ny och klistra in den i panelen.

On this page