Accepter les paiements avec lava.top

lava.top est un prestataire de paiement qui accepte les cartes, le SBP et PayPal en roubles, dollars et euros. Vous le connectez une fois — et un paiement sur votre vitrine devient tout seul un abonnement actif : plus besoin d'accorder l'accès à la main.

L'argent va sur votre propre compte lava.top. CreateYourVPN n'est pas un intermédiaire dans les paiements et ne prend aucune commission sur vos ventes.

Ce qu'il vous faut

• un compte sur lava.top (un compte auteur — celui qui vend) ;
• 10 à 15 minutes pour la configuration initiale ;
• une petite somme pour un paiement de test : lava.top n'a pas d'environnement de test, et la seule façon de vérifier toute la configuration est un achat réel (minimum 50 ₽ / 5 $ / 5 €).

Étape 1. Inscription et vérification

Inscrivez-vous sur lava.top et remplissez votre profil — avec un profil vide, la page de paiement paraît inachevée à l'acheteur.

Allez ensuite dans Balance → vérification : un document et un selfie, 18+, sans VPN activé.

Étape 2. Créez vos produits

Dans lava.top, créez un ou plusieurs produits pour vos forfaits. Chaque forfait CreateYourVPN doit avoir une offre correspondante, mais un même produit lava.top peut contenir plusieurs offres, par exemple mensuelle et annuelle.

• Pour un forfait récurrent, choisissez le type de produit « Abonnement » — lava.top prélèvera automatiquement, et chaque renouvellement prolongera l'accès chez nous.
• Pour un achat unique, utilisez un produit numérique, un cours ou une consultation à prix fixe.
• Vérifiez que l'offre possède un prix dans au moins une devise prise en charge : RUB, USD ou EUR. La devise du forfait est présélectionnée dans la vitrine, mais l'acheteur peut choisir toute autre devise disponible dans l'offre.
• Alignez la période de prélèvement sur la durée du forfait : produit mensuel ↔ 30 jours, 90 jours ↔ 90, et ainsi de suite.
• Masquez les produits de votre page publique lava.top à l'aide du réglage de visibilité. N'activez pas « Prix sur demande via l'API » : CreateYourVPN fonctionne actuellement avec des offres à prix fixe. Un achat direct sur votre page lava.top arrive sans notre marqueur et peut être impossible à rattacher à un forfait ; il apparaît alors comme « Non associé ». Les produits masqués à prix fixe restent visibles dans notre sélecteur d'offres.

Ce que fait un achat répété

Un produit unique n'a pas de renouvellements : quand le client en veut encore, il rachète simplement. C'est un scénario normal, et acheter en avance est sans risque — les jours s'ajoutent au reliquat, ils ne repartent pas de zéro. Dix jours restants plus un mois neuf font quarante jours.

Une exception, si le forfait accorde aussi du trafic : le quota est remplacé, pas additionné. Un client qui a acheté 100 Go, en a consommé 30 et rachète le même forfait se retrouve avec 100 Go tout neufs, pas 170. Tenez-en compte dans le prix des forfaits avec trafic.

Étape 3. Connectez le compte dans CreateYourVPN

Tout ce qu'il faut côté lava.top se trouve au même endroit : Integrations dans le menu de gauche, la carte API.

Créez une clé API

Ouvrez la carte API et appuyez sur « Create API key ». La clé n'est affichée qu'une seule fois — copiez-la tout de suite : lava.top ne la montrera pas une deuxième fois, et une clé perdue ne peut être que remplacée par une nouvelle.

Collez la clé dans votre espace

Dans CreateYourVPN, ouvrez la section « Monétisation », appuyez sur « Connecter » sur la carte lava.top, collez la clé dans le champ « Clé API lava.top » et enregistrez.

Nous vérifions la clé immédiatement et répondons soit « Clé acceptée » — avec le nombre de produits trouvés sur le compte — soit « lava.top n'a pas accepté cette clé ».

Juste après l'enregistrement, deux autres valeurs apparaissent dans le même formulaire : l'URL du webhook et la clé du webhook. C'est ce que vous collerez dans lava.top à l'étape suivante. La clé du webhook, c'est nous qui la générons — vous n'avez rien à inventer.

Créez le webhook

lava.top le propose juste après la création de la clé — appuyez sur « + Add Webhook ». Le même bouton reste disponible ensuite sur la page API.

Un seul webhook suffit : le champ du type d'événement accepte tous les types nécessaires à la fois :

