LNBits voor kleine handelaren

English

| Español

| Deutsch

| Français

| Italiano

| Hrvatski

| Hindi

Oorspronkelijk geplaatst op Substack op 14 april 2022. Hier bijgewerkt op 28 december 2024.

Gebruiksvoorbeeld voor LNBits in een klein hotelrestaurant als Bitcoin-betaalprocessor

Hoe u deze geweldige LNbits-appsuite kunt gebruiken met uw Lightning-knooppunt als kleine handelaar.

Voor meer informatie over LNbits, zie deze snelle introductiegids.

LNBits kunnen worden gebruikt als een Bitcoin LN-betaalprocessor. Ja, ik weet het, sommigen van jullie zouden zeggen "maar gebruik BTCPay Server...etc".

Laten we deze keer proberen meer tools te gebruiken die beschikbaar zijn voor handelaren. Voor sommige specifieke gevallen kan LNbits heel goed passen en het gebruik uitbreiden met zijn extensies. BTCPay is goed, het doet geweldig werk, maar aan de andere kant biedt LNbits meer tools en opties voor een handelaar.

Beschrijving van het use case scenario

Dus, laten we een use case scenario nemen: een klein hotel en restaurant of café bar, met ook een webshop voor online bestellingen, laten we zeggen de gebruikelijke Wordpress + Woocommerce Plugin combinatie.

Met de LNbits Market extensie kunt u uw eigen online winkel bouwen, zonder dat u een Wordpress installatie nodig hebt.

Een handelaar wil het volgende:

betalingen ontvangen in bitcoin, van zijn website online bestellingen, zonder tussenpersoon en zeer lage kosten
klanten kunnen ook betalen met Bitcoin via het Lightning Network in het restaurant, op een eenvoudige manier en direct aan de ober. Ook moeten klanten fooien kunnen geven aan de ober, in zijn eigen portemonnee en ook direct afgerekend.
een eenvoudige TPoS hebben, waarbij de medewerkers gewoon de waarde in hun lokale valuta invoeren en de LN-factuur maken die betaald moet worden.
een eenvoudige selfservice offline winkel hebben, bijvoorbeeld 's nachts, zodat de gasten kunnen betalen en enkele items kunnen meenemen (bier, wijn, broodjes, snacks). Het gebruik van de LNURLVend-extensie zou een mooie oplossing kunnen zijn.
creëer een soort "trouwpunten" voor vaste klanten en geef ze sats terug met behulp van een vouchersysteem door de LNURLw-extensie te gebruiken.
klanten kunnen ook fooien achterlaten met sats in een "Tip Jar" of LNURL-pay
klanten kunnen wat leuke nummers afspelen in de barlounge, maar betalen een kleine vergoeding met behulp van de LNBits Jukebox Livestream-extensie

.... en nog veel meer .. LNbits heeft veel extensies klaar, activeer ze gewoon, configureer wat eenvoudige parameters en klaar, je bent klaar om te gaan!

Maar eerst moeten we LNBits voorbereiden om klaar te zijn voor brede toegankelijkheid voor elke client en elk apparaat. Zoals we weten, zijn in Umbrel alle apps het achterste Tor-netwerk, dus omdat niet alle klanten Tor zullen gebruiken (alleen de geavanceerde gebruikers) moeten we ook toegang verlenen aan gewone gebruikers die verbonden zijn via het zogenaamde "clearnet", wat in feite is wat "https://" aangeeft.

Bereid uw LN-knooppunt (Umbrel/Raspiblitz etc.) LNBits voor om zichtbaar te zijn in "clearnet"

Clearnet is de normale internettoegang, domain.com en/of openbare IP.

Tor-netwerk is een parallel internet, dat .onion-adressen gebruikt via "http://" en (nog) niet breed wordt gebruikt/bekend is en betalingsdiensten via Tor benadert, vaak buggy en ingewikkeld is voor gewone gebruikers om met elkaar te communiceren.

