LNBits per piccoli commercianti

English

| Español

| Deutsch

| Français

| Dutch

| Hrvatski

| Hindi

Pubblicato originariamente su Substack il 14 aprile 2022. Aggiornato qui il 28 dicembre 2024.

Caso d'uso per LNBits in un piccolo ristorante d'albergo come processore di pagamento Bitcoin

Come utilizzare questa fantastica suite di app LNbits con il tuo nodo Lightning come piccolo commerciante.

Per leggere maggiori informazioni su LNbits, consulta questa guida introduttiva rapida.

LNBits potrebbe essere utilizzato come processore di pagamento Bitcoin LN,. Sì, lo so, alcuni di voi direbbero "ma usa BTCPay Server...ecc".

Questa volta, proviamo a usare più strumenti disponibili per i commercianti. Per alcuni casi specifici LNbits può adattarsi molto bene ed estendere l'utilizzo con le sue estensioni. BTCPay è buono, sta facendo un ottimo lavoro, ma d'altra parte LNbits offre più strumenti e opzioni per un commerciante.

Descrizione dello scenario del caso d'uso

Quindi, prendiamo uno scenario del caso d'uso: un piccolo hotel e ristorante o bar caffetteria, con anche un negozio online per ordini online, diciamo la comune combinazione di WordPress + Woocommerce Plugin.

Con l'estensione LNbits Market puoi creare il tuo negozio online, senza la necessità di un'installazione di Wordpress.

Un commerciante desidera quanto segue:

ricevere pagamenti in bitcoin, dagli ordini online del suo sito Web, senza intermediari e con commissioni molto basse
i clienti possono anche pagare con Bitcoin tramite Lightning Network nel ristorante, in modo semplice e direttamente al cameriere. Inoltre, i clienti dovrebbero essere in grado di dare mance al cameriere, nel suo portafoglio e anche immediatamente saldate.
avere un semplice TPoS, dove i dipendenti inseriscono semplicemente il valore nella loro valuta locale e creano la fattura LN da pagare.
avere un semplice negozio offline self-service, ad esempio durante la notte, in modo che gli ospiti possano pagare e portare via alcuni articoli (birra, vino, panini, snack). L'utilizzo dell'estensione LNURLVend potrebbe essere una buona soluzione.
creare un tipo di "punti fedeltà" per i clienti abituali e restituire loro sats tramite un sistema di voucher tramite l'estensione LNURLw.
i clienti possono anche lasciare mance con sats in un "Tip Jar" o LNURL-pay
i clienti possono ascoltare delle belle canzoni nella lounge del bar, ma pagando una piccola quota tramite l'estensione LNBits Jukebox Livestream

.... e molte altre ancora.. LNbits ha molte estensioni pronte, basta attivarle, configurare alcuni semplici parametri e il gioco è fatto, sei pronto per partire!

Ma prima di tutto, dobbiamo preparare LNBits per essere pronto per un'ampia accessibilità per qualsiasi client e dispositivo. Come sappiamo, in Umbrel tutte le app sono dietro la rete Tor, quindi poiché non tutti i clienti useranno Tor (solo gli utenti avanzati) dobbiamo dare accesso anche agli utenti normali connessi tramite la cosiddetta "clearnet" che è fondamentalmente ciò che indica "https://".

Prepara il tuo nodo LN (Umbrel/Raspiblitz ecc.) LNBits per essere visibile in "clearnet"

Clearnet è l'accesso Internet normale, domain.com e/o IP pubblico.

La rete Tor è un Internet parallelo, che usa indirizzi .onion tramite "http://" e non è (ancora) ampiamente utilizzata/conosciuta e accede ai servizi di pagamento tramite Tor, spesso buggata e complicata per gli utenti normali nell'interagire tra loro.

Quindi, diciamo che il piccolo commerciante ha un nodo Umbrel pronto, alcuni canali LN aperti, LNBits installato e funziona bene così com'è tramite il suo indirizzo .onion.

Alcuni aspetti da tenere in considerazione:

