支付回调:整套系统里最不能出错的一段
支付相关的代码占整个系统比例很小,但它承载了百分之百的资金正确性。重复回调、并发查询、迟到通知——这些不是理论问题,是一定会发生的。
订单结算、额度增加、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、鉴权方式和各协议的可选范围都列清楚了。
- 点赞
- 收藏
- 关注作者
评论(0)