BITCOIN LIGHTNING

Przyjmuj płatności Lightning.

Podłącz portfel odbiorczy, włącz go w sklepie i pozwól klientom płacić kodem QR Lightning.

Połączenie z portfelem, nie publiczny węzeł.

Publiczny punkt końcowy Bitcoin może odczytywać blockchain. Nie może przyjmować za Ciebie płatności Lightning. Lightning wymaga portfela, który tworzy faktury i zgłasza ich rozliczenie.

Twoja konfiguracja	Połącz przez	Kto się tym zajmuje?
Własny węzeł	LND przez HTTPS lub zgodny portfel NWC	Ty zarządzasz kluczami, kanałami, płynnością i kopiami zapasowymi.
Zarządzany portfel z samodzielną kontrolą środków	NWC, na przykład Alby Hub z hostingiem	Usługa pomaga w obsłudze. Sprawdź, czy zachowujesz kontrolę nad kluczami i dostęp do odzyskiwania.
Konto powiernicze	Połączenie NWC zgodnego dostawcy	Dostawca przechowuje Twoje środki. Opłaty, limity konta i wymagania weryfikacyjne zależą od dostawcy.

NWC to protokół połączenia, a nie gwarancja sposobu przechowywania środków. Wybierz model portfela odpowiedni dla swojej działalności. Wholly Crypto nie przechowuje środków Lightning ani nie instaluje węzła.

Podłącz swój węzeł LND.

Otwórz Ustawienia → Połączenia z blockchainami → Podłącz Lightning. Wybierz LND · HTTPS.
Wpisz zewnętrznie dostępny punkt końcowy REST przez HTTPS i ograniczony macaroon w formacie szesnastkowym. Zezwól na odczyt/zapis faktur oraz info:read. Dodaj offchain:read jeśli chcesz wyświetlać salda kanałów. Nigdy nie używaj admin.macaroon ani nie przyznawaj uprawnień do wydawania środków.
Jeśli LND korzysta z własnego certyfikatu TLS, wklej jego publiczny certyfikat PEM. Nie wklejaj prywatnego klucza TLS. Zezwól w zaporze węzła na dostęp z serwera VPS sprzedawcy.
Wybierz projekty uprawnione do korzystania z połączenia. Sprawdź i zapisz, a następnie włącz je dla nowych faktur.

Węzeł musi być zsynchronizowany z siecią główną Bitcoin. Weryfikacja TLS pozostaje włączona. To połączenie akceptuje wyłącznie publiczne adresy HTTPS; adresy prywatne, pętli zwrotnej i zarezerwowane są blokowane. Utrzymuj węzeł oddzielnie od serwera płatności.

Uprawnienia macaroon LND ↗

Połącz przez Nostr Wallet Connect.

W Alby Hub lub innym zgodnym portfelu utwórz oddzielne połączenie odbiorcze.
Zezwól na make_invoice, lookup_invoice i get_info. get_balance jest opcjonalne. Nie zezwalaj na metody płatności ani wypłat.
Wybierz Nostr Wallet Connect w Wholly Crypto i wklej pełny ciąg połączenia nostr+walletconnect://… . Traktuj go jak hasło.
Użyj jednego publicznego przekaźnika WSS w ciągu połączenia. Wybierz model przechowywania środków i dostęp projektów, a następnie sprawdź i zapisz.

Wholly Crypto weryfikuje podpisane odpowiedzi i obsługuje szyfrowanie NIP-44 v2 ze zgodnością ze starszym NIP-04. Portfel musi obsługiwać sprawdzanie faktur przychodzących z dowodem rozliczenia. Nie każde konto NWC obsługuje wszystkie metody odbioru.

Przewodnik Alby Hub ↗ · Specyfikacja NWC ↗

Włącz w swoim sklepie.

Otwórz Projekt → Sklepy → Metody płatności → Bitcoin Lightning. Wybierz połączenie i włącz je. Bitcoin on-chain jest oddzielną opcją; możesz oferować jedną lub obie.

Utwórz fakturę na niewielką kwotę ręcznie lub przez zwykłe API. Na stronie płatności wybierz Bitcoin, a potem Bitcoin Lightning. Zeskanuj kod QR lub otwórz żądanie w portfelu Lightning. Tworzenie faktury nie wymaga nowej trasy API.

Opłacona oznacza rozliczona.

Każde żądanie otrzymuje własną fakturę BOLT11 i hash płatności. Ceny korzystają z waluty fiducjarnej i narzutu kursowego sklepu, z zaokrągleniem w górę do pełnych satoshi. Wholly Crypto zapisuje wpływy z dokładnością do millisatoshi.

Wstrzymana lub wykryta płatność nie wystarczy. Portfel musi zgłosić rozliczenie z prawidłowym dowodem płatności. Potwierdzenia blokowe nie są potrzebne. Historia faktury, opłaty za przetwarzanie, IPN i webhooki działają zgodnie ze zwykłym procesem obsługi faktur.

LND używa jednej subskrypcji rozliczeń na połączenie oraz zapytań odtwarzających stan. NWC korzysta z zapytań o faktury. Oczekujące płatności są zwykle sprawdzane co około 10 sekund; awarie, kolejki i limity dostawców mogą opóźniać aktualizacje. Nierozliczone żądania są monitorowane przez 24 godziny po terminie faktury sprzedawcy.

Wyłączenie lub zastąpienie danych dostępu nie przenosi istniejącego żądania do innego portfela. Utrzymuj stare dane odbiorcze aktywne do zakończenia oczekujących żądań. Nie wolno opłacać wygasłych ani anulowanych żądań.

Ta integracja służy do odbierania płatności. Do wysyłania, zwrotów, zarządzania kanałami lub przelewów na giełdę używaj podłączonego portfela. Salda Lightning to wspólne salda portfela, a nie oddzielne portfele projektów. Opłaty dostawcy, routingu i kanałów są oddzielne od opłaty Wholly Crypto za przetwarzanie.

Zadbaj o pojemność i kopie zapasowe.

Aby odbierać płatności, węzeł potrzebuje przychodzącej pojemności kanałów. Podłączony portfel bez użytecznej trasy lub pojemności odbiorczej nadal może nie odebrać płatności. Usługa płynności może pomóc, ale koszty i warunki są różne.

Tekstowa kopia zapasowa portfela projektu nie obejmuje Lightning. Postępuj zgodnie z procedurą odzyskiwania węzła lub portfela, w tym wykonuj wymagane kopie zapasowe kanałów. Sama fraza odzyskiwania może nie wystarczyć do bezpiecznego odzyskania środków z kanałów. Wykonuj kopie zapasowe bazy danych Wholly Crypto i klucza szyfrowania, aby zachować śledzenie faktur i zaszyfrowane dane dostępu do połączeń.

Przewodnik odzyskiwania LND ↗

Najpierw sprawdź połączenie.

Odmowa dostępu: sprawdź uprawnienia odbiorcze i czy dane dostępu są nadal ważne.
Połączenie nie powiodło się: sprawdź HTTPS/WSS, TLS, DNS, dostęp przez zaporę i czy portfel jest online.
Żądanie niedostępne: sprawdź dostęp projektu, aktywację sklepu, aktualne kursy wymiany i działanie portfela w sieci głównej.
Brak trasy płatności: sprawdź płynność przychodzącą w portfelu Lightning. Sprawne połączenie API nie dowodzi istnienia trasy.

Przetestuj niewielką płatność i przepływ powiadomień, zanim zaoferujesz Lightning klientom. Nigdy nie wysyłaj pomocy technicznej kluczy portfela, macaroonów ani sekretów NWC.