Si consiglia di configurare questo nodo in modalità ibrida. Ecco una fantastica guida (di Hakuna) su come configurare il tuo nodo in modalità ibrida.
L'invio/ricezione tra wallet LNBits interni può essere consentito con questa riga nel tuo file lnd.conf: allow-circular-route=1 (riavvia lnd dopo la modifica). Con questo, puoi usare wallet LNbits con zero commissioni interne, in pagamenti diretti.
Scopri come gestire il nodo LN e avere una buona liquidità. Avere un buon nodo, buone commissioni, buoni percorsi, significa offrire una bella esperienza ai tuoi clienti, in grado di pagarti velocemente e a buon mercato usando LN. Non essere avido. Qui ho scritto una guida dedicata.
Coinvolgi i tuoi clienti abituali per aprire canali con il tuo nodo (se hanno un nodo LN). Ciò risolverà molti problemi con la liquidità in entrata di cui hai veramente bisogno. La liquidità in entrata (in grado di ricevere pagamenti) potrebbe essere molto costosa a volte, quindi se i tuoi clienti sono abituati ad aprire canali con il tuo nodo sarà di grande aiuto, non solo per loro, ma anche per il tuo negozio.
Avere sempre abbastanza liquidità in entrata per ricevere pagamenti. È meglio che ogni fine giornata o quando hai avuto una giornata impegnativa, esegua un loop dai tuoi canali dei sat ricevuti, utilizzando un servizio di swap, come descritto in questa guida. In questo modo inizierai sempre la giornata con più "spazio" nei tuoi canali per ricevere pagamenti. Puoi anche usare l'estensione Boltz di LNbits.
LNBits non effettua transazioni onchain, solo LN. In ogni caso, se vuoi davvero addebitare utilizzando l'indirizzo onchain, è possibile usare l'estensione SatsPay collegata a una chiave xpub watch only usando l'estensione "Watch-Only". Ma gli addebiti onchain richiedono almeno 3 conferme (almeno 30 minuti di attesa), quindi per un cliente non è una buona idea tenerlo in attesa. Ma in casi particolari, sì, potrebbe essere usata questa opzione.
Con l'estensione Boltz puoi inviare tutti i guadagni al tuo hardwarewallet onchain ogni volta che viene raggiunta una certa soglia. Questo è molto potente poiché una volta installato, stai immediatamente accumulando sat in modo autonomo.
Tieni presente che LNBits è ancora in versione beta, quindi ci sono sempre nuovi sviluppi. È anche in attesa di una nuova estensione attesa per la gestione degli utenti e un accesso più complesso.
Salva il tuo URL di accesso agli utenti/portafogli creati nei tuoi segnalibri o nel gestore password, per poter accedere anche ai dettagli su URL lndhub, chiave amministratore, chiave fattura ecc. che potrebbero servirti per altre estensioni ora e in futuro.

Per aprire la tua istanza LNBits al mondo clearnet, hai queste opzioni (guide fantastiche realizzate da Hakuna e Uxellodunum):

Imposta il webshop con LNBits

Ok, ora abbiamo il nostro LNBits accessibile dall'esterno con

https://lnbits.my-domain.com

(o qualsiasi sottodominio tu voglia scegliere), tutti i wallet e le funzionalità sono testati e funzionanti.

Nel nostro negozio Wordpress Woocommerce possiamo installare il plugin LNbits Woo e configurarlo per connettersi alla nostra istanza LNbits, con le chiavi fornite nella sezione wallet LNBits (walletID, invoiceID, watchonlyID).

Vai a il tuo portafoglio LNBits configurato per essere utilizzato per il webshop (puoi averne molti quanti ne vuoi) e copia la stringa "fattura/chiave di lettura".

Quindi vai su Wordpress - Woocommerce - Pagamenti - LNbits - e incolla quella stringa nella chiave API e poi aggiungi il tuo URL lnbits "https://lnbits.my-domain.com" e il gioco è fatto.

Ecco fatto! Puoi iniziare a ricevere pagamenti in bitcoin tramite Lightning Network. Nessuna pagina reindirizzata, nessun intermediario, veloce e semplice. Il plugin LNbits genera la fattura LN nella stessa pagina e viene visualizzata nella fase di pagamento. Una volta fatto, verrà visualizzato un messaggio di conferma e normalmente il cliente riceverà via e-mail i dettagli del suo ordine.

Sì, il plugin è molto basilare, con poche opzioni, per personalizzare il testo nel pagamento ecc., ma è abbastanza buono per iniziare ad accettare pagamenti con bitcoin.

Accettazione di pagamenti in negozio (in loco) da parte dei dipendenti

Beh... questo è un altro aspetto sensato.

Dobbiamo dare loro un accesso limitato ai fondi del portafoglio del negozio, solo per creare fatture, non in grado di spendere da lì. E LNbits può farlo in un modo meraviglioso.

Quindi supponiamo di non avere alcuna integrazione nel nostro sistema PoS con LNbits o pagamenti bitcoin, consideriamo BTC come denaro contante, quindi possiamo semplicemente accettare il pagamento in un modo separato, come facciamo con i contanti. Nel sistema di contabilità è contrassegnato come "paga in contanti" o qualsiasi altro nome tu voglia usare, non importa, è denaro contante.

Quindi il cameriere/dipendente avrà solo bisogno di un modo semplice per generare una fattura LN o avere un LNURL generale pronto per ricevere i pagamenti.

