Betalingen accepteren met lava.top
Stap-voor-stap handleiding: koppel lava.top aan CreateYourVPN zodat je klanten hun saldo in je etalage opwaarderen. API-sleutel, webhook, opwaardeerbedragen en automatisch opwaarderen.
lava.top accepteert kaarten, SBP en PayPal in roebels, dollars en euro's. Je klanten waarderen er hun saldo mee op in het klantportaal van je etalage, en met dat saldo kopen ze pakketten: toegang met de hand verlenen hoeft niet.
lava.top werkt met vaste bedragen: de klant kiest een van de opwaardeerbedragen die jij instelt, en elk bedrag heeft een eigen aanbieding met dezelfde prijs. Zelf een bedrag invoeren kan de klant niet. Wil je elk willekeurig bedrag toestaan, koppel dan ook PayHot.
Het geld gaat naar je eigen lava.top-account. CreateYourVPN is geen tussenpersoon bij de betalingen en neemt geen commissie op je verkopen.
Betalingen accepteren hoort bij het betaalde pakket Max: daarmee gaat je etalage verkopen, en het klantsaldo gaat vanzelf aan. Over de prijzen van het platform: zie de les over facturatie.
Wat je nodig hebt
- een account op lava.top (een auteursaccount, dus het account dat verkoopt);
- 10–15 minuten voor de eerste instelling;
- een klein bedrag voor een testopwaardering: lava.top heeft geen testomgeving, dus de enige manier om de hele instelling te controleren is een echte betaling (minimaal 50 ₽ / 5 $ / 5 €).
Stap 1. Registratie en verificatie
Registreer je op lava.top en vul je profiel in: met een leeg profiel oogt de betaalpagina onaf voor de koper.
Ga daarna naar Balance → verificatie en rond die af: document en selfie, 18+, zonder ingeschakelde VPN.
Verkopen mag ook vóór de verificatie, maar geld uitbetalen zonder verificatie niet. Stel het niet uit tot je eerste uitbetaling.
Stap 2. Maak je producten aan
De prijs van een lava.top-aanbieding is het opwaardeerbedrag. Maak zoveel aanbiedingen aan als je bedragen aan je klanten wilt aanbieden.
- Eenmalige opwaardering: een digitaal product, cursus of consult met een vaste prijs. Eén aanbieding levert één bedrag op, bijvoorbeeld 300, 500 of 1000 ₽.
- Automatisch opwaarderen: een product van het type «Abonnement». lava.top schrijft de prijs van de aanbieding zelf af volgens een eigen schema (elke maand, elke 3 maanden, elk halfjaar of elk jaar), en elke afschrijving waardeert het saldo van de klant op.
- De aanbieding moet een prijs hebben in de valuta van het klantaccount. De valuta zie je in het onderdeel «Monetisering», op de kaart «Klantsaldo». lava.top accepteert roebels, dollars en euro's.
- Verberg de producten op je openbare lava.top-pagina via de instelling zichtbaarheid. Schakel «Prijs op aanvraag via API» niet in: CreateYourVPN werkt met aanbiedingen met een vaste prijs. Een aankoop rechtstreeks op je lava.top-pagina komt zonder onze markering binnen, en dan weten we niet van wie de betaling is. Verborgen producten met een vaste prijs blijven zichtbaar in je paneel.
Een aanbieding in lava.top is een verkoopvariant van een product met een bepaalde prijs en factureringsperiode. Eén product kan meerdere aanbiedingen hebben, en in het paneel kies je voor elk bedrag de juiste.
Stap 3. Koppel het account in CreateYourVPN
Alles wat je aan de lava.top-kant nodig hebt, zit op één plek: Integrations in het linkermenu, de kaart API.

Maak een API-sleutel aan
Open de kaart API en druk op «Create API key». De sleutel wordt één keer getoond, dus kopieer hem meteen: lava.top laat hem geen tweede keer zien, en een verloren sleutel kun je alleen vervangen door een nieuwe.

Plak de sleutel in je paneel
Open in CreateYourVPN het onderdeel «Monetisering», druk op «Verbinden» op de kaart lava.top, plak de sleutel in het veld «lava.top API-sleutel» en sla op.
We controleren de sleutel meteen en antwoorden met «Sleutel geaccepteerd», samen met het aantal gevonden producten in je account, of met «lava.top heeft deze sleutel niet geaccepteerd».
Direct na het opslaan verschijnen in hetzelfde formulier nog twee waarden: de Webhook URL en de webhook-sleutel. Die plak je in de volgende stap in lava.top. De webhook-sleutel genereren wij, je hoeft niets te verzinnen.
Maak de webhook aan
lava.top biedt dit meteen na het aanmaken van de sleutel aan: druk op «+ Add Webhook». Dezelfde knop blijft later beschikbaar op de API-pagina.

