BITCOIN LIGHTNING

Terima pembayaran Lightning.

Hubungkan dompet penerimaan, aktifkan di tokomu, dan izinkan pelanggan membayar dengan kode QR Lightning.

Koneksi dompet, bukan node publik.

Endpoint Bitcoin publik bisa membaca blockchain. Endpoint itu tidak bisa menerima pembayaran Lightning untukmu. Lightning memerlukan dompet yang membuat faktur dan melaporkan saat faktur diselesaikan.

Penyiapanmu	Hubungkan dengan	Siapa yang mengelolanya?
Node milikmu sendiri	LND melalui HTTPS, atau dompet NWC yang kompatibel	Kamu mengelola kunci, kanal, likuiditas, dan cadangan.
Dompet kustodi mandiri yang dikelola	NWC, misalnya Alby Hub dengan hosting	Layanan membantu menjalankannya. Pastikan kamu tetap mengendalikan kunci dan memiliki akses pemulihan.
Akun kustodial	Koneksi NWC penyedia yang kompatibel	Penyedia menyimpan danamu. Biaya, batas akun, dan persyaratan verifikasi bergantung pada penyedia.

NWC adalah protokol koneksi, bukan jaminan kustodi. Pilih model dompet yang sesuai dengan bisnismu. Wholly Crypto tidak menyimpan dana Lightning atau menginstal node.

Hubungkan node LND-mu.

Buka Pengaturan → Koneksi blockchain → Hubungkan Lightning. Pilih LND · HTTPS.
Masukkan endpoint REST HTTPS yang bisa dijangkau dari luar dan macaroon dengan izin terbatas dalam format heksadesimal. Izinkan baca/tulis faktur dan info:read. Tambahkan offchain:read jika kamu ingin saldo kanal ditampilkan. Jangan pernah menggunakan admin.macaroon atau memberikan izin pembelanjaan.
Jika LND menggunakan sertifikat TLS sendiri, tempel sertifikat PEM publiknya. Jangan tempel kunci privat TLS. Izinkan akses dari VPS merchant-mu pada firewall node.
Pilih proyek yang diizinkan menggunakan koneksi. Periksa dan simpan, lalu aktifkan untuk faktur baru.

Node harus tersinkronisasi dengan mainnet Bitcoin. Verifikasi TLS tetap aktif. Koneksi ini hanya menerima alamat HTTPS publik; alamat privat, loopback, dan yang dicadangkan diblokir. Pisahkan node dari server pembayaranmu.

Izin macaroon LND ↗

Hubungkan melalui Nostr Wallet Connect.

Di Alby Hub atau dompet kompatibel lainnya, buat koneksi penerimaan khusus.
Izinkan make_invoice, lookup_invoice dan get_info. get_balance bersifat opsional. Jangan izinkan metode pembayaran atau penarikan.
Pilih Nostr Wallet Connect di Wholly Crypto dan tempel seluruh nostr+walletconnect://… string koneksi. Perlakukan seperti kata sandi.
Gunakan satu relay WSS publik dalam string koneksi. Pilih model kustodi dan akses proyekmu, lalu periksa dan simpan.

Wholly Crypto memverifikasi respons bertanda tangan dan mendukung enkripsi NIP-44 v2 dengan kompatibilitas NIP-04 lama. Dompet harus mendukung pencarian faktur masuk dengan bukti penyelesaian. Tidak setiap akun NWC mendukung semua metode penerimaan.

Panduan Alby Hub ↗ · Spesifikasi NWC ↗

Aktifkan untuk tokomu.

Buka Proyek → Toko → Metode pembayaran → Bitcoin Lightning. Pilih koneksi dan aktifkan. Bitcoin on-chain adalah pilihan terpisah; kamu bisa menawarkan salah satu atau keduanya.

Buat faktur kecil secara manual atau melalui API biasa. Di checkout, pilih Bitcoin lalu Bitcoin Lightning. Pindai kode QR atau buka permintaan di dompet Lightning. Tidak diperlukan rute API baru untuk membuat faktur.

Lunas berarti telah diselesaikan.

Setiap permintaan mendapatkan faktur BOLT11 dan hash pembayaran sendiri. Harga menggunakan mata uang fiat serta spread toko, dibulatkan ke atas ke satoshi utuh. Wholly Crypto mencatat penerimaan dengan presisi millisatoshi.

Pembayaran yang ditahan atau terdeteksi belum cukup. Dompet harus melaporkan penyelesaian dengan bukti pembayaran yang valid. Konfirmasi blok tidak diperlukan. Riwayat faktur, biaya pemrosesan, IPN, dan webhook mengikuti alur kerja faktur normal.

LND menggunakan satu langganan penyelesaian per koneksi ditambah pencarian pemulihan. NWC menggunakan pencarian faktur. Pencarian tertunda biasanya berjalan sekitar setiap 10 detik; gangguan, antrean, dan batas penyedia bisa menunda pembaruan. Permintaan yang belum diselesaikan tetap dipantau selama 24 jam setelah tenggat faktur merchant.

Menonaktifkan atau mengganti kredensial tidak memindahkan permintaan yang ada ke dompet lain. Biarkan kredensial penerimaan lama berfungsi sampai permintaan tertunda selesai. Permintaan kedaluwarsa atau dibatalkan tidak boleh dibayar.

Integrasi ini menerima pembayaran. Gunakan dompet yang terhubung untuk pengiriman, pengembalian dana, pengelolaan kanal, atau transfer bursa. Saldo Lightning adalah saldo dompet bersama, bukan dompet proyek terpisah. Biaya penyedia, routing, dan kanal terpisah dari biaya pemrosesan Wholly Crypto.

Siapkan kapasitas dan cadangan.

Node-mu memerlukan kapasitas kanal masuk untuk menerima. Dompet yang terhubung tanpa rute atau kapasitas penerimaan yang bisa digunakan tetap bisa gagal menerima pembayaran. Layanan likuiditas mungkin membantu, tetapi biaya dan ketentuannya bervariasi.

Cadangan teks dompet proyek tidak mencadangkan Lightning. Ikuti prosedur pemulihan node atau dompetmu, termasuk cadangan kanal yang diwajibkan. Frasa seed saja mungkin tidak bisa memulihkan dana kanal dengan aman. Cadangkan database dan kunci enkripsi Wholly Crypto untuk mempertahankan pelacakan faktur serta kredensial koneksi terenkripsi.

Panduan pemulihan LND ↗

Periksa koneksi terlebih dahulu.

Akses ditolak: periksa izin penerimaan dan apakah kredensial masih valid.
Koneksi gagal: periksa HTTPS/WSS, TLS, DNS, akses firewall, dan apakah dompet online.
Permintaan tidak tersedia: periksa akses proyek, aktivasi toko, kurs terkini, dan status mainnet dompet.
Pembayaran tidak bisa dirutekan: periksa likuiditas masuk di dompet Lightning-mu. Koneksi API yang sehat tidak membuktikan adanya rute.

Uji pembayaran kecil dan alur notifikasinya sebelum menawarkan Lightning kepada pelanggan. Jangan pernah mengirim kunci dompet, macaroon, atau rahasia NWC ke dukungan.