BTCPAY SERVER 插件
在 BTCPay 结账中接受稳定币。
添加 Wholly Crypto 以接受 USDC、USDT 和商店接受的其他资产。保留现有 BTCPay Bitcoin 和 Lightning 支付方式。
获取插件
v1.0.1需要 BTCPay Server 2.4.4+ 和独立的 Wholly Crypto 安装。已在 BTCPay 2.4.4 测试；较新版本请在自己的部署环境中测试。
MIT 许可证 · 独立连接器，不代表 BTCPay 背书，也未收录于其目录。
你的结账，更多选择
- 托管结账或可选的嵌入式 iframe
- 从 Wholly 商店接受的网络和资产中选择
- 签名 IPN 与经过身份验证的 API 检查
- 可搜索的关联付款与连接诊断
付款进入你的 Wholly 项目钱包。连接器不需要钱包密钥。适用 Wholly 处理额度规则；插件不额外收取比例费用。
安装
- 下载
BTCPayServer.Plugins.WhollyCrypto.btcpay并与该版本的以下信息核对：SHA256SUMS。使用插件文件，不要使用 GitHub 的源码 ZIP。 - 以 BTCPay 管理员身份打开 管理插件 → 上传插件，上传文件并重启 BTCPay。
- 选择商店 → 插件 → Wholly Crypto。 仅安装不会连接商店。
更新使用相同的上传流程。更新 Wholly 商户软件不会更新 BTCPay 插件。
连接商店
- 在 Wholly 中创建已启用的项目和商店，并配置支付方式、已备份钱包、汇率和确认数。使用当前商户版本；此连接器面向 6.4.5 API。
- 从以下位置复制项目和商店 UUID： 商店 → 基本设置 → API ID。创建限定项目的读写 API 凭据。启用 商店 → IPN 并复制其签名密钥，不要使用 Webhook 密钥。
- 在 BTCPay 的 Wholly 设置中输入这些值，以及 API 和结账源站地址，例如
https://api.example.com和https://pay.example.com。使用 443 端口的公共 HTTPS，不含路径。 - 启用 在结账时提供 Wholly Crypto，保存，然后 测试读取权限。也可只选用商店已接受支付方式中的一部分。
在两道防火墙中允许 Wholly 服务器向 BTCPay 发送 HTTPS 回调。插件会提供回调 URL。此路由不要启用浏览器登录、CAPTCHA 或 Basic Auth；签名检查必须保持启用。
嵌入式结账
默认使用完整页面结账，尤其适合移动钱包应用。使用 iframe 时：
- 在 Wholly 的 商店 → 高级中启用 允许嵌入式结账。将 BTCPay 的准确 HTTPS 源站地址添加到 允许的 HTTPS 源站，不带路径或通配符。
- 在 BTCPay 插件设置中选择 客户结账 → 嵌入式结账（iframe） 并保存。
- 测试新账单。现有账单保持原始显示模式。 打开完整结账页面 在框架无法加载时，仍可用于同一账单。
浏览器消息和返回链接仅用于导航，绝不构成付款证明。
检查支付流程
在测试商店创建一张小额、正数的法币账单。选择 稳定币与加密货币 · Wholly。验证结账、签名 IPN 和 API 验证流程直至确认完成。仅根据 BTCPay 已结算的账单履行订单，每个订单只处理一次。
测试读取权限 不测试账单创建或 IPN。使用 连接 和 关联付款 查看安全的错误信息、订单参考和付款检查。