Dus, laten we zeggen dat de kleine handelaar een Umbrel-knooppunt klaar heeft, een aantal LN-kanalen open heeft, LNBits geïnstalleerd heeft en prima werkt zoals het hoort is over zijn .onion-adres.

Enkele aspecten om rekening mee te houden:

Het wordt aanbevolen om deze node in hybride modus te configureren. Hier is een geweldige gids (door Hakuna) over hoe u uw node in hybride modus kunt instellen.
Verzenden/ontvangen tussen interne LNBits-wallets kan worden toegestaan met deze regel in uw lnd.conf-bestand: allow-circular-route=1 (herstart lnd na bewerking). Hiermee kunt u LNbits-wallets gebruiken met nul interne kosten, in directe betalingen.
Leer hoe u de LN-node kunt beheren en een goede liquiditeit hebt. Een goede node, goede kosten, goede routes bieden een leuke ervaring aan uw klanten om u snel en goedkoop te kunnen betalen met LN. Wees niet hebzuchtig. Hier heb ik een speciale handleiding voor geschreven.
Betrek uw vaste klanten bij het openen van kanalen met uw node (als ze een LN-node hebben). Dat zal veel problemen met inkomende liquiditeit oplossen die u echt nodig hebt. Inkomende liquiditeit (betalingen kunnen ontvangen) kan soms erg duur zijn, dus als uw klanten gewend zijn om kanalen te openen met uw node, zal dat veel helpen, niet alleen hen, maar ook uw winkel.
Heb altijd voldoende inkomende liquiditeit om betalingen te ontvangen. Het is beter dat u aan het einde van de dag of wanneer u een drukke dag hebt gehad, de ontvangen sats uit uw kanalen haalt met behulp van een swap-service, zoals beschreven in deze handleiding. Op deze manier begint u de dag altijd met meer "ruimte" in uw kanalen om betalingen te ontvangen. Je kunt ook de LNbits Boltz-extensie gebruiken.
LNBits voert geen transacties uit via onchain, alleen LN. Hoe dan ook, als je echt wilt opladen via een onchain-adres, is dat mogelijk via de SatsPay-extensie die is gekoppeld aan een watch only xpub-sleutel met behulp van de "Watch-Only"-extensie. Maar opladen via onchain vereist ten minste 3 bevestigingen (ten minste 30 minuten wachten), dus voor een klant is het niet zo goed om hem te laten wachten. Maar in speciale gevallen kan deze optie wel worden gebruikt.
Met de Boltz Extension kunt u alle inkomsten naar uw onchain hardwarewallet sturen wanneer een bepaalde drempel wordt bereikt. Dit is erg krachtig, want zodra u het hebt geïnstalleerd, stapelt u onmiddellijk sats op een zelf-soevereine manier.
Houd er rekening mee dat LNBits nog in de bètafase zit, dus er zijn altijd nieuwe ontwikkelingen. Wacht ook op een nieuwe langverwachte extensie voor gebruikersbeheer en complexere toegang.
Sla uw toegangs-URL voor uw aangemaakte gebruikers/wallets op in uw bladwijzers of wachtwoordbeheerder, zodat u ook toegang hebt tot details over lndhub URL, admin key, factuursleutel etc. die u nu en later nodig kunt hebben voor andere extensies.

Om uw LNBits-instantie te openen voor de clearnetwereld, hebt u deze opties (geweldige handleidingen gemaakt door Hakuna en Uxellodunum):

Stel de webshop in met LNBits

Oké, nu zijn onze LNBits van buitenaf toegankelijk met

https://lnbits.my-domain.com

(of welk subdomein je ook wilt kiezen), alle wallets en functionaliteiten zijn getest en werken.

In onze Wordpress Woocommerce-winkel kunnen we de LNbits Woo-plugin installeren en configureren om verbinding te maken met onze LNbits-instantie, met de sleutels die zijn verstrekt in het LNBits-walletgedeelte (walletID, invoiceID, watchonlyID).

