php怎么调用拼多多开放平台物流_php如何订阅物流轨迹实时回调

轻枫小哥_8471

轻枫小哥_8471

2026-03-23

401人浏览

原创

拼多多物流轨迹回调需配置HTTPS服务器端接收POST请求,解析raw JSON、用callback_secret按字典序拼接字段并HMAC-SHA256验签,成功返回200状态码及{"code":0,"msg":"success"},且须幂等处理多节点增量更新。

php怎么调用拼多多开放平台物流_php如何订阅物流轨迹实时回调

拼多多物流轨迹回调怎么配置服务器端接收

拼多多开放平台的物流轨迹实时回调,本质是它往你指定的 URL 发 POST 请求,带 JSON 数据。你得有个能处理 POST、解析 JSON、验签、返回正确响应的 PHP 脚本,否则拼多多会认为失败并重试(最多 3 次)。

常见错误现象:HTTP 405 Method Not Allowed(没开 POST)、Empty response(脚本没 echo 任何东西)、Signature verification failed(验签逻辑错或密钥不对)。

  • 确保 Web 服务器(如 Nginx/Apache)允许 POST 到该路径,且不被 .htaccess 或 rewrite 规则拦截
  • 入口脚本必须以 echo '{"code":0,"msg":"success"}' 结尾,且 HTTP 状态码为 200 —— 多余空格、BOM 头、var_dump 都会导致失败
  • 拼多多用的是 HMAC-SHA256 签名,密钥是你在「开发者后台 → 应用管理 → 物流订阅」里配的 callback_secret,不是 client_secret
  • 原始请求体是 raw JSON,不能直接用 $_POST 读;要用 file_get_contents('php://input') 获取再 json_decode

PHP 怎么验签拼多多物流回调的 sign 字段

拼多多把除 sign 外所有字段按字典序拼成 key=value& 字符串,再用 callback_secret 做 HMAC-SHA256,最后转成小写 hex。漏字段、顺序错、编码不一致(比如中文没 urlencode)、secret 拿错,都会导致验签失败。

关键点:

  • 只排除 sign 字段,其他字段(包括 timestamp、data、app_key)全都要参与拼接
  • data 是 JSON 字符串,要原样拼,不要 json_decode 再拼 —— 否则空格、换行、键序变化都会影响签名
  • 拼接后字符串末尾**不能有 &**,例如 app_key=xxx&data={...}&timestamp=123,结尾无 &
  • 验签代码示例片段:
    $raw = file_get_contents('php://input');<br>$body = json_decode($raw, true);<br>$sign = $body['sign'] ?? '';<br>unset($body['sign']);<br>$toSign = http_build_query($body, '', '&', PHP_QUERY_RFC3986);<br>$expected = strtolower(hash_hmac('sha256', $toSign, $callback_secret));

收到回调后怎么安全更新本地订单物流状态

拼多多回调不是“一次到位”,而是每有新节点(揽件/中转/派件/签收)就推一次。你不能简单覆盖,得根据 data.status 和 data.time 做增量合并,否则可能丢掉中间状态或时间倒置。

btpanel phpsite 宝塔面板PHP网站
btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理:站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

典型场景:同一运单号多次回调,但 data.time 可能乱序(系统延迟),data.status 可能重复(重推)。

  • 先查数据库里该 waybill_no 最新记录的 update_time,只插入 time 更大的新节点
  • status 值需映射为本地状态码(如 "SIGN_IN" → 5),别硬写字符串进 status 字段
  • 回调里的 data.content 是纯文本描述,含 HTML 标签(如
    ),入库前建议用 strip_tags() 或白名单过滤
  • 务必加数据库事务或行锁,防止并发回调写入冲突 —— 尤其是多个网点同时扫描一个单号时

为什么本地测试总收不到拼多多回调

拼多多只支持 HTTPS 回调地址,且证书必须由可信 CA 签发(不接受自签、localhost、IP 地址、或过期证书)。这是最常被忽略的硬性门槛。

调试时容易踩的坑:

  • 用 ngrok 或 localtunnel 测试时,确认域名在拼多多后台「物流订阅」里填的是 https://xxx.ngrok.io/callback.php,而不是 http:// 或 127.0.0.1
  • 拼多多会校验证书链完整性,部分免费证书(如 Let’s Encrypt 的某些中间 CA)若 Nginx 没配 fullchain.pem,会握手失败
  • 回调日志在拼多多后台「开发者工具 → 回调日志」里查,不是你自己 access.log —— 它记录的是它发出请求的结果,不是你服务器是否运行
  • 别依赖 error_log() 查问题:回调超时默认 3 秒,PHP 脚本超过这个时间没返回,拼多多就断连,你的 log 可能根本没写进去

拼多多回调的难点不在签名算法本身,而在于它对网络稳定性、HTTPS 证书、响应时效、幂等处理这四点卡得极死。少一个环节,就收不到数据,而且错误提示极其笼统。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

拼多多
拼多多

拼多多是一款专注拼团的社交购物软件,是真正意义上的团购。用户通过发起和朋友,家人,邻居等的拼团,以更低的价格,拼团购买优质商品。有需要的小伙伴快来保存下载体验吧!

下载

相关标签:

php

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

12964

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

7421

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2275

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

4688

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

5414

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

4251

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

6177

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

4862

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

12582

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习