Bitcoin Lightning

Przyjmuj Bitcoin przez Lightning.

Oferuj opcję płatności Lightning obok Bitcoin on-chain. Podłącz zewnętrzny węzeł LND lub zgodny portfel Nostr Wallet Connect; Wholly Crypto tworzy i śledzi żądania płatności.

W skrócie

Moneta natywna
BTC
Akceptowane tokeny
Tylko moneta natywna
Waluta opłat
BTC (satoshis)
Identyfikator płatności
Faktura BOLT11
Konfiguracja portfela
Zewnętrzne LND / NWC
Ręczne wysyłanie / automatyczny sweep
Wydawanie pozostaje w zewnętrznym portfelu

Co możesz otrzymywać

Lightning odbiera BTC, nie stablecoiny ani przelewy na adresy on-chain. Każde żądanie płatności ma własną kwotę, hash płatności i termin wygaśnięcia. Klient opłaca całą fakturę Lightning.

Płatności Bitcoin on-chain

Skonfiguruj sklep

W Ustawienia → Połączenia z blockchainami dodaj LND przez HTTPS lub Nostr Wallet Connect przez WSS, a następnie włącz to połączenie w sklepie. Obecna polityka połączeń wymaga publicznie osiągalnych endpointów; adres dostępny tylko przez LAN lub Tor nie zadziała bezpośrednio.

Dane dostępu i piecza nad środkami

Używaj ograniczonych danych odbiorczych, nigdy macaroonów administratora LND ani umożliwiających wydawanie. NWC opisuje połączenie, nie pieczę: sprawdź, czy wybrany portfel przechowuje klucze za Ciebie.

Skonfiguruj Lightning

Dokąd trafiają płatności

Kod QR zawiera fakturę Lightning BOLT11, nie adres Bitcoin. Nigdy nie wysyłaj transakcji on-chain, aby ją opłacić. Utwórz nową fakturę, jeśli żądanie wygasło; jego terminu nie można po prostu przedłużyć.

Kiedy płatność jest zakończona?

Wholly Crypto weryfikuje rozliczenie zgłoszone przez podłączony portfel. Otwarta faktura lub wstrzymany HTLC nie jest płatnością. Wpływ Lightning nie ma potwierdzeń bloków ani publicznego linku do eksploratora transakcji.

Przenieś środki, gdy będziesz gotowy

Używaj zewnętrznego portfela lub węzła do płatności wychodzących, płynności kanałów i kopii zapasowych. Sweep on-chain Wholly Crypto nie przenosi sald Lightning. Eksport portfeli projektu nie tworzy kopii tego zewnętrznego portfela.

Przewodnik po portfelu Lightning

Rozwiązywanie problemów z płatnościami

Jeśli płatności nie można przekierować, sprawdź płynność przychodzącą, dostępność portfela i termin wygaśnięcia żądania. Sprawne API nie gwarantuje trasy. Po niepewnej płatności zweryfikuj rozliczenie przed poproszeniem klienta o ponowienie.

Opłaty i weryfikacja

Domyślna opłata za przetwarzanie wynosi 1% wartości faktury w walucie fiducjarnej, płatne z oddzielnego salda. Obowiązuje przypisana Ci stawka. Opłaty sieciowe i koszty serwera są oddzielne.

Publiczni dostawcy mogą mieć awarie lub limity zapytań. Wysłana transakcja ani przekierowanie powrotne nie są dowodem płatności. Używaj zweryfikowanego statusu faktury i podpisanych powiadomień.

Środki na przetwarzanie API, IPN i webhooki
Kalkulator kursów

Przelicz kwotę

Z
Na
Szacunkowa wartość…

Ładowanie kursów…

    To wartość szacunkowa, a nie wycena płatności. Nie obejmuje opłat sieciowych, opłat giełdowych ani narzutów kursowych sprzedawcy.

    Skąd pochodzą kursy?

    Szacunki dla krypto korzystają z buforowanych publicznych cen Kraken oraz Binance tam, gdzie są dostępne. Niektóre ceny Binance używają USDT jako odniesienia dla USD. Kursy walut fiducjarnych pochodzą z Frankfurter i są dziennymi kursami referencyjnymi, a nie bieżącymi notowaniami rynkowymi.

    Zestaw danych odświeża się automatycznie. Sprawdź daty źródeł pod wynikiem. Wpisana kwota pozostaje w Twojej przeglądarce. Obecność aktywa na liście nie gwarantuje obsługi płatności.

    Kraken · Binance · Frankfurter · Nazwy i ikony aktywów: CoinGecko

    Wybierz walutę

    Utwórz fakturę przez API

    Uruchamiaj te przykłady na swoim serwerze. Zastąp host API, identyfikator projektu i sklepu oraz zachowaj dane dostępu w tajemnicy. Kwoty są ciągami dziesiętnymi.

    Najpierw włącz metodę w sklepie. Wybór zawęża włączone metody; nie dodaje aktywów. Jeśli nic nie pasuje, obowiązują ustawienia domyślne sklepu. Sprawdź zwrócone metody przed pokazaniem strony płatności.

    : "${WHOLLY_TOKEN:?Set WHOLLY_TOKEN to your server-side API token}"
    # Keep this key and the exact body for retries; use a new key for each new invoice.
    curl --fail-with-body --max-time 30 \
      --request POST \
      --url "https://api.example.com/v1/projects/YOUR_PROJECT_ID/stores/YOUR_STORE_ID/invoices" \
      --header "Authorization: Bearer $WHOLLY_TOKEN" \
      --header 'Idempotency-Key: order-1042-attempt-1' \
      --header 'Content-Type: application/json' \
      --data-raw '{
      "amount": "25.00",
      "currency": "EUR",
      "order_id": "order-1042",
      "payment_methods": [
        {
          "chain_slug": "bitcoin",
          "payment_rail": "lightning"
        }
      ]
    }'
    Pełna dokumentacja API faktur Identyfikatory projektu i sklepu API, IPN i webhooki