Bitcoin Lightning

LightningでBitcoinを受け取ろう。

オンチェーンBitcoinと一緒にLightningも提供しよう。外部LNDノードか対応NWCウォレットをつなぐと、Wholly Cryptoが支払いリクエストを作成・追跡します。

ひと目でわかる概要

ネイティブコイン
BTC
対応トークン
ネイティブコインのみ
手数料の通貨
BTC (satoshis)
支払いの識別方法
BOLT11請求書
ウォレット設定
外部LND / NWC
手動送金 / 自動スイープ
送金は外部ウォレットで行います

受け取れる資産

LightningはBTC用で、ステーブルコインやオンチェーン送金は受け取りません。各リクエストには金額、支払いハッシュ、期限があり、請求額の全額を支払います。

Bitcoinのオンチェーン決済

ストアを設定しよう

設定 → チェーン接続でHTTPSのLNDかWSSのNWCを追加し、お店で有効にしよう。公開接続先が必要で、LAN専用やTor専用のアドレスは直接使えません。

認証情報と資金の管理

受取専用の限定権限を使い、LNDの管理者用・送金用macaroonは使わないでね。NWCは接続方式であり保管方式ではありません。誰が鍵を持つか確認しよう。

Lightningを設定

支払いの受取先

QRはBitcoinアドレスではなくBOLT11請求書です。オンチェーンで支払わないでね。期限切れなら新規作成が必要で、単純に期限延長はできません。

いつ支払いが完了する?

Wholly Cryptoは接続ウォレットが報告する決済を検証します。未払い請求書や保留HTLCは支払いではありません。Lightning入金にブロック確認や公開エクスプローラーリンクはありません。

準備ができたら資金を移そう

送金、チャネル流動性、バックアップは外部ウォレットやノードで管理しよう。オンチェーンスイープはLightning残高を移せず、プロジェクトのエクスポートは外部ウォレットのバックアップにもなりません。

Lightningウォレットガイド

支払いのトラブル対処

経路が見つからなければ受取流動性、ウォレットの稼働、期限を確認しよう。正常なAPIでも経路は保証されません。結果不明なら決済状態を確認してから再試行をお願いしてね。

手数料と検証

標準の処理手数料は請求書の法定通貨額の1%で、別のクレジット残高から引かれます。適用されるのは割り当て済みの料率です。ネットワークとサーバーの費用は別です。

公開プロバイダーには障害やリクエスト制限があります。送信済みの取引や戻り先への転送は支払いの証明ではありません。検証済みの請求書ステータスと署名付き通知を使ってね。

処理クレジット API・IPN・Webhook
為替計算機

金額を換算

換算元
換算先
概算額…

レートを読み込み中…

    概算であり、支払いの見積もりではありません。ネットワーク手数料、取引所手数料、加盟店のスプレッドは含みません。

    レートの出典は?

    暗号資産の概算にはキャッシュ済みの Kraken 公開価格を使い、利用可能な場合は Binance も使います。一部の Binance 価格は USDT を USD の基準にします。法定通貨は Frankfurter の日次参考レートで、リアルタイムの取引価格ではありません。

    スナップショットは自動更新されます。結果の下にある出典の日付を確認してください。入力額はブラウザー内にとどまります。資産の掲載は決済対応を保証しません。

    Kraken · Binance · Frankfurter · 資産名とアイコン:CoinGecko

    通貨を選択

    APIで請求書を作る

    サーバー上で実行し、APIホスト・プロジェクトID・ストアIDを置き換えよう。認証情報は秘密に。金額は10進数の文字列です。

    まずストアで有効にしよう。選択は有効な方法の絞り込みで、資産の追加ではありません。一致しなければストアの既定値になります。決済画面を出す前に返された方法を確認してね。

    : "${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"
        }
      ]
    }'
    請求書APIの詳しいリファレンス プロジェクトとストアのID API・IPN・Webhook