比特币闪电网络

接受 Lightning 付款。

连接收款钱包，在商店中启用，让客户使用 Lightning 二维码付款。

需要钱包连接，而非公共节点。

公共 Bitcoin 端点可以读取区块链，但无法替你接收 Lightning 付款。Lightning 需要能够创建账单并报告结算状态的钱包。

你的配置	连接方式	由谁管理？
自己的节点	通过 HTTPS 连接 LND，或使用兼容的 NWC 钱包	由你管理密钥、通道、流动性和备份。
托管运行的自托管钱包	NWC，例如托管的 Alby Hub	由服务商协助运行。请确认你仍保有密钥控制权和恢复权限。
托管账户	兼容服务商的 NWC 连接	服务商持有你的资金。费用、账户限额和验证要求取决于服务商。

NWC 是连接协议，不是资金托管保障。 选择适合业务的钱包模式。Wholly Crypto 不持有 Lightning 资金，也不安装节点。

打开 设置 → 区块链连接 → 连接 Lightning。选择 LND · HTTPS.
输入外部可访问的 HTTPS REST 端点，以及十六进制格式的受限 macaroon。允许账单读写，以及 info:read。添加 offchain:read 以显示通道余额。绝不要使用 admin.macaroon 或授予支出权限。
如果 LND 使用自己的 TLS 证书，请粘贴其公共 PEM 证书。不要粘贴 TLS 私钥。在节点防火墙中允许商户 VPS 访问。
选择允许使用此连接的项目。检查并保存，然后为新账单启用。

节点必须与 Bitcoin 主网同步。TLS 验证保持开启。此连接只接受公共 HTTPS 地址，私有、环回和保留地址会被阻止。请将节点与支付服务器分开。

在 Alby Hub 或其他兼容钱包中创建专用收款连接。
允许 make_invoice, lookup_invoice 和 get_info. get_balance 为可选项。不要允许付款或提现方法。
选择 Nostr Wallet Connect ，在 Wholly Crypto 中粘贴完整的 nostr+walletconnect://… 连接字符串。像保护密码一样保护它。
连接字符串中使用一个公共 WSS 中继。选择托管模式和项目权限，然后检查并保存。

Wholly Crypto 验证签名响应，支持 NIP-44 v2 加密并兼容旧版 NIP-04。钱包必须支持带结算证明的入账账单查询。并非所有 NWC 账户都支持全部收款方法。

打开 项目 → 商店 → 支付方式 → Bitcoin Lightning。选择连接并启用。链上 Bitcoin 是独立选项，可以提供其中一种或同时提供两种。

手动或通过常规 API 创建小额账单。在结账中选择 Bitcoin，然后选择 Bitcoin Lightning。扫描二维码或在 Lightning 钱包中打开请求。创建账单无需新的 API 路由。

每个请求都有独立的 BOLT11 账单和支付哈希。价格使用商店法币币种和加价比例，并向上取整到整数聪。Wholly Crypto 以毫聪精度记录收款。

付款处于保留或已检测状态并不足够。钱包必须报告已结算并提供有效付款证明。无需区块确认。账单历史、处理费、IPN 和 Webhook 遵循正常账单流程。

LND 对每个连接使用一个结算订阅及恢复查询。NWC 使用账单查询。待处理查询通常约每 10 秒运行一次；故障、队列和服务商限制可能延迟更新。未结算请求会在商户账单到期后继续监控 24 小时。

禁用或更换凭据不会将现有请求转移到其他钱包。请保持旧收款凭据有效，直到待处理请求完成。过期或已取消的请求不得付款。

此集成用于收款。发送、退款、通道管理或交易所转账请使用连接的钱包。Lightning 余额是共享钱包余额，不是各项目独立钱包。服务商、路由和通道费用与 Wholly Crypto 处理费分开计算。

节点需要入站通道容量才能收款。已连接的钱包若没有可用路由或收款容量，仍可能无法收到付款。流动性服务可能有帮助，但费用和条件各异。

项目钱包文本备份不包含 Lightning 备份。 请遵循节点或钱包的恢复流程，包括所需的通道备份。仅有助记词可能无法安全恢复通道资金。备份 Wholly Crypto 数据库和加密密钥，以保留账单跟踪及加密的连接凭据。

向客户提供 Lightning 前，先测试小额付款及其通知流程。绝不要向支持人员发送钱包密钥、macaroon 或 NWC 机密。