本文介绍微信支付中发货通知功能的实现。
一、发货通知
为了更好地跟踪订单的情况,需要第三方在收到最终支付通知之后,调用发货通知API告知微信后台该订单的发货状态。
发货时间限制:虚拟、服务类24小时内,实物类72小时内。
请在收到支付通知后,按时发货,并使用发货通知接口将相关信息同步到微信后台。若平台在规定时间内没有收到,将视作发货超时处理。
发货通知API的URL为:
https://api.weixin.qq.com/pay/delivernotify?access_token=xxxxxx
URL中的参数只包含目前微信公众平台凭证access_token,而发货通知的真正的数据是放在PostData中的,格式如下:
{
"appid" : "wwwwb4f85f3a797777",
"openid" : "oX99MDgNcgwnz3zFN3DNmo8uwa-w",
"transid" : "111112222233333",
"out_trade_no" : "555666uuu",
"deliver_timestamp" : "1369745073",
"deliver_status" : "1",
"deliver_msg" : "ok",
"app_signature" : "53cca9d47b883bd4a5c85a9300df3da0cb48565c",
"sign_method" : "sha1"
}
上述内容参数说明如表6-12所示。
参数 |
说明 |
appid |
公众平台账户的AppId; |
openid |
贩买用户的OpenId,这个已经放在最终支付结果通知的PostData里了; |
transid |
交易单号; |
out_trade_no |
第三方订单号; |
deliver_timestamp |
发货时间戳,这里指的是Linux时间戳; |
deliver_status |
发货状态,1表明成功,0表明失败,失败时需要在deliver_msg填上失败原因; |
deliver_msg |
发货状态信息,失败时可以填上UTF8编码的错诨提示信息,比如“该商品已退款”; |
app_signature |
根据支付签名(paySign)生成方法中所讲的签名方式生成的,参加签名字段为:appid、appkey、openid、transid、out_trade_no、deliver_timestamp、deliver_status、deliver_msg; |
sign_method |
签名方法(不计入签名生成); |
表6-12 发货通知参数说明
微信公众平台在校验ok之后,会返回数据表明是否通知成功,例如:{"errcode":0,"errmsg":"ok"}如果有异常,会在errcode和errmsg描述出来,如果成功errcode就为0。
二、程序实现
程序中的一些参数来自本博客前面的微信支付开发数据。读者请参照运行
1 <?php
2 //方倍工作室
3
4 include_once("WxPayHelper.php");
5
6 //1. 获取access token
7 $appid = "wx0000000000000000";
8 $appsecret = "e76050733ce76050733ce76050733cdd";
9 $url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=$appid&secret=$appsecret";
10 $result = https_request($url);
11 $jsoninfo = json_decode($result, true);
12 $access_token = $jsoninfo["access_token"];
13
14 //2.准备参数
15 $deliver_timestamp = time();
16 //2.1构造最麻烦的app_signature
17 $obj[‘appid‘] = $appid;
18 $obj[‘appkey‘] = "8mruTNOGeX8OVUlIYxIyw6kxCRvdJENpWpw8mruTNOGeX8OVUlIYxIyw6kxCRvdJENpWpw8mruTNOGeX8OVUlIYxIyw6kxCRvdJENpWpw8mruTNOGeX8OVUlIYxIyw6k";
19 $obj[‘openid‘] = "o0pk9uIVnlY-fJkzFKEbQ6LJ4cFc";
20 $obj[‘transid‘] = "1218614901201405273313473135";
21 $obj[‘out_trade_no‘] = "JfuKdiBig4zZnE4n";
22 $obj[‘deliver_timestamp‘] = $deliver_timestamp;
23 $obj[‘deliver_status‘] = "1";
24 $obj[‘deliver_msg‘] = "ok";
25
26 $WxPayHelper = new WxPayHelper();
27 //get_biz_sign函数受保护,需要先取消一下,否则会报错
28 $app_signature = $WxPayHelper->get_biz_sign($obj);
29
30 //3. 将构造的json提交给微信服务器,查询
31 $jsonmenu = ‘
32 {
33 "appid" : "‘.$obj[‘appid‘].‘",
34 "openid" : "‘.$obj[‘openid‘].‘",
35 "transid" : "‘.$obj[‘transid‘].‘",
36 "out_trade_no" : "‘.$obj[‘out_trade_no‘].‘",
37 "deliver_timestamp" : "‘.$deliver_timestamp.‘",
38 "deliver_status" : "‘.$obj[‘deliver_status‘].‘",
39 "deliver_msg" : "‘.$obj[‘deliver_msg‘].‘",
40 "app_signature" : "‘.$app_signature.‘",
41 "sign_method" : "sha1"
42 }‘;
43
44
45
46 $url = "https://api.weixin.qq.com/pay/delivernotify?access_token=".$access_token;
47 $result = https_request($url, $jsonmenu);
48 var_dump($result);
49
50 function https_request($url, $data = null){
51 $curl = curl_init();
52 curl_setopt($curl, CURLOPT_URL, $url);
53 curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
54 curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, FALSE);
55 if (!empty($data)){
56 curl_setopt($curl, CURLOPT_POST, 1);
57 curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
58 }
59 curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
60 $output = curl_exec($curl);
61 curl_close($curl);
62 return $output;
63 }
运行后返回结果
string(27) "{"errcode":0,"errmsg":"ok"}"
====================================================================
方倍工作室微信公众平台账号关注方法:
1. 微信通讯录-添加朋友-查找公众号-搜索“方倍工作室”
2.
微信通讯录-添加朋友-搜号码-输入“pondbaystudio”
3. 使用微信扫描下面的二维码