LNbits ha diversi approcci, puoi usare quello più adatto alla tua attività specifica e al tipo di situazione.

Possiamo usare le seguenti estensioni LNbits:

LNDhub (portafoglio fatture) configurato nel dispositivo del cameriere/dipendente. Ogni cameriere/dipendente può avere il suo, per un migliore monitoraggio
LNURL-pay codice QR, stampato su un foglio di carta. Ogni cameriere può avere il proprio indirizzo LNURL/LN per un migliore tracciamento. Quando il cliente paga, mostrerà semplicemente al cameriere la conferma sullo schermo del suo dispositivo e il gioco è fatto. È abbastanza difficile e inutile falsificare un pagamento LN. Ricorda, i pagamenti BTC/LN sono irreversibili.
Estensione TPoS, configurata su ogni dispositivo cameriere/dipendente
LNURL-PoS offline con i piccoli dispositivi offline, nel caso in cui non si disponga di una buona copertura WiFi, si ha una terrazza che non ha connessione. Disponibile anche come app mobile (può essere eseguita su qualsiasi vecchio dispositivo Android, senza Internet).
Estensione Scrub che può inoltrare automaticamente i sat a un indirizzo esterno dedicato.

Mance dei camerieri

I dipendenti/camerieri possono avere il proprio portafoglio LN personale per le mance, oppure puoi impostarne uno dedicato nella tua istanza LNBits e dare loro pieno accesso a quei portafogli in modo che possano utilizzarli nell'app mobile Bluewallet o Zeus.

Vai all'estensione LNBits LNDhub e scansiona il codice QR dell'amministratore o della fattura da importare in BitBanana, Bluewallet o Zeus mobile apps

I wallet LNBits possono anche essere usati come app web su dispositivi mobili, basta salvare l'URL del wallet come segnalibro del widget web e aprirlo direttamente. Funziona perfettamente.

Per Tip Jar comune generale può essere usata l'estensione dedicata LNbits, facile da configurare e presentata come una semplice pagina web. Oppure può essere usato un codice QR LNUL-pay dedicato, con il suo wallet, per separare dalle spese regolari.

Un altro modo potrebbe essere quello di usare l'estensione SplitPayments dove può essere definita la quantità di sats che andrà al cameriere, dal totale di ogni pagamento. Molto facile da configurare.

Contabilità

A fine giornata, quando i camerieri/dipendenti faranno il conteggio di fine giornata, nel sistema normale e confronteranno semplicemente con quanto addebitato nel sistema LNBits. Un supervisore con accesso completo potrebbe anche esportare tutte le transazioni in un file csv e/o stamparlo.

In questa sezione forse in futuro LNbits avrà un sistema di contabilità migliore, etichettatura delle transazioni, personalizzazione. Ora è solo di base ma sufficiente per funzionare.

Inoltre, questo è il momento in cui un supervisore/proprietario di un negozio scambierà i fondi dai canali LN, in un portafoglio onchain e lascerà i canali quasi vuoti per essere pronti per il giorno successivo per ricevere più sat.

Sistema di crediti fedeltà

Se hai dei clienti abituali che possono pagare in anticipo per il loro consumo e ottenere sconti, puoi usare un sistema di carte/dispositivi NFC caricati, oppure creare semplicemente un portafoglio LNDHub per ogni cliente fedeltà, dove lo caricano con sats e li spendono nel tuo ristorante. In questo modo le commissioni saranno pari a 0 per loro e avrai un controllo migliore di questi "punti fedeltà".

Inoltre il cliente ha il pieno controllo del suo portafoglio LN, può importarlo nel suo dispositivo e usarlo come un normale portafoglio LN se lo desidera.

C'è un modo per creare alcune carte/dispositivi NFC per questi portafogli. Un esempio qui. Quindi i clienti possono semplicemente usare quei dispositivi per pagare in negozio. Non c'è bisogno di altre app. Qui maggiori dettagli sulle carte NFC e su come personalizzarle.

Oppure potresti semplicemente creare alcuni buoni di prelievo LNURL e darli ai tuoi clienti abituali, come sistema satsback. Facile, veloce, senza complicazioni, basta stamparli con la tua normale stampante di biglietti, il cliente li ritira quando vuole o semplicemente regalali a qualcun altro.

Distributore automatico offline

Supponiamo che tu abbia anche un servizio di alloggio (hotel) accanto al tuo ristorante e durante la notte (quando non hai personale disponibile) vuoi offrire ai tuoi ospiti un modo semplice per acquistare snack o bevande.

Questa opzione potrebbe essere utilizzata anche per il minibar della camera.

