495 / 691PAY·PROC

Bitcoin Payment Processor

比特币支付处理器

软件或服务将订单与比特币支付关联,跟踪支付状态,并将结果传回收银系统。资金托管、付款确认及后续结算方式取决于具体方案。

Bitcoin Payment Processor 创建付款请求,将收到的付款匹配到订单,并支持记录管理。它可以自行部署,也可以作为服务提供。它不是比特币共识规则,“处理器”这一名称也不能说明谁控制资金。

商店创建订单,由其服务器向处理器申请包含金额和币种的账单,并保存内部订单号与账单标识符之间的关联。客户获得支付页面或二维码,处理器跟踪收款。没有这一关联,就无法可靠判断付款对应哪笔订单;仅仅返回浏览器页面并不构成已付款证明。 [BTCPay Server — eCommerce integration]

BTCPay Server 可以利用已有钱包的公开数据推导收款地址,而无需该钱包的私钥。这不同于存放在服务器上的热钱包,也不同于访问 Lightning 节点资金。服务商可能在向商家拨款前持有资金。应检查实际的密钥持有情况、权限和提现能力,而不是只看产品名称或 non-custodial 一词。 [BTCPay Server — General FAQ] [BitPay — Configuring settlements]

普通的 BTCPay Server 账单会在有限时间内锁定汇率。账单过期并不意味着后续转账无法到账。少付、多付和迟付具有不同状态,需要相应的后续处理。应保存原始金额和采用的汇率;价格变化后,新建付款请求要求的聪数可能不同。 [BTCPay Server — Invoice lifecycle]

BTCPay Server 区分等待所设确认次数的 Processing 和 Settled;成功的 Lightning 支付无需等待区块便进入 Settled。其他服务商的状态名称不能直接视为等同:BitPay 明确警告,paid 并不保证付款。商店必须针对具体状态和支付方式制定交付规则。手动修改状态不会产生网络确认。 [BTCPay Server — Invoice lifecycle] [BitPay — Invoice webhooks]

BTCPay 使用共享密钥,对请求体原始字节计算 HMAC-SHA256 来验证 webhook。BitPay 则描述了未签名的 IPN:通知应触发通过 API 查询账单状态,本身不是可信凭证。通知可能重复到达。因此,集成必须可靠识别重新投递的事件,防止同一订单再次发货;故障恢复后还必须将已保存的状态与处理器核对。 [BTCPay Server — Webhook validation example] [BitPay — Invoice webhooks]

客户付款的确认时间不一定与服务商拨款时间一致。BitPay 允许设置结算币种以及银行账户或加密货币地址,变更可能需要批准。应检查支持币种、限额、时间安排、费用,以及拨款前谁控制资金。直接收款到自己的钱包并不会自动采用这种服务商拨款模式。 [BitPay — Configuring settlements] [BTCPay Server — General FAQ]

退款需要另一次付款并核实收款人,不会修改原始比特币交易。应区分订单争议、退款金额决定与实际转出资金。保留订单—账单—付款的关联、汇率、费用及退款记录。导出报告有助于记账,但本身不能解决所有本地会计义务或商品交付纠纷。 即使转账已确认,也不能单凭这一点确定交易在法律上最终结清:应按支付渠道、合同和司法辖区核查争议处理、可能的 chargeback 机制及相关义务。 [BTCPay Server — Refunds] [BTCPay Server — Reporting] [BitPay — Merchant and shopper terms]

测试成功、金额不足、迟到和重复通知的付款,以及故障后的恢复。API 密钥只授予必需权限,并限制在对应商店内。不要向元数据传入不必要的客户资料。应考虑托管、更新、流动性及支持成本;免费软件不等于零运营成本。服务可用性、密钥保管和集成正确性是彼此独立的条件。 [BTCPay Server — eCommerce integration] [BTCPay Server — Lightning operations]

示例 · PAY·PROC

同一通知不是另一笔购买

在一个假设集成中,订单 OBJ-101 保存了账单标识符。系统核实结算完成后,只创建一次发货。之后若收到同一事件的重复通知,就将其关联到已经履行的订单,不再创建发货。仅显示感谢页面不得触发这一状态转换。

要获得更完整的理解,请将本词条与以下词条结合阅读: BTCPay Server, Bitcoin Point of Sale, Merchant Adoption, Lightning Network, Bitcoin. 反向关联还来自: Alza比特币支付, Merchant Adoption, BTCPay Server, Bitcoin Point of Sale.

01每个支付处理器都会持有我的比特币吗?

不会。有些方案仅创建请求并跟踪资金进入你的钱包,另一些则管理资金直到拨款。即使同一软件也可能采用不同钱包模式。关键是密钥、权限和实际资金流向,而不是“处理器”这个名称。

02客户从支付页面返回后,商店就可以发货吗?

仅返回页面不够。商店必须按照该处理器的流程核实对应账单及其状态。通知应按文档验证,重复投递不得触发再次履约。商品交付应遵循所选择的付款确认条件。

DOC · 001BTCPay Server — eCommerce integration文档 ↗DOC · 002BTCPay Server — General FAQ文档 ↗DOC · 003BTCPay Server — Invoice lifecycle文档 ↗DOC · 004BTCPay Server — Webhook validation example文档 ↗DOC · 005BitPay — Invoice webhooks文档 ↗DOC · 006BitPay — Configuring settlements文档 ↗DOC · 007BTCPay Server — Refunds文档 ↗DOC · 008BTCPay Server — Reporting文档 ↗DOC · 009BTCPay Server — Lightning operations文档 ↗DOC · 010BitPay — Merchant and shopper terms一手来源 ↗
来源优先 · 非投资建议