BTCPay Server:自托管Bitcoin商户收款服务
id:btcpayserver/btcpayserver ·
· 目录记录
项目概述
商户自托管的Bitcoin收款处理器:生成发票/checkout,监测直接到商户钱包的支付,按确认政策记录结算并通知集成系统。不是托管交易所,也不替商户保证法币汇率。已补读本仓官方user guide与Invoices文档,未调查源码。
原项目介绍
忠实中文 / 作者自述整理
作者称免费、开源、自托管Bitcoin payment processor,可不经中介让商户直接收Bitcoin;without fees是作者平台定位,不是没有链费/服务器成本。
短摘 / 原文
a free and open-source, self-hosted Bitcoin payment processor
出处:https://github.com/btcpayserver/btcpayserver/blob/HEAD/README.md
is_self_report:True
quote_provenance:only_reconstructed_local_text_match_independent_verbatim_check_pending
quote_verification_caveat:便签/重建摘录自身可能含同一句;字面命中不是独立原文认证;非重建选段也非完整原文/固定版本
当前具体详情(详情待补)
待补原因:保留既有文稿/README内容,但尚未按pt780u具体描述标准逐项复核,不自动计完成;不表示既有内容全部无效。
做什么
商户自托管的Bitcoin收款处理器:生成发票/checkout,监测直接到商户钱包的支付,按确认政策记录结算并通知集成系统。不是托管交易所,也不替商户保证法币汇率。已补读本仓官方user guide与Invoices文档,未调查源码。
谁会用
加密付款应用开发者与商户技术人员
用户画像依据
按项目定位概括的可能用户,非新增作者确认
解决的问题(编辑归纳)
未写/未核(null)
文档化使用场景(编辑归纳)
未写/未核(null)
主要能力与用途
可设store/支付方式、限时固定金额/汇率的invoice、展示checkout并追踪支付;可按权限查看/标记/退款/导出。payment request是可多次生成新invoice的长期请求,不等同invoice;pull payment把收款目的地提交与商户批准payout分开。
如何使用 / 既有稿流程
{
"business_flow_from_existing_study": "金额/币种/支付方式→创建New发票并固定短期汇率→checkout付款→全额检测后Processing→达到该支付方式/商户settlement条件后Settled,才按业务政策履约。未付足到期Expired;全付但未在监控期达到settlement条件为Invalid。Paid partial/over/late为异常;late full仍Expired待处理,Marked是手工标记不证明链上确认。退款创建pull payment,顾客提交目的地后商户再审/处理payout,不是点退款就已转账。archive只是隐藏,不删除/停监测;多支付可导出多行,未付New/Expired不进所述报告,不能按行数当订单数。",
"deployment_from_existing_study": "官方用户/运营分工:operator管数据库/节点同步/更新/备份,store用户管钱包/发票/权限/集成。Greenfield API应最小权限,webhook接收方需验证事件/安全处理重试;本文没读具体认证/重试实现。watch-only和hot wallet风险不同,Lightning另有流动性/备份条件。平台无费≠链费/hosting/节点零成本;没有注册、创建store/发票、连接/生成钱包或付款。"
}用法证据状态
existing_study_reuse_not_new_verification
公开限制
现可证文档状态机,不等于源码实现/在线实例已验。广播≠settled,手工Marked≠链上确认;节点/索引不同步会漏检测,需商户复核。docs.btcpayserver.org/Invoices本次跳转占位仍记录,改用README已链到的本仓用户文档补证,不以跳转认定项目失效。
根README及docs/users/README.md、docs/users/invoices.md文档层;已补完整发票状态/失败分支,未读控制器、服务/数据库/回调实现,非源码或实际收款验证。
未核实 / 来源缺口
未写/未核(null)
许可讨论
spdx_snapshot
MIT
discussion_zh
根README链接MIT;未读全部LICENSE/插件和依赖授权,代码许可不等于代收业务的监管许可。
strict_open_source_verified
False
完成评估
status
details_pending
count_as_completed
False
reason_zh
保留既有文稿/README内容,但尚未按pt780u具体描述标准逐项复核,不自动计完成;不表示既有内容全部无效。
completion_scope_zh
文档级具体描述;非源码/运行、安全、收益或许可全文核验
standard_id
pt780u-concrete-v1
assistant_itemwise_content_reviewed
False
human_reviewed
False
assessment_recorded_cst
2026-11-17T08:58:55.997284+08:00
来源
https://github.com/btcpayserver/btcpayserver/blob/HEAD/README.md
{ "path": "README.md(已读全文或选段,见证据摘要)" }https://github.com/btcpayserver/btcpayserver/blob/HEAD/docs/users/README.md
{ "path": "docs/users/README.md" }https://github.com/btcpayserver/btcpayserver/blob/HEAD/docs/users/invoices.md
{ "path": "docs/users/invoices.md" }
研究层级与范围
{
"tier": "L_existing154_study_reuse",
"status": "existing_study_overview_reused_not_new_research",
"new_source_read_this_phase": false,
"json_path": "research/projects/btcpayserver--btcpayserver.json(数据包相对路径,不是站点 URL)",
"markdown_path": "research/projects/btcpayserver--btcpayserver.md(数据包相对路径,不是站点 URL)",
"legacy_quote_provenance": "only_reconstructed_local_text_match_independent_verbatim_check_pending",
"editorial_erratum": null,
"source_code_claim": "无新增源码实证"
}