Quindi un semplice box/distributore automatico con un sistema per ricevere pagamenti LN offline, è già disponibile con LNbits. Puoi scegliere qualsiasi dimensione o tipo di scatola, l'importante è collegarla ai tuoi LNbits come descritto nel tutorial.

Ecco una demo e come costruirla. Il sistema è semplice: il cliente scansiona il QR, paga, l'articolo viene smaltito. La macchina non ha bisogno di accedere a Internet.

Negozio offline

Supponiamo che tu voglia implementare un sistema di vendita rapida di prodotti/menu da asporto. Quindi una specie di semi-self-service.

Hai un monitor fuori dal negozio o solo un cartellone pubblicitario, che elenca i tuoi prodotti offerti da asporto.

Il cliente scansiona l'LNURL per il prodotto desiderato, paga e riceve una parola come "prova" di pagamento. Le parole possono essere configurate come preferisci e modificate quando vuoi.

Quindi il cliente entra nel tuo locale in un luogo speciale dove consegni e presenti quella/e parola/e pagata/e per i prodotti. I dipendenti hanno quindi la prova del pagamento e consegnano.

Ecco una demo tutorial su come configurare e funziona.

Ecco anche una demo su come pagare con sats una birra con un rubinetto intelligente.

Un altro esempio di scenario di caso d'uso qui come acquistare panini con LN.

Jukebox musicale DJ Lounge

Supponiamo che i tuoi clienti vogliano ascoltare della bella musica nel tuo bar/ristorante, scegliendo le loro canzoni preferite. Non vuoi permettere a tutti di cambiare la musica, ma solo a chi paga una quota.

Quindi potresti configurare un semplice dispositivo musicale, collegarlo al tuo sistema LNbits e consentire ai clienti di pagare le canzoni e riprodurle.

Incentiva il tuo ambiente e offri una bella esperienza ai tuoi clienti.

Ecco un'ulteriore documentazione su come configurare l'estensione Jukebox.

Ecco una demo del tutorial video.

Personalizzazione speciale e backup

Nel caso in cui si desideri limitare l'accesso alla propria istanza LNbits "pubblica", è possibile modificare il file delle impostazioni procedendo come segue.

Aggiungere solo account utente creati specifici nelle impostazioni dell'ambiente LNBits:

Inserire SSH nel nodo Umbrel
Modificare il file di configurazione yml: sudo nano ~/umbrel/apps/lnbits/docker-compose.yml
Aggiungere nella sezione #App la riga: LNBITS_ALLOWED_USERS: YOUR_USER_ID_FROM_WALLET_URL con virgole separate se si hanno più utenti da consentire
Riavviare l'app lnbits: sudo ~/umbrel/scripts/app stop lnbits && ~/umbrel/scripts/app start lnbits

Presto sarà disponibile un'estensione di amministrazione completa per la gestione degli utenti, quindi non sarà necessaria questa personalizzazione e verrà inoltre limitata la creazione di nuovi wallet. Ma fino ad allora puoi usarlo in questo modo.

Se ricevi un errore come lnurl.Exceptions.InvalidURL quando crei un LNURL (paga o preleva), aggiungi questa riga nel file .env o nello stesso file yml menzionato sopra.

FORWARDED_ALLOW_IPS=*

Un altro aspetto importante: BACKUP del database.

Per salvare un backup della tua istanza LNbits (inclusa cronologia delle transazioni, portafogli, account), puoi salvare la cartella del database che si trova in: ~/umbrel/app-data/lnbits/data

In particolare il file sqlite3 del database, ma è bene salvare l'intera cartella dati per tutte le estensioni utilizzate.

Se hai bisogno di modificare direttamente in questo database sqlite, puoi installare un semplice editor di visualizzazione per sqlite. Maggiori dettagli qui. Quindi puoi aprire il file sqlite db e modificare tutte le tabelle e gli elementi necessari, regolando i saldi, rimuovendo la modifica degli utenti/portafogli esistenti.

Conclusione

Quindi, questo è tutto, uno scenario completo su come potresti usare questa fantastica soluzione LNbits per un ristorante d'albergo. Puoi estenderlo alla tua attività specifica, coprendo tutte le esigenze che possono essere soddisfatte con i portafogli LNBits lndhub, ora vedi già quanto è potente e facile da configurare, avendo la piena custodia dei tuoi fondi.

Spero che questa guida possa ispirare più commercianti ad iniziare ad accettare Bitcoin.

Inoltre, quegli appassionati di Bitcoin che aiutano quei commercianti, che non hanno abbastanza competenze, a creare delle belle soluzioni per i pagamenti in bitcoin.

Se non sei esperto di tecnologia e stai costruendo questa soluzione da solo, ecco un team di specialisti in LNbits di SparkPay (Portogallo) o in Germania / Austria di Business Sats che può creare questa soluzione per te.