ビットコイン LIGHTNING
Lightning の支払いを受け付けよう。
受取ウォレットを接続してストアで有効にすると、顧客が Lightning の QR コードで支払えます。
必要なのは公開ノードではなく、ウォレットへの接続。
公開 Bitcoin エンドポイントはブロックチェーンを読めますが、代わりに Lightning の支払いを受け取ることはできません。Lightning には請求書を作成し、決済確定を報告するウォレットが必要です。
| 利用する構成 | 接続方法 | 誰が管理する？ |
|---|---|---|
| 自分のノード | HTTPS 経由の LND、または対応 NWC ウォレット | 鍵、チャネル、流動性、バックアップを自分で管理します。 |
| 運用支援付き自己管理ウォレット | NWC（例：ホスティング付き Alby Hub） | サービスが運用を支援します。鍵の管理権と復旧へのアクセスを自分で保持できるか確認してください。 |
| カストディ型アカウント | 対応プロバイダーの NWC 接続 | プロバイダーが資金を保管します。手数料、アカウント上限、本人確認の要件はプロバイダーによります。 |
NWC は接続プロトコルで、資産保管を保証するものではありません。 事業に合ったウォレットの方式を選んでください。Wholly Crypto は Lightning の資金を保管せず、ノードもインストールしません。
自分の LND ノードを接続しよう。
- 開く 設定 → チェーン接続 → Lightning を接続。選ぶ項目： LND · HTTPS.
- 外部から到達できる HTTPS REST エンドポイントと、権限を限定した 16 進形式の macaroon を入力します。請求書の読み書きを許可し、必要に応じて次も許可します：
info:read。コマンドに追加：offchain:readはチャネル残高を表示したい場合に使います。絶対に使わないもの：admin.macaroon。支出権限も与えないでください。 - LND が独自の TLS 証明書を使う場合は、公開 PEM 証明書を貼り付けます。TLS 秘密鍵は貼り付けないでください。ノードのファイアウォールで加盟店 VPS からのアクセスを許可します。
- 接続の利用を許可するプロジェクトを選びます。確認して保存し、新規請求書用に有効化します。
ノードは Bitcoin メインネットと同期している必要があります。TLS 検証は有効のままです。公開 HTTPS アドレスのみを受け付け、プライベート、ループバック、予約アドレスは拒否します。ノードは決済サーバーと分けてください。
Nostr Wallet Connect で接続しよう。
- Alby Hub または対応ウォレットで、受取専用の接続を作成します。
- 許可
make_invoice,lookup_invoiceとget_info.get_balanceは任意です。支払いや出金のメソッドは許可しないでください。 - 選択 Nostr Wallet Connect を Wholly Crypto で選び、次の完全な接続文字列を貼り付けます：
nostr+walletconnect://…。パスワードと同じように扱ってください。 - 接続文字列には公開 WSS リレーを 1 つ指定します。資産保管の方式とプロジェクトのアクセス権を選び、確認して保存します。
Wholly Crypto は署名付き応答を検証し、NIP-44 v2 暗号化と従来の NIP-04 互換に対応します。ウォレットには、決済確定の証拠を伴う受取請求書の照会機能が必要です。すべての NWC アカウントが全受取メソッドに対応するわけではありません。
ストアで有効にしよう。
開く プロジェクト → ストア → 決済方法 → Bitcoin Lightning。接続を選んでオンにします。オンチェーンの Bitcoin は別の選択肢で、片方だけでも両方でも提供できます。
手動または通常の API で少額の請求書を作ります。決済画面で Bitcoin、次に Bitcoin Lightning を選びます。QR コードを読み取るか Lightning ウォレットでリクエストを開きます。請求書作成用の新しい API 経路は不要です。
支払い済みとは、決済確定済み。
各リクエストに専用の BOLT11 請求書と支払いハッシュを作ります。価格はストアの法定通貨とスプレッドを使い、整数のサトシに切り上げます。Wholly Crypto はミリサトシ精度で入金を記録します。
保留または検出だけでは不十分です。ウォレットが有効な支払い証拠とともに決済確定を報告する必要があります。ブロック承認は不要です。請求書履歴、処理手数料、IPN、Webhook は通常の請求書の流れに従います。
LND は接続ごとに 1 つの決済購読と復旧用照会を使い、NWC は請求書照会を使います。保留中の照会は通常約 10 秒ごとですが、障害、待ち行列、プロバイダーの制限で更新が遅れる場合があります。未確定リクエストは加盟店請求書の期限後も 24 時間監視します。
認証情報を無効化・交換しても、既存のリクエストは別のウォレットへ移りません。保留中のリクエストが完了するまで古い受取認証情報を有効にしてください。期限切れやキャンセル済みのリクエストには支払わないでください。
この連携は支払いの受け取り用です。送金、返金、チャネル管理、取引所への移動には接続したウォレットを使ってください。Lightning 残高は共有ウォレットの残高で、プロジェクト別ではありません。プロバイダー、ルーティング、チャネルの費用は Wholly Crypto の処理手数料と別です。
容量とバックアップを用意しよう。
ノードで受け取るには入金側のチャネル容量が必要です。接続済みウォレットでも利用できる経路や受取容量がなければ、支払いを受け取れない場合があります。流動性サービスが役立つこともありますが、費用と条件は異なります。
プロジェクトウォレットのテキストバックアップには Lightning は含まれません。 必要なチャネルバックアップを含め、ノードやウォレットの復旧手順に従ってください。シードフレーズだけではチャネル資金を安全に復旧できない場合があります。請求書の追跡と暗号化された接続認証情報を保持するため、Wholly Crypto のデータベースと暗号化鍵をバックアップしてください。
まず接続を確認しよう。
- アクセス拒否： 受取権限と認証情報の有効性を確認してください。
- 接続失敗： HTTPS/WSS、TLS、DNS、ファイアウォールのアクセス、ウォレットのオンライン状態を確認してください。
- リクエスト利用不可： プロジェクトのアクセス権、ストアの有効化、現在のレート、ウォレットのメインネット状態を確認してください。
- 支払いをルーティングできない： Lightning ウォレットの入金側の流動性を確認してください。API 接続が正常でも経路がある証明にはなりません。
顧客に Lightning を提供する前に、少額の支払いと通知の流れを試してください。ウォレットの鍵、macaroon、NWC の秘密情報はサポートにも送らないでください。