BITCOIN LIGHTNING

Accepteer Lightning-betalingen.

Verbind een ontvangstwallet, schakel die in je winkel in en laat klanten met een Lightning-QR-code betalen.

Een walletverbinding, geen publieke node.

Een publiek Bitcoin-eindpunt kan de blockchain lezen. Het kan geen Lightning-betalingen voor je ontvangen. Lightning vereist een wallet die facturen maakt en meldt wanneer ze zijn voldaan.

Je opzet	Verbinden met	Wie beheert het?
Je eigen node	LND via HTTPS of een compatibele NWC-wallet	Jij beheert sleutels, kanalen, liquiditeit en back-ups.
Beheerde wallet met eigen sleutelbeheer	NWC, bijvoorbeeld Alby Hub met hosting	Een dienst helpt bij het draaien. Controleer of jij de sleutels en toegang tot herstel behoudt.
Account met bewaring door een derde	De NWC-verbinding van een compatibele provider	De provider bewaart je geld. Kosten, accountlimieten en verificatievereisten hangen af van de provider.

NWC is een verbindingsprotocol, geen garantie voor eigen beheer. Kies het walletmodel dat bij je bedrijf past. Wholly Crypto bewaart geen Lightning-middelen en installeert geen node.

Verbind je LND-node.

Open Instellingen → Blockchainverbindingen → Lightning verbinden. Kies LND · HTTPS.
Voer het extern bereikbare HTTPS-REST-eindpunt en een beperkte macaroon in hexadecimaal formaat in. Sta factuur lezen/schrijven toe en info:read. Voeg offchain:read als je kanaalsaldi wilt weergeven. Gebruik nooit admin.macaroon en geef geen bestedingsrechten.
Als LND een eigen TLS-certificaat gebruikt, plak dan het publieke PEM-certificaat. Plak geen private TLS-sleutel. Sta in de firewall van de node toegang vanaf je handelaars-VPS toe.
Selecteer de projecten die de verbinding mogen gebruiken. Controleer en sla op en schakel de verbinding vervolgens in voor nieuwe facturen.

De node moet gesynchroniseerd zijn met Bitcoin-mainnet. TLS-verificatie blijft ingeschakeld. Deze verbinding accepteert alleen publieke HTTPS-adressen; private, loopback- en gereserveerde adressen worden geblokkeerd. Houd de node gescheiden van je betaalserver.

LND-macaroonrechten ↗

Verbind via Nostr Wallet Connect.

Maak in Alby Hub of een andere compatibele wallet een afzonderlijke ontvangstverbinding.
Sta make_invoice, lookup_invoice en get_info. get_balance is optioneel. Sta geen betaal- of opnamemethoden toe.
Kies Nostr Wallet Connect in Wholly Crypto en plak de volledige nostr+walletconnect://… verbindingsreeks. Behandel die als een wachtwoord.
Gebruik één publieke WSS-relay in de verbindingsreeks. Kies je beheermodel en projecttoegang en controleer en sla vervolgens op.

Wholly Crypto verifieert ondertekende antwoorden en ondersteunt NIP-44 v2-versleuteling met compatibiliteit voor het oudere NIP-04. De wallet moet het opzoeken van inkomende facturen met bewijs van voldoening ondersteunen. Niet elk NWC-account ondersteunt alle ontvangstmethoden.

Alby Hub-handleiding ↗ · NWC-specificatie ↗

Schakel het in voor je winkel.

Open Project → Winkels → Betaalmethoden → Bitcoin Lightning. Kies de verbinding en schakel die in. Bitcoin op de blockchain is een afzonderlijke keuze; je kunt één van beide of allebei aanbieden.

Maak handmatig of via de gebruikelijke API een kleine factuur. Kies bij het afrekenen Bitcoin en vervolgens Bitcoin Lightning. Scan de QR-code of open het verzoek in een Lightning-wallet. Er is geen nieuwe API-route nodig om een factuur te maken.

Betaald betekent voldaan.

Elk verzoek krijgt een eigen BOLT11-factuur en betalingshash. Prijzen gebruiken de fiatvaluta en opslag van de winkel, naar boven afgerond op hele satoshi's. Wholly Crypto registreert ontvangsten met millisatoshiprecisie.

Een vastgehouden of gedetecteerde betaling is niet voldoende. De wallet moet voldoening melden met een geldig betalingsbewijs. Blokbevestigingen zijn niet nodig. Factuurgeschiedenis, verwerkingskosten, IPN en webhooks volgen het normale factuurproces.

LND gebruikt één abonnement op voldane betalingen per verbinding plus herstelopvragingen. NWC gebruikt factuuropvragingen. Openstaande opvragingen vinden normaal ongeveer elke 10 seconden plaats; storingen, wachtrijen en providerlimieten kunnen updates vertragen. Onvoldane verzoeken blijven tot 24 uur na de deadline van de handelaarsfactuur gevolgd worden.

Inloggegevens uitschakelen of vervangen verplaatst een bestaand verzoek niet naar een andere wallet. Houd oude ontvangstgegevens werkend totdat openstaande verzoeken zijn afgerond. Verlopen of geannuleerde verzoeken mogen niet worden betaald.

Deze integratie ontvangt betalingen. Gebruik de verbonden wallet voor verzenden, terugbetalingen, kanaalbeheer of overschrijvingen naar beurzen. Lightning-saldi zijn gedeelde walletsaldi, geen afzonderlijke projectwallets. Provider-, routerings- en kanaalkosten staan los van de verwerkingsvergoeding van Wholly Crypto.

Houd capaciteit en back-ups gereed.

Je node heeft inkomende kanaalcapaciteit nodig om te ontvangen. Een verbonden wallet zonder bruikbare route of ontvangstcapaciteit kan nog steeds geen betaling ontvangen. Een liquiditeitsdienst kan helpen, maar kosten en voorwaarden variëren.

De tekstback-up van projectwallets maakt geen back-up van Lightning. Volg de herstelprocedure van je node of wallet, inclusief de vereiste kanaalback-ups. Alleen een herstelzin kan kanaalmiddelen mogelijk niet veilig herstellen. Maak back-ups van de Wholly Crypto-database en versleutelingssleutel om factuurregistratie en versleutelde verbindingsgegevens te behouden.

LND-herstelhandleiding ↗

Controleer eerst de verbinding.

Toegang geweigerd: controleer ontvangstrechten en of de inloggegevens nog geldig zijn.
Verbinding mislukt: controleer HTTPS/WSS, TLS, DNS, firewalltoegang en of de wallet online is.
Verzoek niet beschikbaar: controleer projecttoegang, winkelactivering, actuele wisselkoersen en de mainnetstatus van de wallet.
Betaling kan geen route vinden: controleer inkomende liquiditeit in je Lightning-wallet. Een gezonde API-verbinding bewijst niet dat er een route bestaat.

Test een kleine betaling en het meldingsproces voordat je Lightning aan klanten aanbiedt. Stuur nooit walletsleutels, macaroons of NWC-geheimen naar support.