支付回调:整套系统里最不能出错的一段

举报
Rolle 发表于 2026/11/15 18:10:16 2026/11/15
【摘要】 支付相关的代码占整个系统比例很小,但它承载了百分之百的资金正确性。重复回调、并发查询、迟到通知——这些不是理论问题,是一定会发生的。

支付相关的代码占整个系统比例很小,但它承载了百分之百的资金正确性。重复回调、并发查询、迟到通知——这些不是理论问题,是一定会发生的。

订单结算、额度增加、Key 发放必须原子

这三件事要在同一个事务里完成,并保留行锁和幂等约束。分步执行必然会出现「钱到了但额度没到」或者「额度加了但订单还是待支付」。

一个常见的坑是:运营调整了套餐价格,结果已经创建但未支付的订单也跟着变了。

正确做法是下单那一刻把套餐内容(价格、每日额度、并发数、有效期)快照进订单。

四种异常场景必须有测试

重复回调、回调与主动查询并发、迟到通知、目标 Key 失效。这四种情况下都不能重复加额度或重复发卡,必要时还要打上 needs_review 标记。

兑换失败通常是「码不存在 / 已使用 / 过期」;游客购卡失败可能是「支付未确认 / 凭证过期 / 目标 Key 已停用」。

浏览器返回地址不能作为支付凭证

用户可以随便改地址栏。前端轮询到的状态也不能直接标记成功——只有验签通过、且应用、商户、订单、金额、交易状态全部核对无误的支付宝结果才算。

兑换码是预付凭证,游客卡是订单交付产物,两者的失败模式不一样。

交付响应不能缓存

支付完成后的交付响应要带 Cache-Control: no-store,浏览器订单记录也不保存明文 Key。

价格用整数分存储,额度用整数(并且检查溢出),不能用浮点数。

实操:支付回调的验签与幂等处理骨架。

支付完成后能立刻查到额度,才说明整条链路是通的。

import hashlib, hmac, json

def verify_notification(raw_body: bytes, headers: dict) -> bool:
    # 1) 验签:用平台公钥对原始报文做 RSA/SM2 验签,
    #    任何字段被改动都会导致验签失败
    # verify_signature(raw_body, headers["signature"], PLATFORM_PUBLIC_KEY)

    # 2) 核对业务字段:应用、商户、订单号、金额、交易状态
    data = json.loads(raw_body)
    if data["app_id"] != APP_ID or data["seller_id"] != SELLER_ID:
        return False
    if data["total_amount"] != str(expected_amount(data["out_trade_no"])):
        return False
    return data["trade_status"] in ("TRADE_SUCCESS", "TRADE_FINISHED")

def handle(data):
    # 3) 幂等:同一笔订单重复通知时直接返回成功,
    #    绝不能重复加额度或重复发卡
    order = load_order(data["out_trade_no"])
    if order.paid_at:
        return "SUCCESS"
    with transaction():
        settle_order(order)          # 结算 + 加额度 + 发卡,原子完成
        mark_paid(order, data)
    return "SUCCESS"

# 浏览器返回地址和前端轮询到的状态,都不能作为支付成功的依据。

几个容易踩的坑

  • 价格用浮点数存储,累加后账目对不上。
  • 套餐改了之后已创建的订单也跟着变,用户看到的和付的不一样。
  • 续费时没保留今日已用量,等于凭空多给了一份额度。
  • 奖励金被撤销但已经被抵扣,产生了资损。

小结

把可观测性做在前面,后面所有的优化才有依据。

对具体能力有疑问,可以直接看接入文档 https://aiminis.info/docs/api-integration,里面把 Base URL、鉴权方式和各协议的可选范围都列清楚了。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。