Bitcoin Lightning

Terima Bitcoin melalui Lightning.

Tawarkan pilihan pembayaran Lightning bersama Bitcoin on-chain. Hubungkan node LND eksternal atau dompet Nostr Wallet Connect yang kompatibel; Wholly Crypto membuat dan melacak permintaan pembayaran.

Sekilas

Koin native
BTC
Token yang diterima
Hanya koin native
Mata uang biaya
BTC (satoshis)
Referensi pembayaran
Invoice BOLT11
Penyiapan dompet
LND / NWC eksternal
Pengiriman manual / sweep otomatis
Pembelanjaan tetap di dompet eksternalmu

Yang dapat kamu terima

Lightning menerima BTC, bukan stablecoin atau transfer alamat on-chain. Setiap permintaan checkout memiliki jumlah, hash pembayaran, dan masa berlaku sendiri. Pelanggan membayar invoice Lightning penuh.

Pembayaran Bitcoin on-chain

Siapkan tokomu

Di Pengaturan → Koneksi chain, tambahkan LND melalui HTTPS atau Nostr Wallet Connect melalui WSS, lalu aktifkan koneksi tersebut di toko. Kebijakan koneksi saat ini mewajibkan endpoint yang dapat dijangkau publik; alamat khusus LAN atau khusus Tor tidak akan bekerja langsung.

Kredensial dan kustodi

Gunakan kredensial penerimaan terbatas, jangan pernah macaroon admin atau pembelanjaan LND. NWC menjelaskan koneksi, bukan kustodi: periksa apakah dompet terpilih memegang kunci untukmu.

Siapkan Lightning

Tempat pembayaranmu diterima

QR berisi invoice Lightning BOLT11, bukan alamat Bitcoin. Jangan pernah mengirim transaksi on-chain untuk membayarnya. Buat invoice baru jika permintaan kedaluwarsa; tenggatnya tidak bisa begitu saja diperpanjang.

Kapan pembayaran selesai?

Wholly Crypto memverifikasi penyelesaian yang dilaporkan dompet terhubung. Invoice terbuka atau HTLC yang ditahan bukan pembayaran. Konfirmasi blok atau tautan explorer transaksi publik tidak berlaku untuk penerimaan Lightning.

Pindahkan dana saat kamu siap

Gunakan dompet atau node eksternal untuk pembayaran keluar, likuiditas channel, dan cadangan. Sweep on-chain Wholly Crypto tidak memindahkan saldo Lightning. Ekspor dompet proyek tidak mencadangkan dompet eksternal tersebut.

Panduan dompet Lightning

Pemecahan masalah pembayaran

Jika pembayaran tidak dapat dirutekan, periksa likuiditas masuk, ketersediaan dompet, dan masa berlaku permintaan. API yang sehat bukan jaminan perutean. Setelah pembayaran tidak pasti, verifikasi penyelesaian sebelum meminta pelanggan mencoba lagi.

Biaya dan verifikasi

Biaya pemrosesan bawaan adalah 1% dari nilai fiat invoice, dibayar dari kredit terpisah. Tarif yang ditetapkan untukmu berlaku. Biaya jaringan dan server terpisah.

Penyedia publik dapat mengalami gangguan atau batas laju. Transaksi yang diajukan atau pengalihan kembali bukan bukti pembayaran. Gunakan status invoice terverifikasi dan notifikasi bertanda tangan.

Kredit pemrosesan API, IPN & webhook
Kalkulator kurs

Konversikan jumlah

Dari
Ke
Perkiraan nilai…

Memuat kurs…

    Perkiraan, bukan kuotasi pembayaran. Biaya jaringan, biaya bursa, dan spread merchant tidak termasuk.

    Dari mana kurs berasal?

    Perkiraan kripto menggunakan harga publik Kraken dalam cache, dengan Binance jika tersedia. Beberapa harga Binance menggunakan USDT sebagai acuan USD. Kurs fiat berasal dari Frankfurter dan merupakan kurs referensi harian, bukan kuotasi perdagangan langsung.

    Snapshot diperbarui otomatis. Periksa tanggal sumber di bawah hasilmu. Jumlah yang kamu masukkan tetap di browsermu. Pencantuman aset tidak menjamin dukungan pembayaran.

    Kraken · Binance · Frankfurter · Nama & ikon aset: CoinGecko

    Pilih mata uang

    Buat invoice dengan API

    Jalankan contoh ini di servermu. Ganti host API, ID proyek, dan ID toko, serta jaga kerahasiaan kredensial. Jumlah berupa string desimal.

    Aktifkan metode di toko terlebih dahulu. Pemilihan mempersempit metode yang diaktifkan; bukan menambahkan aset. Jika tidak ada yang cocok, pengaturan bawaan toko berlaku. Periksa metode yang dikembalikan sebelum menampilkan checkout.

    : "${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"
        }
      ]
    }'
    Referensi API invoice lengkap ID proyek & toko API, IPN & webhook