lava.top n'ajoute pas de signature cryptographique au corps de la requête ; la clé secrète du webhook authentifie donc la livraison. Traitez-la comme un mot de passe.

Ce que la clé API nous donne

lava.top n'a pas de clés « en lecture seule » — une clé API donne un accès complet au compte auteur. Nous l'utilisons pour exactement trois choses : créer un paiement au moment où le client clique sur « Payer » ; lire votre catalogue de produits pour le sélecteur d'offres ; annuler un abonnement quand le client désactive le renouvellement automatique dans son espace. Nous ne changeons pas les prix, ne touchons pas à l'export de vos ventes et ne faisons rien d'autre avec cette clé. Elle est stockée chiffrée, n'est plus jamais affichée et n'apparaît pas dans nos journaux. Si vous voulez couper l'accès — supprimez la connexion dans votre espace, la clé est supprimée avec elle.

Étape 4. Associez les offres à vos forfaits

Ouvrez « Forfaits », entrez dans un forfait et trouvez le bloc lava.top :

L'acheteur peut passer d'une devise à l'autre parmi celles disponibles dans l'offre choisie. Pour un paiement unique en roubles, nous affichons carte et SBP ; pour un abonnement en roubles, seulement carte. En dollars et en euros, carte et PayPal sont disponibles.

Étape 5. Vérifiez avec un vrai paiement

Achetez vous-même le forfait le moins cher, depuis un compte client sur votre vitrine. En une minute, le forfait doit apparaître dans ce compte, et le paiement dans le journal avec le statut « Traité » (section « Monétisation »).

Si ce n'est pas le cas :

• l'événement n'est pas du tout dans le journal — le webhook dans lava.top pointe vers la mauvaise adresse, les types d'événements nécessaires n'y sont pas cochés, ou la clé du webhook ne correspond pas à celle de votre espace. lava.top garde un historique des webhooks avec un bouton de renvoi — commencez par là ;
• l'événement est là, mais « Non associé » — nous n'avons pas su de quel client ni de quel forfait il s'agit. Associez-le à la main directement dans le journal : l'abonnement sera accordé par le même code qu'un paiement automatique ;
• « À traiter » — le paiement demande une décision humaine : le client est bloqué dans votre espace, ou le forfait a été rattaché à un autre produit lava.top après la création du paiement. Ici, nous ne touchons pas à l'accès nous-mêmes — c'est vous qui décidez.

Côté argent

• La commission de lava.top est de 8 % sur chaque paiement réussi. Elle est prélevée immédiatement et n'est pas restituée si vous remboursez ensuite le client.
• Le remboursement se fait depuis l'espace lava.top, section « Ventes » ; un remboursement sur un abonnement annule l'abonnement. lava.top n'a pas encore de type de webhook propre aux remboursements et aux chargebacks, vous les verrez donc dans l'espace lava.top et non dans notre journal.
• Annulation du renouvellement automatique. Le client peut l'annuler lui-même dans son espace sur votre vitrine — nous demandons alors à lava.top d'annuler l'abonnement — ou dans son propre compte lava.top ; vous pouvez aussi l'annuler pour lui depuis votre espace lava.top. Une annulation ne retire pas l'accès : il court jusqu'à la fin de la période déjà payée, et nous cessons simplement d'attendre le prélèvement suivant.
• Un chargeback peut être ouvert jusqu'à 540 jours après le paiement, et vous avez 3 jours pour fournir des preuves. Conservez les conditions de votre vitrine et vos échanges avec le client — voilà à quoi ressemblent des preuves.
• Les limites dépendent du type de produit. Le minimum est toujours de 50 ₽ / 5 $ / 5 €. Pour un abonnement, le maximum est de 300 000 ₽ / 3 000 $ / 3 000 € ; pour un produit à paiement unique, de 1 000 000 ₽ / 10 000 $ / 10 000 €.

Si une clé fuite

Sur la carte lava.top, il y a deux boutons différents, et ils font des choses différentes :

• « Renouveler la clé du webhook » — délivre une nouvelle clé pour les notifications entrantes. Il faut coller la nouvelle valeur dans le webhook de lava.top ; tant que ce n'est pas fait, les paiements ne seront pas confirmés.
• « Changer l'URL du webhook » — délivre une nouvelle adresse. L'ancienne cesse de fonctionner immédiatement, il faut la mettre à jour dans le webhook aussi.

Si c'est la clé API elle-même qui a fuité — révoquez-la dans lava.top, créez-en une nouvelle et collez-la dans votre espace.