Accetta pagamenti Lightning.

Una connessione wallet, non un nodo pubblico.

Un endpoint Bitcoin pubblico può leggere la blockchain. Non può ricevere pagamenti Lightning per te. Lightning richiede un wallet che crei fatture e segnali quando vengono saldate.

NWC è un protocollo di connessione, non una garanzia di autocustodia. Scegli il modello di wallet adatto alla tua attività. Wholly Crypto non custodisce fondi Lightning e non installa un nodo.

Collega il tuo nodo LND.

1. Apri Impostazioni → Connessioni blockchain → Collega Lightning. Scegli LND · HTTPS.
2. Inserisci l'endpoint REST HTTPS raggiungibile dall'esterno e un macaroon con permessi limitati in formato esadecimale. Consenti lettura e scrittura delle fatture e info:read. Aggiungi offchain:read se vuoi visualizzare i saldi dei canali. Non usare mai admin.macaroon né concedere permessi di spesa.
3. Se LND usa un proprio certificato TLS, incolla il suo certificato PEM pubblico. Non incollare una chiave privata TLS. Consenti l'accesso dal VPS merchant nel firewall del nodo.
4. Seleziona i progetti autorizzati a usare la connessione. Verifica e salva, poi abilitala per le nuove fatture.

Il nodo deve essere sincronizzato con la mainnet Bitcoin. La verifica TLS resta attiva. Questa connessione accetta solo indirizzi HTTPS pubblici; indirizzi privati, di loopback e riservati sono bloccati. Mantieni il nodo separato dal server dei pagamenti.

Permessi macaroon LND ↗

Collegati tramite Nostr Wallet Connect.

1. In Alby Hub o in un altro wallet compatibile, crea una connessione dedicata alla ricezione.
2. Consenti make_invoice, lookup_invoice e get_info. get_balance è facoltativo. Non consentire metodi di pagamento o prelievo.
3. Scegli Nostr Wallet Connect in Wholly Crypto e incolla l'intera nostr+walletconnect://… stringa di connessione. Trattala come una password.
4. Usa un relay WSS pubblico nella stringa di connessione. Scegli il modello di custodia e l'accesso ai progetti, poi verifica e salva.

Wholly Crypto verifica le risposte firmate e supporta la cifratura NIP-44 v2 con compatibilità per NIP-04 legacy. Il wallet deve supportare la ricerca delle fatture in entrata con prova di pagamento. Non tutti gli account NWC supportano tutti i metodi di ricezione.

Guida Alby Hub ↗ · Specifica NWC ↗

Abilitalo per il tuo negozio.

Apri Progetto → Negozi → Metodi di pagamento → Bitcoin Lightning. Scegli la connessione e attivala. Bitcoin on-chain è una scelta separata; puoi offrire l'uno, l'altro o entrambi.

Crea una piccola fattura manualmente o tramite la solita API. Nel checkout, scegli Bitcoin e poi Bitcoin Lightning. Scansiona il QR o apri la richiesta in un wallet Lightning. Non serve una nuova rotta API per creare la fattura.

Pagato significa saldato.

Ogni richiesta riceve una propria fattura BOLT11 e un hash di pagamento. I prezzi usano valuta fiat e spread del negozio, arrotondati per eccesso a satoshi interi. Wholly Crypto registra gli incassi con precisione al millisatoshi.

Un pagamento trattenuto o rilevato non basta. Il wallet deve segnalare il regolamento con una prova di pagamento valida. Non servono conferme di blocco. Cronologia fatture, commissioni di elaborazione, IPN e webhook seguono il normale flusso delle fatture.

LND usa una sottoscrizione ai regolamenti per connessione, più ricerche di recupero. NWC usa ricerche delle fatture. Le richieste in attesa vengono normalmente controllate circa ogni 10 secondi; interruzioni, code e limiti dei provider possono ritardare gli aggiornamenti. Le richieste non saldate restano monitorate per 24 ore dopo la scadenza della fattura merchant.

Disattivare o sostituire le credenziali non sposta una richiesta esistente su un altro wallet. Mantieni funzionanti le vecchie credenziali di ricezione finché le richieste in attesa non terminano. Le richieste scadute o annullate non devono essere pagate.

Questa integrazione riceve pagamenti. Usa il wallet collegato per invii, rimborsi, gestione dei canali o trasferimenti verso exchange. I saldi Lightning sono saldi condivisi del wallet, non wallet separati per progetto. Le commissioni del provider, di instradamento e dei canali sono separate dalla commissione di elaborazione Wholly Crypto.

Prepara capacità e backup.

Il tuo nodo necessita di capacità in entrata nei canali per ricevere. Un wallet collegato senza un percorso utilizzabile o capacità di ricezione può comunque non ricevere un pagamento. Un servizio di liquidità può aiutare, ma costi e condizioni variano.

Il backup testuale dei wallet del progetto non esegue il backup di Lightning. Segui la procedura di recupero del nodo o del wallet, inclusi i backup dei canali richiesti. Una sola frase seed potrebbe non recuperare i fondi dei canali in sicurezza. Esegui il backup del database Wholly Crypto e della chiave di cifratura per conservare il monitoraggio delle fatture e le credenziali di connessione cifrate.

Guida al recupero LND ↗

Controlla prima la connessione.

• Accesso rifiutato: controlla i permessi di ricezione e se la credenziale è ancora valida.
• Connessione fallita: controlla HTTPS/WSS, TLS, DNS, accesso nel firewall e se il wallet è online.
• Richiesta non disponibile: controlla accesso al progetto, attivazione del negozio, tassi attuali e stato mainnet del wallet.
• Impossibile instradare il pagamento: controlla la liquidità in entrata nel wallet Lightning. Una connessione API funzionante non dimostra l'esistenza di un percorso.

Prova un piccolo pagamento e il suo flusso di notifiche prima di offrire Lightning ai clienti. Non inviare mai chiavi dei wallet, macaroon o segreti NWC all'assistenza.