BITCOIN LIGHTNING

Lightning-Zahlungen annehmen.

Verbinde eine Wallet, aktiviere sie im Store und lass deine Kunden per Lightning-QR-Code bezahlen.

Eine Wallet-Verbindung, kein öffentlicher Node.

Ein öffentlicher Bitcoin-Endpunkt kann die Blockchain lesen. Er kann aber keine Lightning-Zahlungen für dich empfangen. Dafür brauchst du eine Wallet, die Zahlungsanforderungen erstellt und den Eingang bestätigt.

Deine Lösung	Verbindung	Wer kümmert sich darum?
Eigener Node	LND über HTTPS oder eine passende NWC-Wallet	Du verwaltest Schlüssel, Kanäle, Liquidität und Backups.
Gehostete Wallet mit eigenen Schlüsseln	NWC, etwa Alby Hub mit Hosting	Ein Dienst hilft beim Betrieb. Prüfe, ob du Schlüssel und Wiederherstellung selbst kontrollierst.
Konto bei einem verwahrenden Anbieter	Eine passende NWC-Verbindung	Der Anbieter hält dein Geld. Gebühren, Limits und mögliche Identitätsprüfungen hängen vom Anbieter ab.

NWC ist ein Verbindungsprotokoll, keine Garantie für eigene Schlüssel. Wähle das Modell, das zu dir passt. Wholly Crypto verwahrt keine Lightning-Gelder und installiert keinen Node.

Deinen LND-Node verbinden.

Öffne Settings → Chain connections → Connect Lightning und wähle LND · HTTPS.
Trage den von außen erreichbaren HTTPS-REST-Endpunkt und einen eingeschränkten Macaroon im Hex-Format ein. Erlaube Invoice-Lese-/Schreibzugriff und info:read. Für Kanalbestände ist zusätzlich offchain:read nötig. Nutze niemals admin.macaroon und erlaube keine Auszahlungen.
Hat LND ein eigenes TLS-Zertifikat, füge das öffentliche PEM-Zertifikat ein, nicht den privaten TLS-Schlüssel. Erlaube deinem Händler-VPS den Zugriff in der Firewall des Nodes.
Wähle die freigegebenen Projekte, prüfe die Verbindung und aktiviere sie für neue Rechnungen.

Der Node muss mit Bitcoin Mainnet synchronisiert sein. TLS wird immer geprüft. Erlaubt sind öffentliche HTTPS-Adressen; private, lokale und reservierte Adressen sind gesperrt. Betreibe den Node getrennt vom Zahlungsserver.

LND-Berechtigungen ↗

Über Nostr Wallet Connect verbinden.

Erstelle in Alby Hub oder einer passenden Wallet eine eigene Verbindung nur zum Empfangen.
Erlaube make_invoice, lookup_invoice und get_info. get_balance ist optional. Erlaube keine Sende- oder Auszahlungsfunktionen.
Wähle in Wholly Crypto Nostr Wallet Connect und füge die vollständige nostr+walletconnect://…-Verbindung ein. Behandle sie wie ein Passwort.
Nutze eine Verbindung mit einem öffentlichen WSS-Relay. Wähle dein Wallet-Modell und die Projekte, dann prüfe und speichere.

Wholly Crypto prüft signierte Antworten und unterstützt NIP-44 v2 sowie ältere NIP-04-Verbindungen. Die Wallet muss eingehende Rechnungen samt Zahlungsnachweis abfragen können. Nicht jedes NWC-Konto bietet die nötigen Funktionen.

Alby-Hub-Anleitung ↗ · NWC-Spezifikation ↗

Für deinen Store aktivieren.

Öffne Project → Stores → Payment methods → Bitcoin Lightning. Wähle die Verbindung und schalte sie ein. On-Chain-Bitcoin bleibt eine eigene Zahlungsart. Du kannst eine davon oder beide anbieten.

Erstelle eine kleine Rechnung manuell oder über die bestehende API. Wähle im Checkout Bitcoin und danach Bitcoin Lightning. Scanne den QR-Code oder öffne die Anforderung in deiner Lightning-Wallet. Zum Erstellen brauchst du keinen neuen API-Endpunkt.

Bezahlt heißt abgeschlossen.

Jede Anforderung erhält eine eigene BOLT11-Rechnung und einen Payment-Hash. Der Betrag nutzt Fiat-Währung und Kursaufschlag des Stores und wird auf ganze Satoshis aufgerundet. Eingänge werden mit Millisatoshi-Genauigkeit gespeichert.

Eine erkannte oder gehaltene Zahlung reicht nicht. Die Wallet muss den Abschluss mit einem gültigen Zahlungsnachweis bestätigen. Blockbestätigungen sind nicht nötig. Verlauf, Bearbeitungsgebühren, IPN und Webhooks nutzen den normalen Rechnungsablauf.

LND nutzt einen gemeinsamen Zahlungsstream pro Verbindung und zusätzliche Kontrollabfragen. NWC prüft Rechnungen per Abfrage. Offene Rechnungen werden normalerweise etwa alle 10 Sekunden geprüft; Ausfälle, Warteschlangen und Anbieterlimits können Updates verzögern. Nicht abgeschlossene Anforderungen werden bis 24 Stunden nach dem Rechnungsablauf weiter geprüft.

Wenn du eine Verbindung deaktivierst oder Zugangsdaten ersetzt, wandert eine bestehende Anforderung nicht zu einer anderen Wallet. Lass alte Empfangszugänge funktionieren, bis offene Anforderungen abgeschlossen sind. Abgelaufene oder stornierte Anforderungen dürfen nicht mehr bezahlt werden.

Diese Anbindung ist zum Empfangen gedacht. Senden, Erstattungen, Kanalverwaltung und Börsentransfers erledigst du in der verbundenen Wallet. Angezeigte Bestände gelten für die ganze Wallet, nicht nur ein Projekt. Anbieter-, Routing- und Kanalgebühren kommen zur Wholly-Crypto-Gebühr hinzu.

Kapazität und Backups bereithalten.

Zum Empfangen braucht dein Node eingehende Kanalkapazität. Auch bei einer funktionierenden API können Zahlungen an fehlender Liquidität oder einer Route scheitern. Ein Liquiditätsdienst kann helfen; Kosten und Bedingungen unterscheiden sich.

Der Wallet-Textexport des Projekts sichert Lightning nicht. Nutze die Wiederherstellung und Kanalbackups deines Nodes oder Wallet-Anbieters. Eine Seed-Phrase allein reicht für Kanalgelder möglicherweise nicht. Sichere außerdem die Wholly-Crypto-Datenbank und den Verschlüsselungsschlüssel für Zahlungszuordnung und Zugangsdaten.

LND-Wiederherstellung ↗

Zuerst die Verbindung prüfen.

Zugriff abgelehnt: Empfangsrechte und Gültigkeit der Zugangsdaten prüfen.
Verbindung fehlgeschlagen: HTTPS/WSS, TLS, DNS, Firewall und Wallet-Status prüfen.
Anforderung nicht verfügbar: Projektfreigabe, Store-Aktivierung, aktuelle Kurse und Mainnet-Verbindung prüfen.
Zahlung findet keine Route: Eingehende Liquidität in deiner Wallet prüfen. Eine gesunde API garantiert keine Zahlungsroute.

Teste eine kleine Zahlung samt Benachrichtigung, bevor du Lightning anbietest. Sende niemals Schlüssel, Macaroons oder NWC-Geheimnisse an den Support.