Ga naar je LNBits-wallet die is geconfigureerd om te worden gebruikt voor de webshop (u kunt er zoveel hebben als u wilt) en kopieer de "invoice/read key" string.

Ga dan naar uw Wordpress - Woocommerce - Payments - LNbits - en plak die string in de API-sleutel en voeg vervolgens uw lnbits-URL toe "https://lnbits.my-domain.com" en klaar.

Dat is alles! U kunt betalingen in bitcoins via Lightning Network gaan ontvangen. Geen omgeleide pagina's, geen tussenpersonen, snel en eenvoudig. De LNbits-plug-in genereert de LN-factuur op dezelfde pagina en wordt weergegeven in de betalingsstap. Zodra dit is voltooid, wordt er een bevestigingsbericht weergegeven en ontvangt de klant normaal gesproken per e-mail de details van zijn bestelling.

Ja, de plugin is erg basic, met niet al te veel opties om de tekst in de betaling te personaliseren, enz., maar is goed genoeg om betalingen met bitcoin te accepteren.

Betalingen in de winkel (op locatie) door werknemers accepteren

Nou... dit is nog een verstandig aspect.

We moeten ze beperkte toegang geven tot de portemonnee van de winkel, alleen om facturen te maken, niet om daar geld uit te geven. En LNbits kan dat op een geweldige manier.

Dus we veronderstellen dat we geen integratie hebben in ons eigen PoS-systeem met LNbits of bitcoinbetalingen, we beschouwen BTC als contant geld, dus we kunnen de betaling gewoon op een aparte manier accepteren, zoals we dat met contant geld doen. In het boekhoudsysteem staat "betalen in contanten" of welke naam u ook wilt gebruiken, het maakt niet uit, het is contant.

Dus de ober/werknemer heeft gewoon een eenvoudige manier nodig om een LN-factuur te genereren of een algemene LNURL klaar te hebben om betalingen te ontvangen.

LNbits hebben verschillende benaderingen, u kunt gebruiken welke het beste past bij uw specifieke activiteit en type situaties.

We kunnen de volgende LNbits-extensies gebruiken:

LNDhub (factuurportemonnee) geconfigureerd in het apparaat van de ober/werknemer. Elke ober/werknemer kan zijn eigen hebben, voor betere tracking
LNURL-pay QR-code, afgedrukt op papier. Elke ober kan zijn eigen LNURL/LN-adres hebben voor betere tracking. Wanneer de klant betaalt, wordt de bevestiging op het scherm van zijn apparaat aan de ober getoond en klaar. Het is vrij moeilijk en nutteloos om een LN-betaling te vervalsen. Vergeet niet dat BTC/LN-betalingen onomkeerbaar zijn.
TPoS-extensie, geconfigureerd op elk ober-/werknemersapparaat
Offline LNURL-PoS met de kleine offline apparaten, in het geval dat u geen goede wifi-dekking hebt, hebt u een terras dat geen verbinding heeft. Ook beschikbaar als mobiele app (kan worden uitgevoerd op elk oud Android-apparaat, zonder internet).
Scrub-extensie die automatisch sats kan doorsturen naar een speciaal extern adres.

Fooien voor obers

Medewerkers/obers kunnen hun eigen persoonlijke LN-portemonnee hebben voor fooien, of u kunt speciale wallets instellen in uw LNBits-instantie en hen volledige toegang geven tot die wallets, zodat ze deze kunnen gebruiken in de Bluewallet- of Zeus-mobiele app.

Ga naar de LNBits LNDhub-extensie en scan de QR-code van de beheerder of factuur die moet worden geïmporteerd in BitBanana, Bluewallet of Zeus mobiele apps

LNBits wallets kunnen ook worden gebruikt als webapp op mobiel, sla de wallet-URL gewoon op als webwidgetbladwijzer en open deze direct. Werkt perfect.

Voor algemene algemene Tip Jar kan de speciale LNbits-extensie worden gebruikt, eenvoudig te configureren en gepresenteerd als een eenvoudige webpagina. Of kan een speciale LNUL-pay QR-code worden gebruikt, met een eigen wallet, om te scheiden van reguliere kosten.

