支付状态模型与资金边界

日期： 2026-09-18

状态： 支付与退款状态已发布；银行和分账状态仅作内部只读投影

SmartPay 的支付状态来自已接入支付通道的权威结果。银行账户、清分和结算状态属于对应银行产品，不能从支付状态推断，也不表示 SmartPay 持有或划拨资金。

1. 支付状态

text

CREATED -> PROCESSING -> BANK_ACCEPTED -> CLEARING -> SUCCEEDED
              |               |              |
              +---------------+--------------+-> CLOSED | REVOKED | FAILED
SUCCEEDED -> PARTIALLY_REFUNDED -> REFUNDED

BANK_ACCEPTED 和 CLEARING 是部分支付产品的中间态。前端回跳不改变订单状态；平台只接受验签后的通道通知、主动查询和受控对账任务形成的证据。

2. 退款状态

text

CREATED -> ACCEPTED -> SUCCEEDED | FAILED

ACCEPTED 只表示上游受理。客户必须以退款查询结果或已发布的 refund.succeeded / refund.failed Webhook 为准。

3. UNKNOWN 与主动查询

超时、无明确结果或上游暂未返回时，不能猜测成功或失败。
结果未知时使用原业务单号查询，并用相同 Idempotency-Key 重试原写操作；不得更换单号重复创建。
SmartPay 定时反查并记录对账证据，长期未收敛的记录进入人工处置。

4. 银行和分账投影

运营台、商户工作台和只读 MCP 中出现的银行指令、清分规则、计划或结算数据，是配置及证据投影：

银行余额、流水和回单以银行账务为权威；
分账执行能力以具体持牌机构的签约产品为准；
经营分润统计不等同于资金分账；
当前没有银行资金操作或分账写入类支付开放 API。

5. 金额精度

支付与退款金额使用整数分。业务规则如涉及比例计算，也必须在服务端使用整数算法并保存可审计尾差，禁止用浮点数直接生成资金类金额。

支付状态模型与资金边界 ​

1. 支付状态 ​

2. 退款状态 ​

3. UNKNOWN 与主动查询 ​