本文介绍微信支付中发货通知功能的实现。
一、发货通知
为了更好地跟踪订单的情况,需要第三方在收到最终支付通知之后,调用发货通知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. 使用微信扫描下面的二维码