Encaisser des paiements dans un tunnel avec Lava

Vendez directement dans la conversation — l’acheteur appuie sur un bouton, paie, et le bot donne l’accès tout seul. Pas à pas, avec les pièges que nous avons déjà rencontrés.

Votre tunnel peut encaisser de l’argent : une personne arrive à l’étape Paiement, reçoit un bouton, paie — et le bot donne l’accès et poursuit le tunnel tout seul. Vous n’avez rien à faire, de jour comme de nuit.

Les paiements passent par Lava.top — un service de paiement qui travaille avec les particuliers et les entrepreneurs individuels et accepte les cartes et le SBP (le système russe de virement bancaire instantané).

Comment ça marche#

1. Une personne avance dans le tunnel et arrive à l’étape Paiement.
2. Le bot crée une facture personnelle dans votre compte Lava et envoie un bouton de paiement — sur Telegram, deux d’un coup : ⚡️ Payer via SBP et 💳 Payer par carte.
3. La personne paie sur la page Lava.
4. Lava nous prévient, le bot reconnaît l’acheteur et poursuit le tunnel — le long de la flèche qui sort de l’étape Paiement. C’est là que vous donnez l’accès : un lien de chaîne, une invitation à un groupe, un fichier.

Vous n’avez qu’à configurer une fois. Ensuite, le tunnel tourne tout seul.

Ce qu’il vous faut#

• Un compte lava.top avec un moyen de versement confirmé.
• Un tunnel déjà construit dans Craft (Telegram ou Instagram).
• 15 minutes.

Étape 1. Créer un produit dans Lava#

Dans votre tableau de bord Lava : Créer → Produit numérique.

Remplissez :

• Description — ce que la personne achète.
• « Après le paiement » (la partie payante) — mettez-y les liens de votre chaîne/groupe. Lava les envoie aussi par email à l’acheteur. C’est votre filet de sécurité : même s’il arrive quelque chose au bot, l’acheteur obtient quand même l’accès.
• Prix — vous pouvez le définir dans plusieurs devises à la fois.

Puis publiez le produit.

Les deux champs — description et partie payante — sont obligatoires : le produit ne s’enregistre pas sans eux.

Qui fixe le prix : Lava ou le tunnel#

Le produit a un interrupteur « Prix sur demande via l’API ». Il décide d’où vient le montant de la facture, choisissez donc en connaissance de cause.

Un seul prix qui ne change jamais → laissez désactivé, c’est plus simple. Vous prévoyez un minuteur « le prix augmente dans 24 heures », des promotions ou des prix différents selon les branches → activez-le : voir Le tunnel fixe le prix.

Étape 2. Obtenir l’offerId#

Une facture a besoin de l’offerId — qui N’EST PAS le numéro que vous voyez dans l’adresse du produit.

Deux façons de l’obtenir :

La façon simple : envoyez-nous le lien du produit et nous le trouverons pour vous.

Par vous-même (si vous êtes à l’aise avec la ligne de commande) — utilisez votre clé Lava :

curl -s "https://gate.lava.top/api/v2/products?showAllSubscriptionPeriods=true" \
  -H "X-Api-Key: YOUR_LAVA_KEY"

Trouvez votre produit dans la réponse — la valeur voulue est sous offers → id. Elle ressemble à 8665127d-....

Étape 3. Connecter Lava dans Craft#

Dans Craft : Réglages → « Paiements dans les tunnels (Lava) ». Collez votre clé API Lava (dans Lava : Intégrations → Public API) et cliquez sur « Connecter ». Craft vérifie aussitôt la clé auprès de Lava — une mauvaise clé se révèle ici, pas lors de votre première vente.

Une fois connecté, la même page affiche l’URL du webhook et le secret nécessaires à l’étape suivante, ainsi qu’un bouton « Produits et leurs identifiants » qui liste vos produits et l’offerId exact utilisé par l’étape Paiement.

Étape 4. Configurer le webhook#

Le webhook est la façon dont Lava nous informe de ce qui est arrivé à un paiement : réussi, échoué, remboursé. Sans lui, le bot n’apprend jamais le paiement et ne donne aucun accès.

Dans Lava : Intégrations → Public API → Add Webhook.

