微信JSAPI支付回调PHP怎么接收_处理JSAPI异步通知数据方法【指南】
技术百科
雪夜
发布时间:2026-01-01
浏览: 次 微信JSAPI支付回调需用file_get_contents('php://input')读取原始XML,校验sign签名后更新订单状态,返回严格格式SUCCESS XML并确保HTTP 200响应。
微信JSAPI支付回调PHP怎么接收原始XML数据
PHP默认不会自动解析微信发来的XML格式通知,$_POST 是空的,file_get_contents('php://input') 才是唯一可靠入口。很多开发者卡在这一步,误以为要靠 $_GET 或表单提交方式接收。
- 微信服务器发起的是
POST请求,且Content-Type为application/xml,不是application/x-www-form-urlencoded -
$_POST只处理表单编码数据,对纯 XML 无响应,必须手动读取原始请求体 - 务必在脚本开头加
header('HTTP/1.1 200 OK'),否则微信会反复重试(最多5次)
怎么安全解析并验证JSAPI异步通知的XML
不能直接用 simplexml_load_string() 后就信任所有字段——微信通知可能被伪造,必须校验签名。签名字段 sign 是对除 sign 外所有字段按字典序拼接后,用商户密钥 key 做 MD5 计算得出。
- 先用
simplexml_load_string($rawData)解析,再转成关联数组(注意asXML()和属性处理) - 剔除
sign字段后,对剩余字段按键名升序排序,拼成key1=value1&key2=value2格式 - 末尾追加
&key=YOUR_MCH_KEY,再strtoupper(md5($string)) - 对比结果与原始
sign是否一致,不一致立即返回fail
function getSignFromXml($xmlString, $mchKey) {
$data = json_decode(json_encode(simplexml_load_string($xmlString, 'SimpleXMLElement', LIBXML_NOCDATA)), true);
if (!isset($data['sign'])) return false;
unset($data['sign']);
ksort($data);
$string = http_build_query($data, '', '&', PHP_QUERY_RFC3986);
$string
= str_replace(['+', '%20'], [' ', '+'], $string); // 修复 http_build_query 对空格的编码问题
$string .= '&key=' . $mchKey;
return strtoupper(md5($string));
}
收到通知后怎么更新订单状态并避免重复处理
微信可能因网络问题多次推送同一笔通知,PHP脚本必须具备幂等性。不能只靠数据库 UPDATE,得先查、再判、再改,且整个过程需加锁或依赖唯一业务字段约束。
- 从XML中提取
out_trade_no(你系统生成的订单号),这是唯一可信赖的业务标识 - 查询该订单当前状态:若已是
success,直接返回success;若为pending,才执行状态更新和后续逻辑(如发货、积分发放) - 更新时建议用
WHERE status = 'pending'条件,防止并发场景下重复执行成功逻辑 - 不要在通知处理中调用微信退款、查询等接口——超时风险高,应放入队列异步处理
// 示例:原子化更新订单状态
$sql = "UPDATE orders SET status = 'paid', paid_at = NOW() WHERE out_trade_no = ? AND status = 'pending'";
$stmt = $pdo->prepare($sql);
$stmt->execute([$outTradeNo]);
if ($stmt->rowCount() === 0) {
// 已处理过,直接返回 success
echo ' ';
exit;
}
为什么返回 success XML 还被微信不断重发
表面返回了正确XML,但实际HTTP状态码不是200,或者响应体里混入了空格、BOM头、调试输出,都会导致微信判定失败。这是最隐蔽也最常见的坑。
- 确保脚本开头没有
echo、var_dump、print_r,甚至error_log都可能干扰输出 - 检查PHP文件是否以UTF-8无BOM格式保存(BOM会导致响应头前多出
\xEF\xBB\xBF) - 用
curl -v https://yourdomain.com/notify.php检查响应头和响应体是否干净 - 微信要求返回的XML必须严格符合格式:
,不能多标签、不能少 CDATA
真正稳定的回调处理,核心不在解析多复杂,而在于每一步都做防御性判断,并把“不可信输入”和“不可控网络”当作默认前提。尤其注意 php://input 的一次性读取特性——读完就没了,别在中间 die() 或抛异常后还想再读一次。
# ai
# 微信
# 网络问题
# app
# js
# json
# curl
# String
# 编码
# xml
# 为什么
# php
# 状态码
# echo
# 表单提交
# die
# php脚本
# 退款
# 关联数组
相关栏目:
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
AI推广<?muma echo $count; ?>
】
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
SEO优化<?muma echo $count; ?>
】
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
技术百科<?muma echo $count; ?>
】
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
谷歌推广<?muma echo $count; ?>
】
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
百度推广<?muma echo $count; ?>
】
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
网络营销<?muma echo $count; ?>
】
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
案例网站<?muma echo $count; ?>
】
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
精选文章<?muma echo $count; ?>
】
相关推荐
- Win11怎么调整屏幕亮度_Windows 11调
- Python多线程使用规范_线程安全解析【教程】
- php怎么操作Redis_Redis扩展连接与基本
- php下载安装包怎么选_threadsafe与nt
- Mac电脑进水了怎么办_MacBook进水后紧急处
- Python文件和流处理指南_高效读写大体积数据文
- 如何使用Golang安装依赖库_管理模块和第三方包
- Windows10系统怎么查看设备管理器_Win1
- Win11怎么关闭系统透明度_Windows11个
- php下载安装后swoole扩展怎么安装_异步框架
- 如何使用Golang reflect检查方法数量_
- Win11视频默认播放器怎么改_Win11关联第三
- Win11怎么开启剪贴板历史记录_Windows1
- php查询数据怎么分组_groupby分组查询配合
- Windows怎样关闭开始菜单广告_Windows
- Win11怎么退出高对比度模式_Win11取消反色
- Windows执行文件被SmartScreen拦截
- php本地部署后session无法保存_sessi
- C#怎么使用委托和事件 C# delegate与e
- Win11怎么查看激活状态_查询Windows 1
- LINUX怎么进行文本内容搜索_Linux gre
- Win11怎么开启专注模式_Windows11时钟
- 如何在Golang中解压文件_Golang com
- MAC的“接续互通”功能无法使用怎么办_MAC检查
- Win10 BitLocker加密教程 Win10
- c++ try_emplace用法_c++ map
- Python抽象类与接口设计_规范说明【指导】
- VSC怎么快速定位PHP错误行_错误追踪设置法【方
- Win11相机打不开提示错误怎么修_相机权限开启与
- Win11怎么设置指纹解锁 Win11笔记本录入指
- 如何使用Golang搭建Web开发环境_快速启动H
- Python模块的__name__属性如何由导入方
- Win10如何更改任务栏高度_Windows10解
- 如何高效获取循环末次生成的 NumPy 数组最后一
- Win11怎么关闭搜索历史_Win11清除设备上的
- c++输入输出流 c++ cin与cout格式化输
- 如何使用Golang encoding/json解
- Win11怎么关闭通知中心_Windows11系统
- Win10如何更改网络连接_Windows10以太
- Python实现图数据库操作_Neo4j核心CRU
- Win11怎么更改任务栏位置_修改注册表将Win1
- Win10怎样卸载DockerDesktop_Wi
- Mac如何解压zip和rar文件?(推荐免费工具)
- Win10怎样设置闹钟贪睡时间 Win10闹钟贪睡
- Win10如何备份驱动程序_Win10驱动备份步骤
- c++如何判断文件是否存在_c++ filesys
- Win11如何设置开机问候语 Win11修改登录界
- Win11怎么更改盘符_Win11磁盘管理修改驱动
- 如何使用Golang template生成文本模板
- Win11怎么查看显卡温度 Win11任务管理器查

= str_replace(['+', '%20'], [' ', '+'], $string); // 修复 http_build_query 对空格的编码问题
$string .= '&key=' . $mchKey;
return strtoupper(md5($string));
}
QQ客服