BITCOIN LIGHTNING
Lightning ödemelerini kabul et.
Bir ödeme alma cüzdanı bağla, mağazanda etkinleştir ve müşteriler Lightning QR koduyla ödesin.
Herkese açık düğüm değil, cüzdan bağlantısı.
Herkese açık Bitcoin uç noktası blokzinciri okuyabilir. Senin için Lightning ödemesi alamaz. Lightning, fatura oluşturan ve tamamlandığını bildiren bir cüzdan gerektirir.
| Kurulumun | Bağlantı yöntemi | Kim yönetir? |
|---|---|---|
| Kendi düğümün | HTTPS üzerinden LND veya uyumlu NWC cüzdanı | Anahtarları, kanalları, likiditeyi ve yedekleri sen yönetirsin. |
| Yönetilen, anahtarları sende olan cüzdan | NWC; örneğin barındırma hizmetiyle Alby Hub | Çalıştırılmasına bir hizmet yardımcı olur. Anahtar kontrolünün ve kurtarma erişiminin sende kaldığını kontrol et. |
| Saklama hizmetli hesap | Uyumlu sağlayıcının NWC bağlantısı | Fonlarını sağlayıcı saklar. Ücretler, hesap sınırları ve doğrulama gereksinimleri sağlayıcıya bağlıdır. |
NWC bir bağlantı protokolüdür, saklama garantisi değildir. İşletmene uygun cüzdan modelini seç. Wholly Crypto Lightning fonlarını saklamaz veya düğüm kurmaz.
LND düğümünü bağla.
- Aç: Ayarlar → Zincir bağlantıları → Lightning bağla. Seç: LND · HTTPS.
- Dışarıdan erişilebilen HTTPS REST uç noktasını ve onaltılık biçimde kısıtlı bir macaroon gir. Fatura okuma/yazma izni ver; ayrıca
info:read. Şunu ekle:offchain:readkanal bakiyelerinin gösterilmesini istiyorsan. Asla şunu kullanma:admin.macaroonveya harcama izni verme. - LND kendi TLS sertifikasını kullanıyorsa herkese açık PEM sertifikasını yapıştır. TLS özel anahtarını yapıştırma. Düğümün güvenlik duvarında satıcı VPS'inden erişime izin ver.
- Bağlantıyı kullanmasına izin verilen projeleri seç. Kontrol et ve kaydet, ardından yeni faturalar için etkinleştir.
Düğüm Bitcoin mainnet ile eşzamanlı olmalıdır. TLS doğrulaması açık kalır. Bu bağlantı yalnızca herkese açık HTTPS adreslerini kabul eder; özel, geri döngü ve ayrılmış adresler engellenir. Düğümü ödeme sunucundan ayrı tut.
Nostr Wallet Connect üzerinden bağlan.
- Alby Hub veya başka bir uyumlu cüzdanda yalnızca ödeme alma için bir bağlantı oluştur.
- İzin ver:
make_invoice,lookup_invoiceveget_info.get_balanceisteğe bağlıdır. Ödeme veya çekim yöntemlerine izin verme. - Seç: Nostr Wallet Connect Wholly Crypto'da ve şu bağlantı dizesinin tamamını yapıştır:
nostr+walletconnect://…bağlantı dizesi. Parola gibi koru. - Bağlantı dizesinde tek bir herkese açık WSS rölesi kullan. Saklama modelini ve proje erişimini seç, ardından kontrol et ve kaydet.
Wholly Crypto imzalı yanıtları doğrular ve eski NIP-04 uyumluluğuyla NIP-44 v2 şifrelemesini destekler. Cüzdan, ödeme tamamlanma kanıtıyla gelen fatura sorgulamayı desteklemelidir. Her NWC hesabı tüm ödeme alma yöntemlerini desteklemez.
Mağazanda etkinleştir.
Aç: Proje → Mağazalar → Ödeme yöntemleri → Bitcoin Lightning. Bağlantıyı seç ve aç. Zincir üstü Bitcoin ayrı bir seçenektir; birini veya ikisini sunabilirsin.
Elle veya normal API üzerinden küçük bir fatura oluştur. Ödeme sayfasında Bitcoin'i, ardından Bitcoin Lightning'i seç. QR kodunu tara veya isteği Lightning cüzdanında aç. Fatura oluşturmak için yeni API rotası gerekmez.
Ödendi, ödeme tamamlandı demektir.
Her istek kendine ait BOLT11 faturası ve ödeme hash'i alır. Fiyatlar mağazanın itibari para birimini ve fiyat marjını kullanır, tam satoshi'ye yukarı yuvarlanır. Wholly Crypto tahsilatları millisatoshi hassasiyetinde kaydeder.
Bekletilen veya tespit edilen ödeme yeterli değildir. Cüzdan, geçerli ödeme kanıtıyla tamamlanmayı bildirmelidir. Blok onayı gerekmez. Fatura geçmişi, işlem ücretleri, IPN ve webhook'lar normal fatura iş akışını izler.
LND bağlantı başına tek tamamlanma aboneliği ve kurtarma sorguları kullanır. NWC fatura sorguları kullanır. Bekleyen sorgular normalde yaklaşık 10 saniyede bir çalışır; kesintiler, kuyruklar ve sağlayıcı sınırları güncellemeleri geciktirebilir. Tamamlanmamış istekler, satıcı faturasının son tarihinden sonra 24 saat izlenir.
Kimlik bilgilerini kapatmak veya değiştirmek mevcut isteği başka cüzdana taşımaz. Bekleyen istekler bitene kadar eski ödeme alma kimlik bilgilerini çalışır tut. Süresi dolan veya iptal edilen istekler ödenmemelidir.
Bu entegrasyon ödeme alır. Gönderim, iade, kanal yönetimi veya borsa transferleri için bağlı cüzdanı kullan. Lightning bakiyeleri ayrı proje cüzdanları değil, paylaşılan cüzdan bakiyeleridir. Sağlayıcı, yönlendirme ve kanal ücretleri Wholly Crypto işlem ücretinden ayrıdır.
Kapasiteyi ve yedekleri hazır tut.
Düğümünün ödeme almak için gelen kanal kapasitesine ihtiyacı vardır. Kullanılabilir rotası veya alma kapasitesi olmayan bağlı cüzdan ödeme alamayabilir. Likidite hizmeti yardımcı olabilir; ancak maliyet ve koşullar değişir.
Proje cüzdanının metin yedeği Lightning'i yedeklemez. Gerekli kanal yedekleri dahil düğümünün veya cüzdanının kurtarma sürecini takip et. Kurtarma ifadesi tek başına kanal fonlarını güvenli biçimde kurtaramayabilir. Fatura takibini ve şifrelenmiş bağlantı kimlik bilgilerini korumak için Wholly Crypto veritabanını ve şifreleme anahtarını yedekle.
Önce bağlantıyı kontrol et.
- Erişim reddedildi: ödeme alma izinlerini ve kimlik bilgisinin hâlâ geçerli olup olmadığını kontrol et.
- Bağlantı başarısız: HTTPS/WSS, TLS, DNS, güvenlik duvarı erişimini ve cüzdanın çevrimiçi olup olmadığını kontrol et.
- İstek kullanılamıyor: proje erişimini, mağazanın etkinliğini, güncel kurları ve cüzdanın mainnet durumunu kontrol et.
- Ödeme yönlendirilemiyor: Lightning cüzdanındaki gelen likiditeyi kontrol et. Sağlıklı API bağlantısı, rota bulunduğunu kanıtlamaz.
Müşterilere Lightning sunmadan önce küçük bir ödeme ve bildirim akışını test et. Cüzdan anahtarlarını, macaroon'ları veya NWC sırlarını asla destek ekibine gönderme.