Étape 5. Construire l’étape Paiement#

Dans l’éditeur de tunnels, ajoutez une étape Paiement et remplissez :

• Produit Lava (offerId) — celui de l’étape 2.
• Prix (pour l’affichage) et Devise — ils n’affectent que le texte du message ; Lava facture le prix propre du produit.
• Message avec le bouton de paiement — votre texte d’offre ; les boutons apparaissent en dessous.
• Texte du bouton — utilisé quand il n’y a qu’un seul moyen de paiement.
• Variable e-mail — où est stocké l’e-mail de l’acheteur.

Comment le demander pour que les gens ne décrochent pas. « Nous vous enverrons un reçu » se lit comme facultatif — l’acheteur se dit « je n’ai pas besoin de reçu » et ne répond tout simplement pas. C’est une perte coûteuse : il avait déjà accepté de payer. Ne dites pas « nous ne pouvons pas continuer sans » — dites ce qui se passe une fois qu’il l’a envoyé :

Plus qu’une étape. Envoyez-moi votre email : je l’utilise pour votre commande et je vous réponds tout de suite avec le bouton de paiement. Le reçu arrivera là aussi. Et je vous envoie l’accès à la formation ici, dans cette conversation, juste après le paiement.

Et donnez à cette étape Question un délai d’attente avec un rappel — sinon, quiconque est distrait disparaît sans bruit.

La flèche qui sort de l’étape Paiement indique où le tunnel continue après un paiement réussi. C’est l’étape où vous donnez l’accès : le lien de la chaîne privée, l’invitation au groupe, le fichier.

Moyens de paiement#

Sur Telegram, l’acheteur reçoit deux boutons : « ⚡️ Payer via SBP » et « 💳 Payer par carte (cartes russes) ». Cela convertit mieux — les gens paient avec ce dont ils ont l’habitude.

• Devise autre que le rouble → carte uniquement (le SBP fonctionne en roubles).
• Si l’un des moyens n’est pas activé sur votre compte Lava, les autres boutons arrivent quand même — le tunnel ne casse pas.

Les cartes étrangères ont leur propre bouton. « 💳 Payer par carte (cartes russes) » émet une facture en roubles, et elle n’accepte pas les cartes étrangères : la page de paiement se bloque et le débit n’atteint jamais la banque (confirmé par un vrai paiement). Si certains de vos acheteurs sont à l’étranger, remplissez « Prix pour les cartes étrangères » dans l’étape Paiement — par exemple, 49 $. Un troisième bouton apparaît, « 🌍 Payer avec une carte étrangère » : une facture en dollars ou en euros qui accepte les cartes de tous les pays.

• Cela fonctionne avec « Le tunnel fixe le prix » coché. Si c’est le produit Lava qui fixe le prix, le produit doit avoir un prix dans cette devise.
• Choisissez un chiffre rond proche du prix en roubles — par exemple, 3 490 ₽ → 49 $.
• Telegram uniquement pour l’instant.
• Apple Pay. Sous le champ du prix, une case « Bouton « 🍎 Apple Pay avec une carte étrangère » » — un bouton de plus au même prix étranger. La page de carte étrangère ne propose pas Apple Pay d’elle-même, il a donc son propre bouton. Cela fonctionne sur iPhone et Mac avec une carte étrangère dans Cartes (Wallet) : les cartes russes ne peuvent pas être ajoutées à Apple Pay, et Lava ne l’accepte pas en roubles.
• PayPal. Une case de plus — « Bouton « 🅿️ Payer avec PayPal » » : une facture au même prix étranger pour ceux qui n’ont pas de carte adaptée. PayPal doit être activé dans votre compte Lava — sinon, Lava refuse et l’acheteur ne verra simplement pas ce bouton (les autres restent).
• Page de paiement en anglais. Les boutons étrangers (carte, Apple Pay, PayPal) ouvrent la page Lava et les emails de paiement en anglais — puisque ce sont les acheteurs à l’étranger qui les utilisent. Les boutons en roubles restent en russe.
• La confirmation prend plus de temps. Un paiement en roubles parvient au bot en quelques secondes ; un paiement étranger prend parfois 5 à 10 minutes : la page de paiement renvoie l’acheteur directement vers le bot, et l’accès arrive une fois que la banque a réglé le débit. Pour que l’acheteur ne panique pas ou ne paie pas deux fois, dites-le dans le texte de l’étape Paiement — par exemple : « Il arrive que la banque mette 5 à 10 minutes à confirmer un paiement — votre accès arrivera quand même ici tout seul, inutile de payer à nouveau. »

