稳付支付

首页 / 产品说明 / 订单回调指南

订单回调与防止重复发货

支付页面的跳转结果可能被中断,可靠的支付确认应由服务端回调和订单查询共同保障。

什么是异步回调

支付结果发生变化后,系统会向商户预先配置的地址发送通知。该通知用于同步订单状态,但不能被直接信任:任何面向公网的接口都要验证请求来源和数据完整性。

验签与字段校验

使用服务端保存的密钥校验签名;同时核对商户订单号、实付金额、支付状态和商户标识。签名正确不代表业务一定可以交付:订单必须存在,且处于允许完成的状态。

为什么同一笔只能处理一次

超时重试会让同一笔通知抵达多次。如果每次回调都发货、增加余额或记录收入,业务数据会被放大。正确做法是以唯一订单号和最终状态为条件更新;已经处理成功的订单直接返回约定响应,并记录通知内容与时间。

异常订单如何排查

保留订单创建参数、回调原文、验签结果、状态迁移和响应码。客服或技术人员应能通过订单号看到完整链路。对金额不一致、签名失败、未知订单等情况,不要自动完成业务,应进入人工复核队列。

安全提示:密钥仅可在服务端使用;日志应避免输出完整密钥、用户敏感信息或可被重放的签名材料。

阅读支付方式选择指南