付款关联与金额不一致
本节介绍服务把入账链上交易关联到已开收款单的规则、金额不同时会发生什么，以及商户此时可以做什么。
收款单的状态、期限和状态流转见收款单生命周期。
金额匹配规则
创建收款单时，服务把法币金额换算成加密货币，并为收款单锁定这些金额。它们就成了付款的标识：买家在支付表单上看到的是这些金额，服务在链上找的也是金额恰好如此的交易。
付款金额必须与收款单金额完全一致，没有任何容差。应付金额对稳定币 USDT 和 USDC 取 2 位小数，对其他加密货币取 8 位小数，入账付款与之精确比对。任何偏差——无论多小的少付或多付——都意味着不会发生自动关联。
示例。开出一张 100.00 USD 的收款单，锁定金额为 100.12 USDT。
| 入账付款金额 | 结果 |
|---|---|
| 100.12 USDT | 收款单自动转为已支付 |
| 100.11 USDT | 不自动关联 |
| 100.50 USDT | 不自动关联 |
如果同一地址同时开出多张相同法币金额的收款单，服务会给每张分配略有不同的加密货币金额。唯一性在该钱包上所有待支付收款单范围内检查，因此同一地址可以放心用于自己的多个项目——金额不会冲突。
金额不一致最常见的原因：买家手动取整了金额，或从交易所提现时被扣了网络手续费。请提醒买家严格按支付表单显示的金额转账。
金额不一致时会发生什么
服务会记录资金已到达，但不对收款单做任何操作：
- 收款单状态不变。在支付期限之前保持待支付。检索窗口开放期间，买家仍可用正确的金额关闭它。
- 不发送 Webhook。发往 Webhook URL 的通知只在收款单转为已支付的那一刻发出。
- 不跟踪部分付款。服务不识别少付，也不为收款单记欠款余额。
- 付款不累加。买家少付后又补转差额的话，两笔付款不会相加，都作为独立的未关联付款保留。
- 多付不自动退款。资金直接进入商户的钱包；把差额退给买家在服务之外处理。
服务中没有“部分支付”或“多付”之类的中间状态。
商户如何得知问题
如果项目设置中启用了通知，每笔入账付款商户都会收到邮件和 Telegram 机器人消息——无论它是否关联到了收款单。
由此得到一条简单的诊断规则：收到了入账付款通知，却没有随后的收款单已支付通知，说明付款因金额不一致而未关联，需要人工处理。
这条规则只在检索窗口内有效。只有当至少还有一张收款单在检索中时，服务才监控钱包。如果买家付款时已没有这样的收款单，这笔付款根本不会进入系统——没有通知，也无法手动关联。
也可以用程序查找未关联的付款。payments/list 方法返回所有钱包上的付款，未关联到收款单的付款在响应中没有 invoice 块。它们就是手动关联的候选：把金额和时间与预期的收款单对比，然后调用 invoices/bindPayment。
手动关联付款
确定哪笔付款对应哪张收款单时，可以手动关联——在控制台的收款单页面或付款列表中，或通过 API 的 invoices/bindPayment 方法。
关联条件
只有同时满足所有条件才能关联：
- 收款单处于待支付或已过期状态。已取消和已支付的收款单无法关联。
- 付款尚未关联到其他收款单。一笔付款只能绑定一张收款单。
- 付款到达的是该收款单涉及的钱包。
- 付款落在可用的付款窗口内——收款单创建前 24 小时到创建后 24 小时。
这个窗口比收款单的有效期更宽，由此带来两种可能：可以把付款关联到已过期的收款单，也可以把收款单关联到在其创建之前到达的付款。后者在买家主动转账、收款单在资金到达后才开出时很实用。
关联之后会发生什么
- 收款单转为已支付——与自动关联时一样。
- Webhook 一定会发送。每次转为已支付都会发出通知，无论关联以哪种方式完成。
- 收款单的 USD 金额按实际付款重算。
amountFiatUSD字段被实际收到的金额覆盖，按关联时的汇率折算。amountFiat中的原始金额不变。 - 服务费按实际金额重算。按项目费率对实际收到的金额收取。