Sur Instagram, un seul bouton de paiement arrive — carte. Une raison de plus de faire passer les acheteurs sur Telegram si vous vendez en Russie.

Quand quelqu’un ne paie pas#

L’endroit le plus coûteux d’un tunnel, c’est la personne qui a ouvert la page de paiement et l’a fermée. Pour qu’elle ne reste pas dans le silence, l’étape Paiement a un champ « Relance si non payé » : combien de temps attendre le paiement avant de l’envoyer dans une branche séparée.

Remplissez-le et l’étape reçoit une seconde sortie, « N’a pas payé ». Là où mène cette flèche, c’est là que va le tunnel si le paiement n’arrive jamais.

Quoi écrire dans ce message : généralement, la personne n’a pas payé non pas parce qu’elle a changé d’avis, mais parce que sa banque a refusé le débit ou que le lien s’est ouvert dans le mauvais navigateur. Proposez l’autre moyen de paiement (carte au lieu de SBP ou l’inverse) et votre contact personnel. Et ajoutez un bouton qui ramène à l’étape Paiement — il émet une nouvelle facture.

Une attente raisonnable est de 10 à 20 minutes : les gens paient tout de suite ou sont déjà passés à autre chose.

Laissez le champ vide et il n’y a pas de branche — quelqu’un qui ne paie pas n’entend plus parler de rien.

Quand la banque refuse le paiement#

C’est un autre cas : la personne voulait payer, mais la carte n’est pas passée — fonds insuffisants, blocage par la banque, code non confirmé. Ici, le bot agit tout seul, rien à configurer :

1. Il explique à la personne pourquoi cela a échoué, avec des mots simples, et propose un autre moyen — carte au lieu de SBP, ou une autre carte.
2. Il envoie aussitôt de nouveaux boutons de paiement sur la même étape, au même prix.
3. Il vous prévient : qui, combien, quel moyen et ce qu’a dit la banque. S’ils ne paient pas rapidement, écrivez-leur vous-même — cette personne voulait acheter.

Si quelqu’un a essayé le SBP puis a payé par carte, il ne recevra pas de message « ça n’est pas passé ». Deux échecs d’affilée donnent un seul message, pas deux.

Après le paiement ou l’échec, Lava renvoie la personne vers la conversation avec le bot au lieu de la laisser sur sa propre page.

Il en va de même pour l’étape « Question » que vous utilisez pour recueillir l’e-mail : elle a un délai d’attente et une sortie « Pas de réponse ». Sans elle, quelqu’un qui commence l’achat et décroche au champ de l’e-mail disparaît aussi sans bruit. Réglez 5 minutes et un rappel : « J’attends toujours votre e-mail. »

Le tunnel fixe le prix (promotions et minuteurs)#

Normalement, le prix vit dans le produit Lava. Alors « le prix augmente dans 24 heures » ou « une réduction pour cette branche » nécessite un second produit — et vous voilà à jongler avec deux produits et deux offerId.

Il existe un second mode : le tunnel fixe le montant de la facture. Un seul produit Lava sert n’importe quel prix, et les hausses de prix et promotions se construisent comme des branches du tunnel.

Comment l’activer :

1. Dans Lava, activez « Prix sur demande via l’API » sur le produit (vous devez déjà avoir l’offerId à ce stade — voir l’avertissement de l’étape 2).
2. Dans l’étape Paiement, cochez « Ce tunnel fixe le prix ».
3. Le montant vient du champ « Prix » de cette étape. Besoin d’un second prix ? Ajoutez une seconde étape Paiement sur une autre branche avec un prix différent.

Ce que vous y gagnez : le prix dans le message et le prix sur la facture sont désormais le même chiffre issu du même champ — rien ne peut diverger. Un minuteur « la promotion se termine dans », des prix différents selon le mot-clé, un visiteur qui revient et voit le nouveau prix — tout cela, ce sont des branches d’un même tunnel.