Een andere manier zou kunnen zijn om de SplitPayments-extensie te gebruiken, waar het bedrag aan sats kan worden gedefinieerd dat naar de ober gaat, van het totaal van elke betaling. Zeer eenvoudig te configureren.

Boekhouding

Aan het einde van de dag, wanneer obers/werknemers hun telling aan het einde van de dag doen, in het normale systeem en gewoon vergelijken met wat er in rekening is gebracht in het LNBits-systeem. Een supervisor met volledige toegang kan ook alle transacties exporteren naar een csv-bestand en/of afdrukken.

Op dit punt zal LNbits in de toekomst misschien een beter boekhoudsysteem, transactielabels en personalisatie hebben. Nu is het gewoon basic, maar genoeg om te werken.

Dit is ook het moment waarop een supervisor/winkeleigenaar de fondsen van LN-kanalen naar een onchain-wallet zal omwisselen en de kanalen bijna leeg zal laten om klaar te zijn voor de volgende dag om meer sats te ontvangen.

Fidelity Credits Systeem

Als u vaste klanten hebt die vooraf kunnen betalen voor hun consumptie en kortingen krijgen, kunt u een systeem van geladen NFC-kaarten/apparaten gebruiken, of gewoon een LNDHub-portemonnee maken voor elke fidelity-klant, waar ze deze opladen met sats en deze teruggeven in uw restaurant. Op deze manier zijn de kosten voor hen 0 en hebt u meer controle over deze "fidelity points".

Ook heeft de klant volledige controle over zijn LN-portemonnee, kan deze worden geïmporteerd in zijn apparaat en kan deze gebruiken als een gewone LN-portemonnee als hij dat wil.

Er is een manier om enkele NFC-kaarten/apparaten te bouwen voor deze portemonnees. Een voorbeeld hier. Klanten kunnen dus gewoon met die apparaten betalen in de winkel. Er zijn geen andere apps nodig. Hier vindt u meer informatie over NFC-kaarten en hoe u ze kunt personaliseren.

Of u kunt gewoon een aantal LNURL-withdraw vouchers maken en deze aan uw vaste klanten geven, als satsback-systeem. Gemakkelijk, snel, geen complicaties, print ze gewoon met uw gewone ticketprinter, de klant haalt ze op wanneer hij/zij wil of geeft ze gewoon aan iemand anders.

Offline verkoopautomaat

Stel dat u ook een (hotel) accommodatie service heeft naast uw restaurant en 's nachts (wanneer u geen personeel beschikbaar heeft) wilt u uw gasten een eenvoudige manier bieden om wat snacks of drankjes te kopen.

Deze optie kan ook worden gebruikt voor de minibar op de kamer.

Dus een eenvoudige box / verkoopautomaat met een systeem om offline LN betalingen te ontvangen, is al beschikbaar met LNbits. U kunt elke grootte of type doos kiezen, belangrijk is om deze te koppelen aan uw LNbits zoals beschreven in de tutorial.

Hier is een demo en hoe u deze bouwt. Het systeem is eenvoudig: de klant scant de QR-code, betaalt, het artikel wordt weggegooid. De machine heeft geen toegang tot internet nodig.

Offline winkel

Stel dat u een systeem wilt implementeren voor het snel verkopen van producten/menu's om mee te nemen. Dus een soort semi-zelfbediening.

U hebt een monitor buiten de winkel of gewoon een billboard met een lijst van uw producten die u meeneemt.

De klant scant de LNURL voor het gewenste product, betaalt en krijgt een woord terug als "bewijs" van betaling. De woorden kunnen naar wens worden geconfigureerd en gewijzigd wanneer u dat wilt.

Vervolgens gaat de klant naar uw lokale winkel op een speciale plek waar u de producten aflevert en presenteert die woorden die voor de producten zijn betaald. De werknemer heeft dan het betalingsbewijs en kan ze gewoon afleveren.