Je hebt maar één webhook nodig: in het veld voor het gebeurtenistype vink je alle gebeurtenissen in één keer aan.

URL: het webhookadres uit je paneel. lava.top accepteert alleen HTTPS, en het onze is dat al.
Gebeurtenistype: vink alle gebeurtenissen in de lijst aan. Het is een meervoudige keuze, een tweede webhook is dus niet nodig.
Type of authentication for Webhook: kies «API key of your service» en plak in het veld «API key» de webhook-sleutel uit je paneel. Basic kan ook, dat accepteren we, maar dan zijn het twee velden in plaats van één.
Comment: optioneel, voor jezelf. Een notitie als «CreateYourVPN, betalingen» helpt als je meerdere integraties hebt.
lava.top voegt geen cryptografische handtekening aan de requestbody toe, daarom verifieert de webhook-sleutel de aflevering. Behandel hem als een wachtwoord.
Laat geen enkele gebeurtenis uitgevinkt: zonder de gebeurtenissen voor terugkerende betalingen komen de automatische opwaarderingen van je klanten nooit op hun saldo aan. Alles aanvinken is altijd veilig.
Wat de API-sleutel ons geeft
lava.top heeft geen «alleen-lezen»-sleutels: een API-sleutel geeft volledige toegang tot het auteursaccount. We gebruiken hem voor precies drie dingen: een betaling aanmaken op het moment dat de klant op «Betalen» klikt; je productcatalogus lezen zodat je in het paneel aanbiedingen kunt kiezen; een abonnement opzeggen wanneer de klant in zijn klantportaal automatisch opwaarderen of de automatische verlenging uitzet. We wijzigen geen prijzen, exporteren je verkopen niet en doen verder niets met deze sleutel. Hij wordt versleuteld bewaard, wordt nergens opnieuw getoond en komt niet in onze logs. Wil je de toegang ooit afsnijden, verwijder dan de koppeling in het paneel: de sleutel wordt mee verwijderd.
Stap 4. Voeg opwaardeerbedragen toe
Open «Pakketten» en zoek het blok «Saldo-opwaardering».
Klik op «Opwaardering toevoegen», kies een eenmalige aanbieding in de lijst «lava.top-aanbieding» en klik in het venster op «Opwaardering toevoegen». Het bedrag wordt gelijk aan de prijs van de aanbieding. Voeg zo elk bedrag toe, tot 20 in totaal.
Voor automatisch opwaarderen klik je op «Automatisch opwaarderen toevoegen», kies je een lava.top-abonnement en klik je in het venster op «Automatisch opwaarderen toevoegen». De aanbieding bepaalt het bedrag en de frequentie, bijvoorbeeld 500 ₽ elke maand. Het paneel laat zien voor welk pakket zo'n opwaardering genoeg is.
Controleer de waarschuwingen bij de regels, als die er zijn. Het paneel meldt het wanneer de aanbieding geen prijs heeft in de valuta van het saldo, wanneer de aanbieding iets anders kost dan het bedrag en wanneer de aanbieding niet meer in lava.top staat.
Net een product in lava.top aangemaakt en zie je het niet in de lijst? Druk op «Lijst verversen»: de catalogus wordt een minuut gecachet.
Zolang je geen bedrag hebt toegevoegd en PayHot niet hebt gekoppeld, kunnen je klanten nergens mee opwaarderen: in het venster «Saldo opwaarderen» zien ze «Opwaarderen is nog niet mogelijk». Voeg minstens één bedrag toe dat niet lager is dan de prijs van je duurste pakket: dan kan een klant met een leeg saldo in één betaling opwaarderen en het pakket kopen, met de knop «Opwaarderen en kopen».
In het pakket zelf kies je geen aanbieding: een pakket in de accountvaluta wordt met het saldo gekocht. De uitzondering is een pakket met een prijs in een andere valuta dat eerder aan een aanbieding is gekoppeld: dat betaalt de klant rechtstreeks via lava.top.
Wat de klant ziet
In het klantportaal van je etalage klikt de klant op «Opwaarderen». Op het tabblad «Eenmalig» kiest hij een van je bedragen en een betaalmethode: een kaart, SBP (alleen roebels) of PayPal als de aanbieding een prijs in dollars of euro's heeft. Op het tabblad «Automatisch» zet hij automatisch opwaarderen aan: met een kaart of PayPal, want lava.top-abonnementen accepteren geen SBP. Op het saldo komt altijd het opwaardeerbedrag in de accountvaluta, ook als de klant in een andere valuta heeft betaald.
Voor automatisch opwaarderen is een abonnementspakket nodig met een looptijd en een prijs in de accountvaluta: zonder zo'n pakket heeft de klant geen tabblad «Automatisch». Automatisch opwaarderen werkt samen met de automatische verlenging van het pakket uit het saldo: de automatische verlenging gaat vanzelf aan wanneer de klant automatisch opwaarderen aanzet, en heeft de klant nog geen pakket, dan koopt de eerste afschrijving het. Een klant heeft maar één automatische opwaardering.
Stap 5. Controleer met een echte betaling
Waardeer vanuit een klantaccount in je etalage het saldo op met het kleinste bedrag. Binnen een minuut hoort het geld op het saldo te staan, en in het onderdeel «Monetisering», in het «Betaaljournaal», hoort een saldo-opwaardering te verschijnen met de status «Verwerkt». Koop daarna een pakket met het saldo.
Gebeurt dat niet:
- de gebeurtenis staat helemaal niet in het journaal: de webhook in lava.top wijst naar het verkeerde adres, heeft niet alle gebeurtenissen aangevinkt, of de sleutel ervan komt niet overeen met die in het paneel. lava.top heeft een webhookgeschiedenis met een knop om opnieuw te versturen, een goede plek om te beginnen;
- de gebeurtenis staat er wel, maar het geld staat niet op het saldo: bij de gebeurtenis staat de melding «Niet bijgeschreven op het saldo» met een hint. Controleer de betaling in lava.top en schrijf het bedrag bij met een correctie in de klantkaart;
- «Niet gekoppeld»: we konden niet vaststellen van wie de betaling is. Dat gebeurt als een klant een product rechtstreeks op je lava.top-pagina heeft gekocht, buiten de etalage om. Zoek de klant op en schrijf het bedrag bij met een correctie in zijn klantkaart;
- «Vraagt aandacht»: de gebeurtenis vraagt om jouw beslissing, en wat je moet doen, staat bij de gebeurtenis zelf.
Mislukt een afschrijving voor een abonnement, dan probeert lava.top het nog twee keer, na 8 en 24 uur, en stuurt pas na de laatste poging een melding van de mislukte betaling. De klant ziet in zijn klantportaal dat de laatste afschrijving niet is gelukt. Het geld dat al op het saldo staat, blijft van de klant.
Over het geld
- De commissie van lava.top is 8 % van elke geslaagde betaling. Ze wordt meteen ingehouden en niet teruggegeven als je de klant later terugbetaalt.
- Terugbetalen doe je vanuit de lava.top-omgeving, onderdeel «Verkopen»; een terugbetaling op een abonnement zegt het abonnement op. Een melding over een terugbetaling of chargeback komt in het journaal binnen met de status «Vraagt aandacht». Het saldo van de klant gaat na een terugbetaling niet vanzelf omlaag: schrijf hetzelfde bedrag af met een correctie in de klantkaart.
- Automatisch opwaarderen uitzetten. De klant zet het uit in het klantportaal van je etalage, en wij vragen lava.top het abonnement op te zeggen. Zet de klant de automatische verlenging van zijn pakket uit, dan gaat automatisch opwaarderen ook uit. Je kunt het abonnement ook opzeggen in de lava.top-omgeving. Het geld op het saldo vervalt in geen geval.
- Een chargeback kan tot 540 dagen na de betaling worden aangevraagd, en je hebt 3 dagen om bewijs aan te leveren. Bewaar je verkoopvoorwaarden, de correspondentie met de klant en bewijs dat de toegang is verleend.
- De betaallimieten hangen af van het producttype. Het minimum is altijd 50 ₽ / 5 $ / 5 €. Voor abonnementen is het maximum 300 000 ₽ / 3 000 $ / 3 000 €; voor eenmalige producten 1 000 000 ₽ / 10 000 $ / 10 000 €.
Als een sleutel uitlekt
Op de lava.top-kaart staan twee verschillende knoppen, en ze doen verschillende dingen:
- «Webhook-sleutel vernieuwen» geeft een nieuwe sleutel uit voor binnenkomende meldingen. Plak de nieuwe waarde in de webhook in lava.top; tot je dat doet, worden betalingen niet bevestigd.
- «Webhook-URL roteren» geeft een nieuw adres uit. Het oude werkt meteen niet meer; werk het ook in de webhook bij.
Is de API-sleutel zelf uitgelekt, trek hem dan in bij lava.top, maak een nieuwe aan en plak die in je paneel.
Hoe je je server instelt (modus «Eén server»)
Stapsgewijze gids: hoe je je VPS verbindt met CreateYourVPN in de modus «Eén server» — van het huren van een server tot een werkende persoonlijke VPN binnen enkele minuten.
Betalingen accepteren met PayHot
Stap-voor-stap handleiding: koppel PayHot aan CreateYourVPN zodat je klanten hun saldo met elk bedrag opwaarderen, met een bankpas, via SBP of met cryptovaluta. Aanvraag, API-sleutel, webhook, betaalmethoden en automatisch opwaarderen.