CreateYourVPN Academy
Guies

Acceptar pagaments amb lava.top

Guia pas a pas: com connectar el teu compte de lava.top amb CreateYourVPN perquè el pagament d'un client es converteixi sol en una subscripció — clau API, un webhook i vinculació d'ofertes amb els teus plans.

lava.top és un proveïdor de pagaments que accepta targetes, SBP i PayPal en rubles, dòlars i euros. El connectes una vegada — i el pagament al teu aparador es converteix sol en una subscripció activa: no cal concedir l'accés a mà.

Els diners van al teu propi compte de lava.top. CreateYourVPN no és intermediari en els pagaments i no cobra comissió per les teves vendes.

Acceptar pagaments forma part del pla de pagament Max — és el que posa l'aparador en mode de venda. Sobre els preus de la plataforma, mira la lliçó sobre facturació.

Què necessites

  • un compte a lava.top (un compte d'autor — el que ven);
  • 10–15 minuts per a la configuració inicial;
  • una quantitat petita per a un pagament de prova: lava.top no té entorn de proves, així que l'única manera de comprovar tota la configuració és una compra real (mínim 50 ₽ / 5 $ / 5 €).

Pas 1. Registre i verificació

Registra't a lava.top i omple el perfil — amb el perfil buit la pàgina de pagament sembla inacabada al comprador.

Després entra a Balance → verificació: document i selfie, 18+, sense VPN activada.

Vendre pots fer-ho fins i tot abans de la verificació, però retirar els diners sense ella no. No la deixis per al primer cobrament.

Pas 2. Crea els teus productes

A lava.top crea un o diversos productes per als teus plans. Cada pla de CreateYourVPN necessita una oferta corresponent, però un mateix producte de lava.top pot contenir diverses ofertes, per exemple mensual i anual.

  • Per a un pla recurrent tria el tipus de producte «Subscripció» — llavors lava.top cobrarà sola i cada renovació allargarà l'accés amb nosaltres.
  • Per a una compra única, utilitza un producte digital, un curs o una consulta amb preu fix.
  • Comprova que l'oferta tingui preu en almenys una moneda compatible: RUB, USD o EUR. La moneda del pla queda preseleccionada a l'aparador, però el comprador pot canviar a qualsevol altra moneda disponible a l'oferta.
  • Ajusta el període de cobrament a la durada del pla: producte mensual ↔ 30 dies, 90 dies ↔ 90, i així successivament.
  • Amaga els productes de la teva pàgina pública de lava.top amb l'ajust de visibilitat. No activis «Preu a consultar per API»: CreateYourVPN funciona actualment amb ofertes de preu fix. Una compra directa des de la pàgina de lava.top arriba sense la nostra marca i potser no es podrà vincular a cap pla; aleshores apareixerà com a «Sense vincular». Els productes amagats de preu fix continuen apareixent al nostre selector d'ofertes.

Una oferta és una modalitat de venda del producte amb un preu i un període de cobrament determinats. Un producte pot tenir diverses ofertes; després triaràs la que correspongui a cada pla.

Què passa amb una compra repetida

Un producte únic no té renovacions: quan el client en vol més, simplement torna a comprar. És un escenari normal, i comprar per endavant és segur — els dies se sumen al que queda, no es compten des de zero. Deu dies restants més un mes nou fan quaranta dies.

Una excepció, si el pla també dona trànsit: la quota es substitueix, no se suma. Un client que va comprar 100 GB, en va gastar 30 i torna a comprar el mateix pla acaba amb 100 GB nous, no amb 170. Tingues-ho en compte en els preus dels plans amb trànsit.

Pas 3. Connecta el compte a CreateYourVPN

Tot el que cal a la banda de lava.top és al mateix lloc: Integrations al menú de l'esquerra, la targeta API.

La secció «Integrations» a lava.top: les targetes API i Web-Widget

Crea una clau API

Obre la targeta API i prem «Create API key». La clau es mostra una sola vegada — copia-la de seguida: lava.top no la mostrarà una segona vegada i una clau perduda només es pot substituir per una de nova.

La pàgina de claus API: el botó «Create API key» i l'enllaç a l'historial de webhooks

Enganxa la clau al teu panell

A CreateYourVPN obre la secció «Monetització», prem «Connecta» a la targeta lava.top, enganxa la clau al camp «Clau API de lava.top» i desa.

Comprovem la clau a l'instant i responem «Clau acceptada» — amb el nombre de productes trobats al compte — o «lava.top no ha acceptat aquesta clau».

Just després de desar apareixen al mateix formulari dos valors més: l'URL del webhook i la clau del webhook. Són els que enganxaràs a lava.top al pas següent. La clau del webhook la generem nosaltres — no has d'inventar res.

Crea el webhook

lava.top t'ho proposa just després de crear la clau — prem «+ Add Webhook». El mateix botó també hi és després, a la pàgina API.

La finestra «API key successfully added» amb el botó «+ Add Webhook»

Només cal un webhook: al camp del tipus d'esdeveniment es marquen alhora tots els tipus necessaris:

El formulari per afegir un webhook: URL, tipus d'esdeveniment, tipus d'autenticació i el camp de la clau API

URL — l'adreça del webhook del teu panell. lava.top només accepta HTTPS; la nostra ja ho és.

Event type — marca els dos tipus: «Payment result» i «Recurring payment». La llista és de selecció múltiple, així que no cal un segon webhook.

Type of authentication for Webhook — tria «API key of your service» i enganxa al camp «API key» la clau del webhook del panell. (Basic també funciona — l'acceptem —, però són dos camps en comptes d'un.)

Comment — opcional, per a tu: una nota com «CreateYourVPN — pagaments» ajuda quan tens diverses integracions.

lava.top no afegeix una signatura criptogràfica al cos de la petició, de manera que la clau secreta del webhook autentica el lliurament. Tracta-la com una contrasenya.

No desmarquis «Recurring payment» si vens subscripcions: sense aquest tipus d'esdeveniment les renovacions no ens arriben i l'accés d'un client que paga simplement s'acaba. Per a productes de pagament únic n'hi ha prou amb «Payment result», però deixar els dos marcats és igual de segur.

Què ens dona la clau API

lava.top no té claus «només de lectura» — una clau API dona accés complet al compte d'autor. La fem servir exactament per a tres coses: crear el pagament en el moment que el client prem «Pagar»; llegir el teu catàleg de productes per al selector d'ofertes; cancel·lar una subscripció quan el client desactiva la renovació automàtica al seu panell. No canviem preus, no toquem l'exportació de les teves vendes i no fem res més amb aquesta clau. La clau es desa xifrada, no es torna a mostrar enlloc i no arriba als nostres registres. Si vols tallar l'accés — esborra la connexió al panell, la clau s'esborra amb ella.

Pas 4. Vincula les ofertes amb els teus plans

Obre «Plans», entra en un pla i troba el bloc lava.top:

Prem «Carregar productes» — portarem el catàleg del teu compte de lava.top.

Tria l'oferta amb què es ven aquest pla. A la llista es veuen el producte, el preu i el període de cobrament.

Revisa els avisos, si n'apareixen. El panell et dirà quan l'oferta no té preu en la moneda del pla i quan el període de cobrament no coincideix amb la durada del pla («cobra cada 30 dies, però el pla dona 365»).

Acabes de crear un producte a lava.top i no el veus a la llista? Prem «Actualitzar la llista» — el catàleg es guarda en memòria cau durant un minut.

El comprador pot canviar entre totes les monedes disponibles a l'oferta seleccionada. Per a un pagament únic en rubles mostrem targeta i SBP; per a una subscripció en rubles, només targeta. En dòlars i euros estan disponibles targeta i PayPal.

Pas 5. Comprova-ho amb un pagament real

Compra tu mateix el pla més barat des d'un compte de client al teu aparador. En un minut el pla hauria d'aparèixer en aquell compte, i el pagament al registre amb l'estat «Processat» (secció «Monetització»).

Si no passa:

  • l'esdeveniment no és al registre en absolut — el webhook de lava.top apunta a l'adreça equivocada, no té marcats els tipus d'esdeveniment necessaris, o la seva clau no coincideix amb la del panell. lava.top té un historial de webhooks amb botó de reenviament — comença per aquí;
  • l'esdeveniment hi és, però «Sense vincular» — no hem sabut de qui és el pagament ni per a quin pla. Vincula'l a mà al mateix registre: la subscripció es concedirà amb el mateix codi que en un pagament automàtic;
  • «Requereix atenció» — el pagament demana una decisió humana: el client està bloquejat al teu panell, o el pla s'ha vinculat a un altre producte de lava.top després de crear el pagament. Aquí no toquem l'accés pel nostre compte — decideixes tu.

Si no es pot cobrar una renovació, lava.top fa dos intents més, al cap de 8 i 24 hores, i només envia l'avís de pagament fallit després de l'últim. No retirem l'accés: el període ja pagat sempre arriba fins al final. Un avís de cancel·lació només indica que no hi haurà una altra renovació.

Sobre els diners

  • La comissió de lava.top és del 8 % de cada pagament amb èxit. Es cobra a l'instant i no es retorna si després reemborses el client.
  • El reemborsament es fa des del panell de lava.top, secció «Vendes»; un reemborsament en una subscripció la cancel·la. lava.top encara no té un tipus de webhook propi per a reemborsaments i contracàrrecs, així que els veuràs al panell de lava.top i no al nostre registre.
  • Cancel·lar la renovació automàtica. El client pot fer-ho ell mateix al seu panell del teu aparador — llavors demanem a lava.top que cancel·li la subscripció — o al seu propi compte de lava.top; tu també pots cancel·lar-la per ell des del teu panell de lava.top. La cancel·lació no li treu l'accés: continua fins al final del període ja pagat, i nosaltres simplement deixem d'esperar el cobrament següent.
  • Un contracàrrec es pot iniciar fins a 540 dies després del pagament, i tens 3 dies per aportar proves. Guarda les condicions del teu aparador i la correspondència amb el client — les proves són exactament això.
  • Els límits depenen del tipus de producte. El mínim sempre és 50 ₽ / 5 $ / 5 €. Per a subscripcions, el màxim és 300 000 ₽ / 3 000 $ / 3 000 €; per a productes de pagament únic, 1 000 000 ₽ / 10 000 $ / 10 000 €.

Si es filtra una clau

A la targeta de lava.top hi ha dos botons diferents i fan coses diferents:

  • «Renovar la clau del webhook» — emet una clau nova per a les notificacions entrants. El nou valor s'ha d'enganxar al webhook de lava.top; fins que no ho facis, els pagaments no es confirmaran.
  • «Renova l'URL del webhook» — emet una adreça nova. L'antiga deixa de funcionar a l'instant; també s'ha d'actualitzar al webhook.

Si s'ha filtrat la clau API mateixa — revoca-la a lava.top, crea'n una de nova i enganxa-la al panell.

On this page