本文介紹微信支付中出貨通知功能的實作。
為了更好追蹤訂單的情況,需要第三方在收到最終支付通知之後,呼叫出貨通知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。
二、程式實作
程式中的某些參數來自本部落格前面的微信支付開發資料。讀者請參考運行
<?php include_once("WxPayHelper.php"); //1. 获取access token $appid = "wx0000000000000000"; $appsecret = "e76050733ce76050733ce76050733cdd"; $url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=$appid&secret=$appsecret"; $result = https_request($url); $jsoninfo = json_decode($result, true); $access_token = $jsoninfo["access_token"]; //2.准备参数 $deliver_timestamp = time(); //2.1构造最麻烦的app_signature $obj['appid'] = $appid; $obj['appkey'] = "8mruTNOGeX8OVUlIYxIyw6kxCRvdJENpWpw8mruTNOGeX8OVUlIYxIyw6kxCRvdJENpWpw8mruTNOGeX8OVUlIYxIyw6kxCRvdJENpWpw8mruTNOGeX8OVUlIYxIyw6k"; $obj['openid'] = "o0pk9uIVnlY-fJkzFKEbQ6LJ4cFc"; $obj['transid'] = "1218614901201405273313473135"; $obj['out_trade_no'] = "JfuKdiBig4zZnE4n"; $obj['deliver_timestamp'] = $deliver_timestamp; $obj['deliver_status'] = "1"; $obj['deliver_msg'] = "ok"; $WxPayHelper = new WxPayHelper(); //get_biz_sign函数受保护,需要先取消一下,否则会报错 $app_signature = $WxPayHelper->get_biz_sign($obj); //3. 将构造的json提交给微信服务器,查询 $jsonmenu = ' { "appid" : "'.$obj['appid'].'", "openid" : "'.$obj['openid'].'", "transid" : "'.$obj['transid'].'", "out_trade_no" : "'.$obj['out_trade_no'].'", "deliver_timestamp" : "'.$deliver_timestamp.'", "deliver_status" : "'.$obj['deliver_status'].'", "deliver_msg" : "'.$obj['deliver_msg'].'", "app_signature" : "'.$app_signature.'", "sign_method" : "sha1" }'; $url = "https://api.weixin.qq.com/pay/delivernotify?access_token=".$access_token; $result = https_request($url, $jsonmenu); var_dump($result); function https_request($url, $data = null){ $curl = curl_init(); curl_setopt($curl, CURLOPT_URL, $url); curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE); curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, FALSE); if (!empty($data)){ curl_setopt($curl, CURLOPT_POST, 1); curl_setopt($curl, CURLOPT_POSTFIELDS, $data); } curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); $output = curl_exec($curl); curl_close($curl); return $output; }
string(27) "{"errcode":0,"errmsg":"ok"}"