Betalingen accepteren met lava.top
Stap-voor-stap handleiding: hoe je je lava.top-account aan CreateYourVPN koppelt zodat de betaling van een klant vanzelf een abonnement wordt — API-sleutel, één webhook, aanbiedingen aan je abonnementen koppelen.
lava.top is een betaalprovider die kaarten, SBP en PayPal accepteert in roebels, dollars en euro's. Je koppelt hem één keer — en een betaling in je etalage wordt vanzelf een actief abonnement: toegang met de hand verlenen hoeft niet.
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 — dat zet de etalage in verkoopmodus. Over de prijzen van het platform: zie de les over facturatie.
Wat je nodig hebt
- een account op lava.top (een auteursaccount — degene die verkoopt);
- 10–15 minuten voor de eerste instelling;
- een klein bedrag voor een testbetaling: lava.top heeft geen testomgeving, dus de enige manier om de hele instelling te controleren is een echte aankoop (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: 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
Maak in lava.top één of meer producten aan voor je abonnementen. Elk CreateYourVPN-abonnement heeft een passende aanbieding nodig, maar één lava.top-product kan meerdere aanbiedingen bevatten, bijvoorbeeld voor maandelijkse en jaarlijkse betaling.
- Voor een terugkerend abonnement kies je het producttype «Abonnement» — dan schrijft lava.top zelf af, en elke verlenging verlengt de toegang bij ons.
- Gebruik voor een eenmalige aankoop een digitaal product, cursus of consult met een vaste prijs.
- Controleer dat de aanbieding een prijs heeft in ten minste één ondersteunde valuta: RUB, USD of EUR. De valuta van het abonnement is in de etalage vooraf geselecteerd, maar de koper kan overschakelen naar elke andere valuta die in de aanbieding beschikbaar is.
- Stem de incassoperiode af op de looptijd van het abonnement: maandproduct ↔ 30 dagen, 90 dagen ↔ 90, enzovoort.
- Verberg de producten op je openbare lava.top-pagina via de instelling zichtbaarheid. Schakel «Prijs op aanvraag via API» niet in: CreateYourVPN werkt momenteel met aanbiedingen met een vaste prijs. Een rechtstreekse aankoop op je lava.top-pagina komt zonder onze markering binnen en kan mogelijk niet aan een abonnement worden gekoppeld; dan verschijnt die als «Niet gekoppeld». Verborgen producten met een vaste prijs blijven in onze aanbiedingenkiezer zichtbaar.
Een aanbieding is een verkoopvariant van een product met een bepaalde prijs en factureringsperiode. Eén product kan meerdere aanbiedingen hebben; later kies je voor elk abonnement de passende aanbieding.
Wat een herhaalaankoop doet
Een eenmalig product kent geen verlengingen: wil de klant meer, dan koopt hij simpelweg opnieuw. Dat is een normaal scenario, en vooruit kopen is veilig — de dagen worden bij het restant opgeteld, ze beginnen niet opnieuw. Tien resterende dagen plus een verse maand geven veertig dagen.
Eén uitzondering, als het abonnement ook verkeer geeft: de bundel wordt vervangen, niet opgeteld. Een klant die 100 GB kocht, 30 verbruikte en hetzelfde abonnement opnieuw koopt, komt uit op verse 100 GB, niet op 170. Houd daar rekening mee bij het prijzen van verkeersabonnementen.
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 — 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 omgeving
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 «Sleutel geaccepteerd» — met het aantal gevonden producten in het account — of «lava.top accepteerde deze sleutel niet».
Direct na het opslaan verschijnen in hetzelfde formulier nog twee waarden: de Webhook URL en de webhooksleutel. Die plak je in de volgende stap in lava.top. De webhooksleutel 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 benodigde typen tegelijk aan:
URL — het webhookadres uit je omgeving. lava.top accepteert alleen HTTPS; het onze is dat al.
Event type — vink beide typen aan: «Payment result» en «Recurring payment». De lijst laat meerdere keuzes toe, 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 webhooksleutel uit je omgeving. (Basic kan ook — we accepteren het —, maar dat zijn 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; de geheime webhooksleutel verifieert daarom de aflevering. Behandel hem als een wachtwoord.
Vink «Recurring payment» niet uit als je abonnementen verkoopt: zonder dat gebeurtenistype bereiken verlengingen ons niet en loopt de toegang van een betalende klant gewoon af. Voor eenmalige producten is «Payment result» genoeg, maar beide aangevinkt laten kan prima.
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 voor de aanbiedingenkiezer; een abonnement opzeggen wanneer de klant de automatische verlenging in zijn omgeving uitzet. We wijzigen geen prijzen, raken de export van je verkopen niet aan 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 afsnijden — verwijder de koppeling in je omgeving, dan wordt de sleutel mee verwijderd.
Stap 4. Koppel aanbiedingen aan je abonnementen
Open «Abonnementen», ga een abonnement in en zoek het blok lava.top:
Druk op «Producten laden» — we halen de catalogus uit je lava.top-account.
Kies de aanbieding waarmee dit abonnement wordt verkocht. In de lijst zie je het product, de prijs en de incassoperiode.
Controleer de waarschuwingen, als die verschijnen. Je omgeving zegt het wanneer de aanbieding geen prijs heeft in de valuta van het abonnement en wanneer de incassoperiode afwijkt van de looptijd («schrijft elke 30 dagen af, maar het abonnement geeft er 365»).
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.
De koper kan wisselen tussen alle valuta's die in de gekozen aanbieding beschikbaar zijn. Voor een eenmalige betaling in roebels tonen we kaart en SBP; voor een roebelabonnement alleen kaart. In dollars en euro's zijn kaart en PayPal beschikbaar.
Stap 5. Controleer met een echte betaling
Koop zelf het goedkoopste abonnement vanuit een klantaccount in je etalage. Binnen een minuut hoort het abonnement in dat account te verschijnen en de betaling in het journaal met de status «Verwerkt» (onderdeel «Monetisering»).
Gebeurt dat niet:
- de gebeurtenis staat helemaal niet in het journaal — de webhook in lava.top wijst naar het verkeerde adres, heeft de benodigde gebeurtenistypen niet aangevinkt, of de webhooksleutel komt niet overeen met die in je omgeving. lava.top heeft een webhookgeschiedenis met een knop om opnieuw te versturen — begin daar;
- de gebeurtenis staat er wel, maar «Niet gekoppeld» — we konden niet vaststellen van wie de betaling is en voor welk abonnement. Koppel hem met de hand in het journaal zelf: het abonnement wordt verleend door dezelfde code als bij een automatische betaling;
- «Vraagt aandacht» — de betaling vraagt om een menselijke beslissing: de klant is geblokkeerd in je omgeving, of het abonnement is na het aanmaken van de betaling aan een ander lava.top-product gekoppeld. Hier raken we de toegang niet uit onszelf aan — jij beslist.
Kan een verlenging niet worden geïncasseerd, dan probeert lava.top het na 8 en 24 uur nog twee keer en stuurt pas na de laatste poging een melding van de mislukte betaling. We trekken de toegang niet in: de al betaalde periode loopt altijd tot het einde. Een opzeggingsmelding betekent alleen dat er geen volgende verlenging komt.
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. Voor terugbetalingen en chargebacks heeft lava.top nog geen eigen webhooktype, dus die zie je in de lava.top-omgeving en niet in ons journaal.
- Automatische verlenging opzeggen. De klant kan dat zelf doen in zijn omgeving op jouw etalage — wij vragen lava.top dan het abonnement op te zeggen — of in zijn eigen lava.top-account; jij kunt het ook voor hem opzeggen vanuit jouw lava.top-omgeving. Een opzegging neemt de toegang niet af: die loopt door tot het einde van de al betaalde periode, en wij verwachten simpelweg de volgende incasso niet meer.
- Een chargeback kan tot 540 dagen na de betaling worden aangevraagd, en je hebt 3 dagen om bewijs aan te leveren. Bewaar de voorwaarden van je etalage en de correspondentie met de klant — zo ziet bewijs eruit.
- 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. De nieuwe waarde moet je in de webhook in lava.top plakken; tot dan worden betalingen niet bevestigd.
- «Webhook-URL roteren» — geeft een nieuw adres uit. Het oude werkt meteen niet meer; ook dat moet je in de webhook bijwerken.
Is de API-sleutel zelf uitgelekt — trek hem in bij lava.top, maak een nieuwe aan en plak die in je omgeving.
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.
Happ
Hoe je de Happ-app op je telefoon of computer installeert, wat je doet als hij niet beschikbaar is in jouw land, en hoe je verbinding maakt met de link uit je account.