Accettare pagamenti con lava.top

lava.top è un fornitore di pagamenti che accetta carte, SBP e PayPal in rubli, dollari ed euro. Lo colleghi una volta e il pagamento sulla tua vetrina diventa da solo un abbonamento attivo: non devi concedere l'accesso a mano.

Il denaro va sul tuo account lava.top. CreateYourVPN non fa da intermediario nei pagamenti e non trattiene commissioni sulle tue vendite.

Cosa ti serve

• un account su lava.top (un account autore — quello che vende);
• 10–15 minuti per la configurazione iniziale;
• una piccola somma per un pagamento di prova: lava.top non ha un ambiente di test, quindi l'unico modo di verificare tutta la configurazione è un acquisto reale (minimo 50 ₽ / 5 $ / 5 €).

Passo 1. Registrazione e verifica

Registrati su lava.top e compila il profilo — con un profilo vuoto la pagina di pagamento sembra incompleta all'acquirente.

Poi vai su Balance → verifica: documento e selfie, 18+, senza VPN attiva.

Passo 2. Crea i tuoi prodotti

In lava.top crea uno o più prodotti per i tuoi piani. Ogni piano CreateYourVPN richiede un'offerta corrispondente, ma un prodotto lava.top può contenere più offerte, ad esempio mensile e annuale.

• Per un piano ricorrente scegli il tipo di prodotto «Abbonamento» — lava.top addebiterà da sola e ogni rinnovo prolungherà l'accesso da noi.
• Per un acquisto una tantum, usa un prodotto digitale, un corso o una consulenza a prezzo fisso.
• Verifica che l'offerta abbia un prezzo in almeno una valuta supportata: RUB, USD o EUR. La valuta del piano è preselezionata nella vetrina, ma l'acquirente può passare a qualsiasi altra valuta disponibile nell'offerta.
• Allinea il periodo di addebito alla durata del piano: prodotto mensile ↔ 30 giorni, 90 giorni ↔ 90 e così via.
• Nascondi i prodotti dalla tua pagina pubblica su lava.top tramite l'impostazione di visibilità. Non attivare «Prezzo su richiesta via API»: CreateYourVPN funziona attualmente con offerte a prezzo fisso. Un acquisto diretto dalla pagina lava.top arriva senza il nostro marcatore e potrebbe non essere associabile a un piano; comparirà quindi come «Non associato». I prodotti nascosti a prezzo fisso restano visibili nel nostro selettore delle offerte.

Cosa succede con un acquisto ripetuto

Un prodotto una tantum non ha rinnovi: quando il cliente ne vuole ancora, ricompra semplicemente. È uno scenario normale, e comprare in anticipo è sicuro — i giorni si sommano a quelli rimasti, non ripartono da zero. Dieci giorni residui più un mese nuovo fanno quaranta giorni.

Un'eccezione, se il piano concede anche traffico: la quota viene sostituita, non sommata. Un cliente che ha comprato 100 GB, ne ha consumati 30 e ricompra lo stesso piano si ritrova con 100 GB nuovi, non 170. Tienilo presente nei prezzi dei piani con traffico.

Passo 3. Collega l'account in CreateYourVPN

Tutto ciò che serve dal lato lava.top sta in un unico posto: Integrations nel menu di sinistra, la scheda API.

Crea una chiave API

Apri la scheda API e premi «Create API key». La chiave viene mostrata una sola volta — copiala subito: lava.top non la mostrerà una seconda volta e una chiave persa si può solo sostituire con una nuova.

Incolla la chiave nel tuo pannello

In CreateYourVPN apri la sezione «Monetizzazione», premi «Collega» sulla scheda lava.top, incolla la chiave nel campo «Chiave API lava.top» e salva.

Controlliamo subito la chiave e rispondiamo «Chiave accettata» — con il numero di prodotti trovati nell'account — oppure «lava.top non ha accettato questa chiave».

Subito dopo il salvataggio nello stesso modulo compaiono altri due valori: l'URL del webhook e la chiave del webhook. Sono quelli che incollerai in lava.top al passo successivo. La chiave del webhook la generiamo noi — non devi inventare niente.

Crea il webhook

lava.top te lo propone subito dopo la creazione della chiave — premi «+ Add Webhook». Lo stesso pulsante resta disponibile poi nella pagina API.

Serve un solo webhook: nel campo del tipo di evento si selezionano insieme tutti i tipi necessari:

lava.top non aggiunge una firma crittografica al corpo della richiesta, quindi la chiave segreta del webhook autentica la consegna. Trattala come una password.

Cosa ci dà la chiave API

lava.top non ha chiavi «di sola lettura» — una chiave API dà accesso completo all'account autore. La usiamo esattamente per tre cose: creare un pagamento nel momento in cui il cliente preme «Paga»; leggere il tuo catalogo prodotti per il selettore delle offerte; annullare un abbonamento quando il cliente disattiva il rinnovo automatico nel proprio pannello. Non cambiamo i prezzi, non tocchiamo l'export delle tue vendite e non facciamo nient'altro con questa chiave. È conservata cifrata, non viene più mostrata da nessuna parte e non finisce nei nostri log. Se vuoi tagliare l'accesso, elimina la connessione nel pannello: la chiave viene cancellata con essa.

Passo 4. Associa le offerte ai tuoi piani

Apri «Piani», entra in un piano e trova il blocco lava.top:

L'acquirente può passare tra tutte le valute disponibili nell'offerta selezionata. Per un pagamento una tantum in rubli mostriamo carta e SBP; per un abbonamento in rubli, solo carta. In dollari ed euro sono disponibili carta e PayPal.

Passo 5. Verifica con un pagamento reale

Compra tu stesso il piano più economico da un account cliente sulla tua vetrina. Entro un minuto il piano dovrebbe comparire in quell'account e il pagamento nel registro con lo stato «Elaborato» (sezione «Monetizzazione»).

Se non succede:

• l'evento non c'è affatto nel registro — il webhook in lava.top punta all'indirizzo sbagliato, non ha selezionati i tipi di evento necessari, oppure la sua chiave non coincide con quella del pannello. lava.top tiene una cronologia dei webhook con il pulsante di reinvio: parti da lì;
• l'evento c'è, ma è «Non associato» — non abbiamo capito di chi sia il pagamento né per quale piano. Associalo a mano direttamente nel registro: l'abbonamento verrà concesso dallo stesso codice di un pagamento automatico;
• «Da gestire» — il pagamento richiede una decisione umana: il cliente è bloccato nel tuo pannello, oppure il piano è stato ricollegato a un altro prodotto lava.top dopo la creazione del pagamento. Qui non tocchiamo l'accesso di nostra iniziativa — decidi tu.

Questioni di soldi

• La commissione di lava.top è dell'8 % su ogni pagamento riuscito. Viene trattenuta subito e non viene restituita se poi rimborsi il cliente.
• Il rimborso si fa dal pannello lava.top, sezione «Vendite»; un rimborso su un abbonamento lo annulla. lava.top non ha ancora un tipo di webhook dedicato a rimborsi e chargeback, quindi li vedrai nel pannello lava.top e non nel nostro registro.
• Annullare il rinnovo automatico. Il cliente può farlo da solo nel suo pannello sulla tua vetrina — noi chiediamo a lava.top di annullare l'abbonamento — oppure nel suo account lava.top; puoi annullarlo anche tu per lui dal tuo pannello lava.top. L'annullamento non toglie l'accesso: resta valido fino alla fine del periodo già pagato e noi smettiamo semplicemente di aspettare l'addebito successivo.
• Un chargeback può essere aperto entro 540 giorni dal pagamento e hai 3 giorni per fornire le prove. Conserva le condizioni della tua vetrina e la corrispondenza con il cliente — le prove sono esattamente questo.
• I limiti dipendono dal tipo di prodotto. Il minimo è sempre 50 ₽ / 5 $ / 5 €. Per gli abbonamenti il massimo è 300 000 ₽ / 3 000 $ / 3 000 €; per i prodotti una tantum è 1 000 000 ₽ / 10 000 $ / 10 000 €.

Se una chiave viene compromessa

Sulla scheda lava.top ci sono due pulsanti diversi che fanno cose diverse:

• «Rigenera la chiave del webhook» — emette una nuova chiave per le notifiche in arrivo. Il nuovo valore va incollato nel webhook di lava.top; finché non lo fai, i pagamenti non verranno confermati.
• «Ruota l'URL del webhook» — emette un nuovo indirizzo. Il vecchio smette di funzionare subito, va aggiornato anch'esso nel webhook.

Se è stata compromessa la chiave API stessa, revocala in lava.top, creane una nuova e incollala nel pannello.