架构与系统设计 / 系统课时

核心支付链路

核心支付链路

本课梳理一笔支付从商户发起下单,到平台选择通道、接收支付结果、通知商户并最终完成订单的全过程。学完后,你能够识别每个阶段的职责、关键状态,以及异常情况下如何让订单最终收敛。

学习目标

  • 说清支付请求在商户、平台、渠道之间的流转顺序
  • 理解同步响应、异步通知和主动查询各自解决的问题
  • 掌握幂等、状态机与补偿机制在支付链路中的作用

链路全景

一笔支付通常会经过“商户下单、平台受理、路由选通道、渠道执行、结果回传、商户通知、订单完成”七个阶段。真正困难的地方不在于发起一次请求,而在于网络超时、重复通知和状态延迟发生时,平台仍能给出唯一且可信的最终结果。

核心支付链路端到端流程图

这条链路中存在两个不同的“结果”。同步响应只表示本次接口调用是否被受理,异步通知才更接近支付最终状态。因此,商户不能仅凭一次同步响应就认定支付成功。

商户下单与平台受理

商户首先向平台提交统一支付请求。平台需要完成签名验证、参数校验、商户状态检查、支付方式检查和订单幂等判断,然后创建平台订单。订单号通常由平台生成,商户订单号由商户提供,两者共同构成后续查询和对账的依据。

典型统一下单请求如下。它是数据结构示例,字段名称以实际接口定义为准。

json
{
  "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。支付成功通常是终态,除非业务通过退款流程产生新的退款状态,而不是回退原支付订单。

补偿机制解决“结果暂时未知”的问题。平台可通过定时任务查询处理中订单,通过消息重试商户通知,并对超过时限仍无法确认的订单触发人工核查或告警。

验收检查

完成链路设计后,应至少验证以下场景:

  • 同一商户订单重复提交时,只生成一笔平台订单
  • 渠道同步超时但实际支付成功时,主动查询能够修正状态
  • 渠道重复通知和乱序通知不会破坏已确认的终态
  • 商户通知失败时能够重试,并且商户重复处理不会重复发货
  • 平台订单号、渠道订单号和商户订单号能够贯穿查询与对账
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

核心支付链路

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通