Ce qu’il faut savoir d’avance :

Comment tester#

Les vérifications les moins chères d’abord.

Sans dépenser d’argent :

1. Parcourez votre propre tunnel jusqu’à l’étape Paiement et attendez les boutons. Les boutons sont apparus — votre clé fonctionne, le produit est publié et l’offerId est correct.
2. Appuyez sur le bouton et regardez la page : y a-t-il un choix de moyen, le bon montant, le bon nom de produit ? Ne payez pas — créer une facture en soi ne touche à aucun argent.
3. Vérifiez que le tunnel demande un e-mail avant le paiement et le retient.

Avec de l’argent (la vérification finale, une seule fois) :

Lava n’a pas de mode test — c’est leur réponse officielle. La seule façon de vérifier toute la chaîne est donc un vrai paiement d’un petit montant.

1. Fixez temporairement un petit prix (sur le produit Lava, ou dans le champ « Prix » de l’étape Paiement si c’est le tunnel qui fixe le prix).
2. Payez-le vous-même, une fois par moyen si vous vendez à la fois par carte et par SBP.
3. Vérifiez que l’accès arrive automatiquement dans le bot.
4. Remettez immédiatement le vrai prix.

Tester tout le tunnel#

Si votre tunnel a des relances programmées et plus d’un prix, le tester « tel quel » prend une journée. La méthode rapide :

1. Notez d’abord vos réglages en production — écrivez le délai de chaque étape avant de modifier quoi que ce soit, sinon vous ne retrouverez pas exactement le timing.
2. Réglez tous les délais sur 5 secondes et les prix sur des valeurs petites et différentes (par exemple 50 ₽ et 55 ₽), pour que le montant vous dise quelle branche s’est déclenchée.
3. Parcourez le tunnel depuis un autre compte qui ne l’a jamais parcouru : quelqu’un qui l’a déjà fait arrive au milieu du tunnel, pas au début.
4. Parcourez-le deux fois : une fois sans rien toucher — vous verrez toute la chaîne de relances ; une fois en appuyant jusqu’au bout — vous verrez le chemin court.
5. Payez les deux branches avec les petits montants et vérifiez que l’accès arrive tout seul.
6. Remettez les délais et prix de production.

Ils ont payé, mais n’ont pas reçu l’accès#

Vérifiez dans cet ordre — neuf fois sur dix, c’est l’un des deux premiers points.

1. Le webhook est-il configuré dans Lava, le bon secret est-il dans le champ « Clé API », et les quatre événements sont-ils cochés (étape 4) ? Pas de webhook signifie que Lava ne nous a jamais informés du paiement, le bot ne pouvait donc pas réagir.
2. Instagram et la règle des 24 heures. Si le paiement a eu lieu plus d’une journée après le dernier message de la personne, Meta ne laissera pas le bot lui écrire.
3. Ont-ils acheté via le bouton du tunnel et non via un lien direct du produit (voir l’avertissement plus haut) ?
4. L’e-mail est-il arrivé jusqu’à l’étape de paiement ? Une variable e-mail vide signifie pas de facture.

Toujours bloqué — écrivez-nous sur Telegram avec l’heure du paiement et l’e-mail de l’acheteur. Nous vérifierons ce qui est arrivé de notre côté et, si besoin, donnerons l’accès à la main — l’acheteur le reçoit dans le bot exactement comme pour un paiement normal.

Erreurs fréquentes#

Pas encore pris en charge#

Nous préférons être clairs sur les limites, pour éviter les surprises :

• Le retrait automatique de l’accès en cas de remboursement. Nous vous prévenons tout de suite d’un remboursement ou d’une contestation bancaire, mais retirer la personne de la chaîne ou du groupe vous revient.
• Les abonnements et paiements récurrents. Achats ponctuels uniquement pour l’instant.
• Les prix fixés par le tunnel et le choix du moyen de paiement sont réservés à Telegram. Sur Instagram, le prix vit dans le produit Lava et il y a un seul bouton.
• Connecter les clés vous-même. Pour l’instant, cela passe par nous et prend quelques minutes.

Besoin de quelque chose de cette liste — dites-le-nous. Nous construisons ce que les gens demandent vraiment.