LNbits pour les petits commerçants
Exemple de cas d'usage de LNbits pour un petit hôtel-restaurant comme processeur de paiement en bitcoin
Comment utiliser LNbits en tant que petit commerçant ?
Pour en savoir plus sur LNbits, j'ai écrit ici un guide d'introduction rapide.
LNbits peut être utilisé comme processeur de paiement Bitcoin LN, en seulement quelques étapes simples. Oui, je sais, certains d'entre vous diront “mais utilisez plutôt BTCPay Server et compagnie …".
Ici, nous essayons de montrer les nouveaux outils disponibles pour les commerçants. Pour certains cas spécifiques, LNbits peut très bien convenir et même permettre de nouvelles utilisations/solutions à l’aide des différents extensions présentes. BTCPayServer est bien. Il fait du bon boulot, mais LNbits offre quant à lui plus d'outils et d'options pour un commerçant.
Scénario du cas d’usage
Pour montrer l’utilité d’une telle suite d’outils, considérons un petit hôtel-restaurant ou un bar-café avec également une boutique en ligne qui est un simple Wordpress + Woocommerce, pour, par exemple, les commandes en ligne.
Remarque : vous pouvez maintenant utiliser l'extension Market LNbits et construire votre propre boutique en ligne, sans à avoir besoin de Wordpress + Woocommerce.
Imaginons que ce commerçant veut ce qui suit :
recevoir des paiements en bitcoin, depuis son site web de commande en ligne, sans intermédiaire
les clients peuvent également payer en bitcoin via le réseau Lightning, dans le restaurant, de manière simple, directement au serveur. Et les clients peuvent également donner des pourboires au serveur, dans son propre portefeuille, directement.
disposer d'un système simple de TPoS, où les employés n'ont qu'à saisir la valeur en monnaie locale et créer la facture LN à payer.
disposer d'une simple boutique hors ligne en libre-service, par exemple pendant la nuit, afin que les clients puissent payer et emporter certains articles (bière, vin, sandwiches, snacks). L'utilisation de l'extension LNURLVend pourrait être une bonne solution.
créer une sorte de “points de fidélité” aux clients réguliers et leur donner des sats en retour en utilisant un système de bons de retrait avec LNURL-withdraw.
les clients peuvent aussi laisser des pourboires en sats dans un “Tip Jar” ou avec LNURL-pay
les clients peuvent mettre des chansons dans le bar, en payant une petite somme, notamment en utilisant l'extension LNbits Jukebox Livestream
.... et bien d'autres choses.
LNbits a beaucoup d'extensions prêtes à être utilisées, il suffit de les activer, de configurer quelques paramètres et voilà !
Mais avant toute chose, nous devons configurer LNbits pour qu'il soit accessible à tous les clients et appareils. Comme nous le savons dans Umbrel toutes les applications sont derrière le réseau Tor, or tous les clients n'utiliseront pas Tor (seuls les utilisateurs avancés le feront). Nous devons donc donner aussi l'accès aux utilisateurs “lambda”.
Préparation de LNbits (via Umbrel) en clearnet
Clearnet est l'accès clasique à l'internet tel que nous le connaissons. C’est à dire avec des domaine.com et/ou des adresses IP publique.
Le réseau Tor est quant à lui un internet parallèle, avec des adresses .onion. Il n'est pas (encore) largement utilisé/connu. Ainsi, l'accès aux services de paiement via Tor est parfois bugué et surtout compliqué pour les utilisateurs “lambda”.
Donc, considérons que le petit commerçant a un nœud Umbrel prêt, avec quelques canaux LN d’ouverts ry LNbits installés, prêts, et fonctionnant très bien comme il est se doit via son adresse .onion.
Quelques aspects à prendre en considération :
Il est préférable de configurer le nœud en mode hybride (clearnet + tor). Voici un super guide (par Hakuna) sur comment configurer votre nœud en mode hybride.
L'envoi/réception entre les portefeuilles internes de LNbits peut être autorisé avec l’ajout de cette ligne dans votre fichier lnd.conf :
allow-circular-route=1(redémarrez lnd après modification). Avec cela, vous pouvez utiliser les wallets LNbits avec zéro frais en interne, pour des paiements directs.Apprenez à gérer le nœud LN et à avoir de bonnes liquidités. Avoir du bon matos, des bonnes politiques de frais, de bonnes routes, c'est offrir à vos clients une expérience agréable en les permettant de vous payer rapidement et à bas prix en utilisant LN. Ne soyez pas trop avide. J'ai écrit un guide dédié à ce sujet.
Proposez à vos clients réguliers d’ouvrir des canaux avec votre nœud (s'ils ont déjà un nœud LN, bien sûr). Cela peut résoudre de nombreux problèmes de liquidité car cela vous apportera de la liquidité entrante (et vous en avez terriblement besoin). La liquidité entrante (nécessaire pour recevoir des paiements) peut être très chère parfois, donc si vos clients habitués ouvrent des canaux avec votre nœud, cela aidera grandemment, non seulement eux (frais à 0 sat et rapidité), mais aussi pour votre boutique (mieux connecté et plus de liquidité entrante).
Ayez toujours assez de liquidités entrantes pour recevoir des paiements. Il est préférable qu’à la fin de chaque journée ou bien lorsque vous avez eu une journée bien remplie, de loop-out les sats reçus, en utilisant un service de swap, comme décrit dans ce guide. Ainsi, vous commencerez toujours la journée avec suffisamment de “place” dans vos canaux pour recevoir des paiements. Une nouvelle extension est à présent disponible sur LNbits pour effectuer des swaps utilisant Boltz.exchange directement depuis LNbits.
LNbits n'effectue pas de transactions directement on-chain, mais seulement via LN. Quoi qu'il en soit, si vous voulez vraiment facturer en utilisant une adresse on-chain, vous pouvez utiliser l'extension SatsPay afin d’y associer à une clé xpub de l’un de vos portefeuilles on-chain. Mais les paiements on-chain nécessitent au moins 3 confirmations (et donc au moins 30min d'attente), ce n’est donc pas idéal pour un client de le faire autant attendre. Toutefois dans certains cas particuliers, cette option pourrait être utile.
Gardez à l'esprit que LNbits est toujours en version bêta et en développement. On attend également une nouvelle extension pour une gestion des utilisateurs et des accès plus complexe.
Sauvegardez dans vos favoris ou dans votre gestionnaire de mots de passe les différents adresse URL qui donnent accès aux utilisateurs / portefeuilles créés, ainsi que les informations importante votre LNdHub comme la clé admin, la clé des invoices, etc...
Pour configurer votre instance LNbits en clearnet, vous avez ces 2 options (ce sont de superbes guides faits par Hakuna et Uxellodunum) :
configurer votre instance LNbits existante dans Umbrel avec un reverse proxy nginx.
installer une autre instance LNbits en dehors de votre Umbrel, dans un autre serveur VPS.
Configuration de la boutique en ligne avec LNbits
Ok, donc maintenant vous avez rendu votre instance LNbits accessible depuis une url comme par exemple :
https://lnbits.my-domain.com
(ou n'importe quel sous-domaine que vous avez choisi). Vous avez également pris le temps de tester et vérifier que tous les portefeuilles et fonctionnalités fonctionnent bien. À présent, il vous faut donc configurer votre boutique en ligne.
Dans votre boutique Wordpress Woocommerce, vous avez le choix entre deux plugins woocommerce :
et le configurer pour qu’il se connecte à notre instance LNbits, avec les clés fournies dans la section LNbits wallet (walletID, invoiceID, watchonlyID).
Allez à votre portefeuille LNbits dédié à la boutique en ligne (vous pouvez avoir autant de portefeuilles comme vous le souhaitez) et copiez la chaîne de caractères “invoice/read key”.
Ensuite, allez dans votre Wordpress - Woocommerce - Payments - LNbits - et collez cette chaîne de caractère dans la clé API et ajoutez ensuite votre URL LNbits “https://lnbits.my-domain.com”
Voilà, c'est fait !
Désormais, vous pouvez à accepter des paiements en bitcoin via le Lightning Network sans redirection vers d’autres pages, sans intermédiaires. C’est rapide et simple. Le plugin LNbits génère la facture LN dans la même page et l'affiche à l'étape du paiement. Une fois le paiement effectué, un message de confirmation s'affiche et le client reçoit normalement par e-mail les détails de sa commande.
Oui, le plugin est très basique, avec seulement quelques options comme pour personnaliser le texte dans le paiement etc.. mais pas beaucoup plus. Mais c’est largement suffisant pour commencer à accepter des paiements en bitcoin.
Prise en charge des paiements en magasin (sur place) par les employés
En voilà un autre aspect sensible : donner un accès limité aux fonds du portefeuille de la boutique. C’est-à-dire un accès pour seulement pour créer des factures, sans pouvoir dépenser les fonds.
Sachez que LNbits offre de merveilleuses solutions !
Ici, nous supposons donc que vous n'avez pas d'intégration dans votre propre système PoS (Point of Sale / Terminal de paiement) avec LNbits ou de paiements en bitcoin. Dans ce cas, nous considérons les BTC comme du cash, il faut donc traiter le paiement d’une manière séparée, comme nous le faisons avec le cash en fiat. Dans le système comptable, il sera indiqué “payer en espèces” ou n'importe quel nom que vous voulez utiliser, ça n'a pas d'importance, c'est du cash.
Donc le serveur/employé aura juste besoin d'un moyen simple de générer une facture LN ou d'avoir une adresse LNURL générale prête à recevoir les paiements.
LNbits offre différentes approches. Vous pouvez utiliser celle qui convient le mieux à votre activité et à votre cas d’usage.
Nous pouvons utiliser les extensions LNbits suivantes :
LNDhub (portefeuille générateur de factures) configuré sur l’appareil du serveur/employé. Chaque serveur/employé peut avoir le sien, pour un meilleur suivi.
LNURL-pay QR code, imprimé sur un papier. Chaque serveur peut avoir son propre LNURL pour un meilleur suivi. Lorsque le client paie, il suffit qu’il montrer au serveur la confirmation sur l'écran de son téléphone et le tour est joué. Il est assez difficile et inutile de falsifier un paiement LN. Rappelez-vous que les paiements BTC/LN sont irréversibles.
Extension TPoS, configurée sur chaque appareil des serveurs/employés.
Offline LNURL-PoS pour des petits appareils hors ligne, au cas où vous n'avez pas une bonne couverture WiFi, comme par exemple au niveau de la terrasse qui n'a pas de connexion. C’est également disponible en tant qu'application mobile et peut donc être exécutée dans n'importe quel vieil appareil android, sans connexion internet.
Pourboire des serveurs
Les employés / serveurs peuvent avoir leur propre portefeuille LN personnel pour les pourboires. Vous pouvez également configurer des portefeuilles dédiés directement dans votre instance LNbits. Ils possèdent alors un accès complet à ces portefeuilles et peuvent les utiliser via des applications mobile comme Bluewallet ou Zeus.
Les portefeuilles LNbits peuvent également être utilisés via une application web sur le smartphone, il suffit d'enregistrer l'URL du portefeuille comme favoris et le mettre en widget web et de l'ouvrir directement depuis votre page d’accueil. Ça fonctionne à la perfection.
Pour le pot commun des pourboires, vous pouvez utiliser l'extension LNbits dédiée (Tip Jar). Elle est facile à configurer et permet de présenter une page web dédiée. On peut aussi utiliser un code QR dédié avec LNUL-pay, depuis son propre portefeuille, pour bien séparer les pourboires des paiements.
Une autre possibilité serait d'utiliser l'extension SplitPayments où l'on peut définir le montant des sats qui vont aux serveurs et aux restes des employés, à partir du total de chaque paiement. L’extension est très facile à configurer.
Comptabilité
À la fin de la journée, lorsque les serveurs/employés feront leur décompte dans le système “traditionnel”, ils indiqueront simplement ce qui a été facturé via LNbits. Un superviseur avec un accès complet au système LNbits peut également exporter toutes les transactions dans un fichier .csv ou l'imprimer si besoin.
Sûrement dans le futur, LNbits aura un meilleur système de comptabilité, d'étiquetage des transactions, de personnalisation, etc.. Maintenant, c'est basique mais largement suffisant pour fonctionner.
En outre, c'est à ce moment où un superviseur / propriétaire du magasin effectuera les swap-out de la liquidité sortante de ces canaux LN vers un portefeuille on-chain et laissera les canaux presque vides afin d’être prêt le jour suivant pour recevoir plus de sats.
Système de crédits de fidélité
Si vous avez des clients réguliers qui accepte de payer à l'avance pour leur consommation afin d’obtenir des réductions en retour, vous pouvez utiliser un système de cartes/appareils NFC pré-chargés, ou simplement créer un portefeuille LNDHub pour chacun de vos clients fidèles. Comme ça, ils leur suffisent de charger ces portefeuilles avec des sats et de les dépenser dans votre restaurant sans frais.
Le client a également le contrôle total sur ce portefeuille LN. Il peut l'importer sur son smartphone (via BlueWallet ou Zeus) et l'utiliser, s'il le souhaite, comme un portefeuille LN normal.
Il existe un moyen de construire des cartes / dispositifs NFC pour ce genre de portefeuilles (un exemple ici). Ainsi, les clients peuvent simplement utiliser ces appareils pour payer dans les magasins — pas besoin d’application tierce.
Vous pourriez aussi simplement créer des bons de retrait LNURL-withdraw et les donner à vos clients réguliers, comme “système de satsback”. Facile, rapide, sans complications, il suffit de les imprimer avec votre imprimante de tickets. Et ensuite, le client les retire quand il le souhaite ou les donne à quelqu'un d'autre.
Distributeur hors-ligne
Supposons que vous ayez également un service d'hébergement (hôtel) à côté de votre restaurant et que, pendant la nuit (lorsque vous n'avez pas de personnel disponible), vous souhaitiez offrir à vos clients un moyen simple d'acheter des snacks ou des boissons.
Cette option pourrait également être utilisée pour le mini-bar de la chambre.
Pour cela il vous faut une simple boîte / distributeur automatique avec un système pour recevoir des paiements LN hors ligne (un distributeur de bonbons est déjà disponible sur la boutique de LNbits). Vous pouvez choisir n'importe quelle taille ou type de boîte, l'important est de la relier à votre LNbits comme il est décrit dans ce tutoriel.
Une démo et de la documentation pour la construire sont également disponible. Le mécanisme est simple : le client scanne le QR, paie, l'article est dispensé. En plus de cela, la machine n'a pas besoin d'accès à Internet.
Magasin “hors-ligne”
Disons que vous voulez mettre en place un système de vente rapide de produits / menus à emporter. Une sorte de semi libre-service.
Vous disposez d'un écran à l'extérieur du magasin ou d'un simple panneau d'affichage, énumérant vos produits à emporter.
Le client scanne l’adresse LNURL du produit désiré, paie et reçoit un mot comme “preuve” de paiement. Les mots peuvent être configurés comme vous le souhaitez et modifiés quand vous le voulez.
Ensuite, le client entre dans votre local à un endroit spécial où vous livrez et présentez le(s) mot(s) payé(s) pour les produits. L'employé dispose alors de la preuve de paiement et n'a plus qu'à livrer.
Voici un tutoriel pour la configuration d’une telle solution.
Voici également une démo sur la façon de payer une bière avec une tireuse connectée.
Voici un autre exemple de cas d’usage pour l’achat de sandwiches via LN.
Jukebox connecté
Supposons que vos clients souhaitent écouter une musique agréable ou leurs chansons préférées dans votre bar/restaurant. Vous ne voulez pas permettre à tout le monde de changer la musique, mais seulement à ceux qui paient un “droit d’accès”.
Vous pourriez donc installer un simple appareil de musique relié à votre système LNbits et laisser les clients payer pour que l’appareil passe leurs chansons.
C’est une solution conviviale pour offrir une expérience agréable à vos clients.
Voici de la documentation sur la façon de configurer l'extension Jukebox.
Et ici un tutoriel vidéo de démonstration.
Restriction & Backup
Si vous souhaitez restreindre l'accès à votre instance LNbits “publique”, vous pouvez modifier le fichier de configuration de la manière suivante.
Tout d’abord vous pouvez ajouter uniquement les comptes utilisateurs créés spécifiquement dans les paramètres de l'environnement LNbits :
Entrez en SSH dans votre nœud Umbrel
éditez le fichier .yml conf : sudo nano ~/umbrel/apps/lnbits/docker-compose.yml
ajoutez dans la section #App la ligne : LNBITS_ALLOWED_USERS: YOUR_USER_ID_FROM_WALLET_URL avec des virgules pour séparer les différents utilisateurs que vous souhaitez autoriser
redémarrer l'application lnbits : sudo ~/umbrel/scripts/app stop lnbits && ~/umbrel/scripts/app start lnbits
Bientôt une extension de gestion complète des utilisateurs sera disponible, de sorte qu'il ne sera pas nécessaire de faire cette restriction manuellement. Mais en attendant, vous pouvez l'utiliser comme cette méthode ci-dessus.
Si vous obtenez une erreur comme lnurl.Exceptions.InvalidURL lorsque vous créez un LNURL (payer ou retirer) alors ajoutez cette ligne dans le fichier .env ou dans le même fichier yml mentionné ci-dessus : FORWARDED_ALLOW_IPS=*
Un autre aspect important : le BACKUP de la base de données.
Pour sauvegarder une copie de votre instance LNbits (y compris l'historique des tx, les portefeuilles, les comptes, etc …), vous pouvez sauvegarder le dossier de la base de données situé dans : ~/umbrel/app-data/lnbits/data
Le fichier sqlite3 de la base de données est le plus important, mais il est préférable de sauvegarder la totalité des dossiers pour toutes les extensions utilisées.
Si vous avez besoin d'éditer directement dans cette base de données sqlite, vous pouvez installer un simple éditeur de visualisation pour sqlite (plus de détails ici). Ensuite, vous pouvez ouvrir le fichier sqlite db et modifier toutes les tables et les éléments nécessaires, en ajustant les soldes, en supprimant les utilisateurs / portefeuilles existants.
Conclusion
Vous venez de voir un scénario où LNbits est utiliser pour un hôtel-restaurant comme solution de paiements. Évidemment, vous pouvez adapter cela à toute autre activité — votre imagination n’est que votre seule limite. Vous avez également vu le potentiel de cette suites d’extensions et à quel point ces extensions sont faciles à configurer, et cela tout en ayant la garde complète de vos fonds.
J'espère que ce guide pourra inspirer d'autres commerçants à commencer à accepter le bitcoin comme moyen de paiements.
De plus, si vous êtes un commerçant et que vous avez besoin d’aide pour configurer ce genre de solutions, des passionnés du Bitcoin peuvent vous apporter de l’aide. Vous pouvez vous rendre au Bitcoin Meetup le plus proche de chez vous (plus de 40 meetups en France) !
D’autres aides plus “professionnelle” sont également à votre disposition pour mettre en place cette solution pour vous, comme par exemple SparkPay (Portugal) ou Business Sats (Allemagne / Autriche)
Et rappelez-vous que c’est à nous de créer la Bitcoinomie Circulaire !
QUE ₿ITCOIN SOIT AVEC TOI !
Si tu apprécies le travail de DarthCoin, tu peux lui envoyer quelques sats via le LN :
en utilisant ses adresses LN darthcoin@getalby.com ou darthcoin@stacker.news
ou simplement en scannant ce QR code avec ton portefeuille LN
Si tu apprécies mon travail (de traduction), tu peux m’envoyer quelques sats via le LN :
en utilisant ma page alby si tu veux me laisser un message
en utilisant mon adresse LN : asi0@getalby.com
ou simplement en scannant ce QR code avec ton portefeuille LN