Hier is een tutorialdemo over hoe u de producten configureert en hoe ze werken.

Hier is ook een demo over hoe u met sats kunt betalen voor een biertje met een slimme tap.

Nog een voorbeeld van een use case scenario hier hoe u broodjes kunt kopen met LN.

DJ Lounge muziek jukebox

Stel dat uw klanten in uw bar/restaurant naar leuke muziek willen luisteren en hun eigen favoriete nummers willen kiezen. Je wilt niet dat iedereen de muziek kan veranderen, maar alleen degenen die betalen.

Je kunt dus een eenvoudig muziekapparaat instellen, het koppelen aan je LNbits-systeem en klanten laten betalen voor nummers en ze afspelen.

Stimuleert je omgeving en biedt je klanten een leuke ervaring.

Hier is meer documentatie over het instellen van de Jukebox-extensie.

Hier is een video-zelfstudiedemo.

Speciale aanpassing en back-up

Als je de toegang tot je "openbare" LNbits-instantie wilt beperken, kun je het instellingenbestand bewerken door de volgende stappen uit te voeren: volgend.

Voeg alleen specifieke aangemaakte gebruikersaccounts toe in de LNBits env-instellingen:

Voer SSH in op uw Umbrel-knooppunt
bewerk het yml-conf-bestand: sudo nano ~/umbrel/apps/lnbits/docker-compose.yml
voeg in de sectie #App de regel toe: LNBITS_ALLOWED_USERS: YOUR_USER_ID_FROM_WALLET_URL met komma's gescheiden als u meer gebruikers wilt toestaan
herstart de lnbits-app: sudo ~/umbrel/scripts/app stop lnbits && ~/umbrel/scripts/app start lnbits

Binnenkort is er een volledige beheerdersuitbreiding voor gebruikersbeheer beschikbaar, dus deze aanpassing is niet nodig en het beperken van het aanmaken van nieuwe wallets. Maar tot die tijd kunt u het op deze manier gebruiken.

Als u een foutmelding krijgt zoals lnurl.Exceptions.InvalidURL wanneer u een LNURL (betalen of opnemen) maakt, voeg dan deze regel toe aan het .env-bestand of in hetzelfde yml-bestand dat hierboven is genoemd.

FORWARDED_ALLOW_IPS=*

Ook een belangrijk aspect: BACKUP-database.

Om een back-up te maken van uw LNbits-instantie (inclusief transactiegeschiedenis, wallets, accounts), kunt u de databasemap opslaan die zich bevindt in: ~/umbrel/app-data/lnbits/data

Met name het database sqlite3-bestand, maar het is goed om de hele gegevensmap voor alle gebruikte extensies op te slaan.

Als u rechtstreeks in deze sqlite-database wilt bewerken, kunt u een eenvoudige viewer-editor voor sqlite installeren. Meer details hier. Dan kunt u het sqlite db-bestand openen en alle benodigde tabellen en items bewerken, saldi aanpassen, bestaande gebruikers/wallets verwijderen of bewerken.

Conclusie

Dat is het dus, een volledig scenario hoe je deze geweldige oplossing LNbits kunt gebruiken voor een hotelrestaurant. U kunt dit uitbreiden naar uw specifieke activiteit, en alle behoeften dekken die kunnen worden gedaan met LNBits lndhub-wallets. Nu ziet u al hoe krachtig het is en eenvoudig in te stellen, met volledige bewaring van uw fondsen.

Ik hoop dat deze gids meer handelaren kan inspireren om Bitcoin te gaan accepteren.

Ook die Bitcoin-enthousiastelingen die handelaren helpen die niet genoeg vaardigheden hebben, door mooie oplossingen te bouwen voor bitcoinbetalingen.

Als u niet technisch onderlegd bent om deze oplossing zelf te bouwen, is hier een team van specialisten in LNbits van SparkPay (Portugal) of in Duitsland / Oostenrijk door Business Sats die deze oplossing voor u kunnen bouwen.