支付金额被前端改成 0.01 元:我用服务端价格快照、订单签名和回调校验堵住改价下单
一次异常低价订单让我意识到:前端提交的金额绝对不能直接信任。本文记录如何用服务端计价、价格快照、订单签名和回调金额校验把支付闭环补上。

作者
ZHOUYI
上周运营在后台发现一笔年费会员订单只付了 0.01 元。刚开始我以为是优惠券配置错了,查了 Nuxt 服务端日志才发现,下单接口里的 amount 是前端直接提交的,用户在小程序里用代理把金额改成了 1 分钱。这不是支付渠道的问题,而是我们把“应付金额”的信任交给了客户端。那一瞬间很后怕:如果继续按前端传入的金额发起扣款,这类改价下单会直接打穿价格体系。
把价格计算权收回服务端
第一刀是把价格计算权收回服务端。下单接口不再接收最终金额,只接收 skuId、数量、优惠券码和来源。服务端根据商品、活动、用户权益重新算价,并把金额统一存成“分”,避免浮点误差。创建订单时,我还会用 Redis 做用户级锁,防止重复提交和优惠券并发核销。前端展示的价格只作为参考,真正应付金额以服务端订单为准。
用价格快照和订单签名锁住下单
- 创建订单时,把商品、优惠、金额、币种、用户和过期时间写入 MongoDB 的价格快照。
- 用服务端密钥对订单号、金额分、币种和过期时间生成签名,前端只拿签名去发起支付。
- 支付前二次校验订单状态、金额和签名,防止旧订单被重复提交或支付参数被替换。
const crypto = require('node:crypto');
function signOrder(payload, secret) {
const text = [payload.orderId, payload.amount, payload.currency, payload.expireAt].join('|');
return crypto.createHmac('sha256', secret).update(text).digest('hex');
}
async function createOrder(input, user) {
const price = await calcServerPrice(input, user);
const order = await Orders.create({ userId: user.id, ...price, status: 'pending' });
order.paySign = signOrder(order, process.env.PAY_SIGN_SECRET);
return order;
}回调金额和查单结果必须闭环
支付回调不能只看到 success 就发货。我们会先验签,再核对商户单号、订单状态、金额和币种;只要回调金额和订单快照不一致,就写入异常表并暂停发货,不要自动退款或发货,先留证据。因为小程序支付回调可能延迟或丢失,所以还会用服务端查单接口做退避轮询和延迟对账,最终以渠道返回的支付状态决定是否发货。这样即使有人改了前端金额,也无法拿到有效订单。具体签名和回调字段以支付渠道官方文档为准。
“这次修复给我的提醒很直接:前端能改的字段都不能当事实。服务端计价、价格快照、订单签名、回调金额校验,四件事缺一不可。支付系统不怕复杂,怕的是把信任交给不该信任的地方。”