架构与系统设计 / 系统课时
核心支付链路
核心支付链路
本课梳理一笔支付从商户发起下单,到平台选择通道、接收支付结果、通知商户并最终完成订单的全过程。学完后,你能够识别每个阶段的职责、关键状态,以及异常情况下如何让订单最终收敛。
学习目标
- 说清支付请求在商户、平台、渠道之间的流转顺序
- 理解同步响应、异步通知和主动查询各自解决的问题
- 掌握幂等、状态机与补偿机制在支付链路中的作用
链路全景
一笔支付通常会经过“商户下单、平台受理、路由选通道、渠道执行、结果回传、商户通知、订单完成”七个阶段。真正困难的地方不在于发起一次请求,而在于网络超时、重复通知和状态延迟发生时,平台仍能给出唯一且可信的最终结果。

这条链路中存在两个不同的“结果”。同步响应只表示本次接口调用是否被受理,异步通知才更接近支付最终状态。因此,商户不能仅凭一次同步响应就认定支付成功。
商户下单与平台受理
商户首先向平台提交统一支付请求。平台需要完成签名验证、参数校验、商户状态检查、支付方式检查和订单幂等判断,然后创建平台订单。订单号通常由平台生成,商户订单号由商户提供,两者共同构成后续查询和对账的依据。
典型统一下单请求如下。它是数据结构示例,字段名称以实际接口定义为准。
{
"merchantNo": "M10001",
"merchantOrderNo": "ORDER202608030001",
"amount": 12800,
"currency": "CNY",
"payMethod": "WECHAT",
"subject": "企业采购订单",
"notifyUrl": "https://merchant.example.com/payment/notify",
"requestId": "REQ202608030001"
}金额应使用最小货币单位,例如 12800 表示 128.00 元,避免浮点数带来的精度问题。requestId 或商户订单号必须具备唯一性,平台重复收到同一业务请求时,应返回原订单结果,而不是再次创建订单。
路由与渠道支付
平台受理订单后,会根据支付方式、币种、地区、金额、商户权限、通道可用性和成本等条件选择渠道。路由结果确定后,平台把统一订单转换成渠道所需的参数格式,并保存渠道订单号,随后把支付凭证或收银台地址返回给商户。
此时平台订单通常进入 PROCESSING 状态。渠道同步返回成功,只能说明渠道已经接收请求;如果用户尚未完成付款,订单仍不能进入 SUCCESS。当渠道调用超时且结果未知时,也应保留处理中状态,避免误判失败后重复扣款。
结果通知与状态收敛
用户支付完成后,渠道一般通过异步通知告知平台。平台先验签,再按平台订单号或渠道订单号找到订单,只允许合法状态转换,例如从 PROCESSING 进入 SUCCESS,不能让已成功订单被后续重复通知改成失败。
平台更新订单后,再向商户的 notifyUrl 发送通知。商户应先验证签名,再执行本地业务,并在处理成功后返回约定响应。若平台未收到确认,会按照退避策略重试通知,因此商户通知接口必须支持幂等。
当异步通知丢失或长时间未到达时,平台需要主动查询渠道。查询结果用于补偿本地状态,但不能绕过状态机直接覆盖订单。最终目标是让平台订单、渠道订单和商户业务状态逐步收敛为同一结果。
关键控制点
幂等控制解决“同一请求被执行多次”的问题。下单接口可使用商户号与商户订单号建立唯一约束,通知处理可使用平台订单号和目标状态判断是否已经完成。
状态机解决“订单能否从当前状态进入下一状态”的问题。常见主状态包括 INIT、PROCESSING、SUCCESS、FAILED 和 CLOSED。支付成功通常是终态,除非业务通过退款流程产生新的退款状态,而不是回退原支付订单。
补偿机制解决“结果暂时未知”的问题。平台可通过定时任务查询处理中订单,通过消息重试商户通知,并对超过时限仍无法确认的订单触发人工核查或告警。
验收检查
完成链路设计后,应至少验证以下场景:
- 同一商户订单重复提交时,只生成一笔平台订单
- 渠道同步超时但实际支付成功时,主动查询能够修正状态
- 渠道重复通知和乱序通知不会破坏已确认的终态
- 商户通知失败时能够重试,并且商户重复处理不会重复发货
- 平台订单号、渠道订单号和商户订单号能够贯穿查询与对账