1.1 要解决的业务问题#

支付链路至少要回答六个问题：

1. 用户只能为哪些订单获取支付页面？
2. 第三方平台使用哪个业务编号识别本地订单？
3. 回调怎样证明来自支付宝，而不是客户端伪造？
4. 回调中的应用、状态、订单号和金额怎样与本地事实核对？
5. 支付宝重复通知时，怎样避免重复推进订单和库存？
6. 支付流水已经更新、订单远程调用却失败时，系统处于什么状态？

1.2 本章学习目标#

读完本文后，应能沿源码讲清：

• UNPAID 订单怎样生成支付宝页面；
• payment_info 为什么要在回调前落库；
• 回调为什么必须先验签、再校验业务参数、最后做幂等；
• notify_id 怎样形成 Redis 防重键；
• 本地支付流水怎样从 UNPAID 变成 PAID；
• 支付服务怎样通过 Feign 推进订单和仓储链路；
• 当前实现在哪些地方仍存在重复写、精度和跨服务一致性风险。

1.3 本文不展开的内容#

• 支付宝账号、密钥、网关地址和 Nacos 配置；
• 项目的环境搭建、启动、联调或冒烟步骤；
• 仓储按仓拆单和库存锁定的完整实现；
• 当前代码没有实现的退款、对账和补单系统。

2.1 模块职责#

2.2 技术在当前链路中的用途#

3.1 生成支付页面#

代码已确认的调用顺序如下：

这里先查订单，再创建支付流水。payment_info 因此成为本地系统核验回调的依据：只有能在本地找到相同 outTradeNo 和支付渠道的流水，回调才会继续处理。

4.1 三个支付入口#

仓库内只能确认服务内部路径。客户端是否还要经过 Gateway 前缀，取决于 Nacos 中的路由配置，本轮没有运行验证。

4.2 回调分支真值表#

4.3 关键回调参数#

当前代码没有逐个校验参数是否为空；参数缺失时可能进入构造 BigDecimal、拼接 Redis key 或查询数据库等后续路径。这是静态可见的输入健壮性边界。

5.1 PaymentInfo 保存什么#

代码路径：duolaimall-pay/pay-service/src/main/java/com/cskaoyan/mall/payment/model/PaymentInfo.java

1
@Data
2
@TableName("payment_info")
3
public class PaymentInfo extends BaseEntity {
4

5
    @TableField("out_trade_no")
6
    private String outTradeNo;
7

8
    @TableField("order_id")
9
    private Long orderId;
10

11
    @TableField("user_id")
12
    private Long userId;
13

14
    @TableField("payment_type")
15
    private String paymentType;
16

17
    @TableField("trade_no")
18
    private String tradeNo;
19

20
    @TableField("total_amount")
21
    private BigDecimal totalAmount;
22

23
    @TableField("payment_status")
24
    private String paymentStatus;
25

26
    @TableField("callback_time")
27
    private Date callbackTime;
28

29
    @TableField("callback_content")
30
    private String callbackContent;
31
}

字段可以分成三组：

1. 回调前已知：outTradeNo、orderId、userId、paymentType、totalAmount；
2. 回调后补充：tradeNo、callbackTime、callbackContent；
3. 状态字段：paymentStatus 从 UNPAID 推进到 PAID。

outTradeNo 是本地订单对外交易号，tradeNo 是支付宝侧流水号，二者不能混用。

5.2 支付状态#

代码路径：duolaimall-pay/pay-service/src/main/java/com/cskaoyan/mall/payment/constant/PaymentStatus.java

1
public enum PaymentStatus {
2
    UNPAID("支付中"),
3
    PAID("已支付"),
4
    PAY_FAIL("支付失败"),
5
    CLOSED("已关闭");
6
}

当前主回调链实际使用 UNPAID 和 PAID。PayServiceImpl#updatePaymentStatus 仍是空方法，因此不能说本地支付流水已经完整覆盖关闭和失败状态流转。

5.3 数据状态流#

图中只画当前主链实际发生的流转；CLOSED 和 PAY_FAIL 是设计状态，不代表当前代码已经完成对应闭环。

6.1 Controller 保持轻量#

代码路径：duolaimall-pay/pay-service/src/main/java/com/cskaoyan/mall/payment/controller/PayController.java
关键方法：getOrderInfo、submitOrder

1
@GetMapping("/pay/auth")
2
public Result getOrderInfo(@RequestParam("orderId") Long orderId) {
3
    OrderInfoDTO orderInfoDTO = orderApiClient.getOrderInfoDTO(orderId);
4
    return Result.ok(orderInfoDTO);
5
}
6

7
@GetMapping("/pay/alipay/submit/{orderId}")
8
public String submitOrder(@PathVariable Long orderId) {
9
    String payType = "Alipay";
10
    return payService.createPay(orderId, payType);
11
}

Controller 只完成三件事：

• 绑定订单 ID；
• 查询展示信息或委托 Service 创建支付；
• 把订单 DTO 或页面 HTML 返回给调用方。

当前支付渠道在 Controller 中固定为 Alipay。虽然 Service 已通过工厂抽象 PayHelper，但接口还没有让客户端或订单选择其他渠道。

6.2 Feign 查询订单#

代码路径：duolaimall-pay/pay-service/src/main/java/com/cskaoyan/mall/payment/client/OrderApiClient.java

1
@FeignClient(value = "service-order")
2
public interface OrderApiClient {
3

4
    @GetMapping("/api/order/inner/getOrderInfo/{orderId}")
5
    OrderInfoDTO getOrderInfoDTO(@PathVariable("orderId") Long orderId);
6

7
    @PostMapping("/api/order/inner/success/{orderId}")
8
    Result successPay(@PathVariable("orderId") Long orderId);
9
}

支付服务不直接读订单数据库，而是通过订单服务的内部 API 获取订单事实。这样保持了服务边界，但也意味着创建支付页面依赖订单服务实时可用。