由于微信支付接口更新,本文档已过期,请查看新版微信支付教程。地址 http://www.cnblogs.com/txw1958/category/624506.html
本文介绍微信支付中订单查询功能的实现。
作者:方倍工作室
地址:http://www.cnblogs.com/txw1958/p/wxpay-order-query.html
一、订单查询
因为某一方技术的原因,可能导致商户在预期时间内都收不到最终支付通知,此时商户可以通过该API来查询订单的详细支付状态。
订单查询API的URL为:
https://api.weixin.qq.com/pay/orderquery?access_token=xxxxxx
URL中的参数只包含目前微信公众平台凭证access_token,而订单查询的真正数据是放在PostData中的,格式如下:
{
"appid" : "wwwwb4f85f3a797777",
"package" : "out_trade_no=11122&partner=1900090055&sign=4e8d0df3da0c3d0df38f",
"timestamp" : "1369745073",
"app_signature" : "53cca9d47b883bd4a5c85a9300df3da0cb48565c",
"sign_method" : "sha1"
}
上述内容参数说明如表所示。
参数 |
说明 |
appid |
公众平台账户的AppId; |
package |
查询订单的关键信息数据,包含第三方唯一订单号out_trade_no、财付通商户身仹标识partner(即前文所述的partnerid)、签名sign,其中sign是对参数字典序排序并使用&联合起来,最后加上&key=partnerkey(唯一分配),进行md5运算,再转成全大写,最终得到sign |
timestamp |
linux时间戳; |
app_signature |
根据支付签名(paySign)生成方法中所讲的签名方式生成的,参加签名字段为:appid、appkey、package、timestamp; |
sign_method |
签名方法(不计入签名生成); |
二、实现细节
1. 获得access token
这个很容易,参考微信公众平台开发(26) ACCESS TOKEN
代码如下:
1 $appid = "wx0000000000000000"; 2 $appsecret = "e76050733c695748537fc4d4c21d0e2c"; 3 $url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=$appid&secret=$appsecret"; 4 $result = https_request($url); 5 $jsoninfo = json_decode($result, true); 6 $access_token = $jsoninfo["access_token"];
2. 参数生成
appid: 直接赋值
timestamp:程序直接获取
$timestamp = time();
sign_method:这里为sha1
难点1:package 值的获得
先要获得sign
sign是out_trade_no,partner,key(partnerkey)三项信息的字典序排序,再MD5运算,再转为大写
$sign= strtoupper(md5("out_trade_no=JfuKdiBig4zZnE4n&partner=1234567890&key=ebf5cf381de2d716d432bfda34fa9e57"));
package 是查询订单的关键信息数据,包含第三方唯一订单号 out_trade_no、财付通商户身仹标识 partner(即前文所述的 partnerid) 、签名 sign
$package = "out_trade_no=JfuKdiBig4zZnE4n&partner=1234567890&sign=".$sign;
难点2:获得app_signature
app_signature 依然是根据支付签名(paySign)生成方法中所讲的签名方式生成的,参加签名字段为:appid、appkey、package、timestamp;
$obj[\'appid\'] = "wx0000000000000000";
$obj[\'appkey\'] = "8mruTNOGeX8OVUlIYxIyw6kxCRvdJENpWpw8mruTNOGeX8OVUlIYxIyw6kxCRvdJENpWpw8mruTNOGeX8OVUlIYxIyw6kxCRvdJENpWpw8mruTNOGeX8OVUlIYxIyw6k";
$obj[\'package\'] = $package;
$obj[\'timestamp\'] = $timestamp;
$WxPayHelper->get_biz_sign($obj);
这样各项参数都获得了
3.提交查询
$jsonmenu = \'
{
"appid" : "wx0000000000000000",
"package" : "\'.$package.\'",
"timestamp" : "\'.$timestamp.\'",
"app_signature" : "\'.$app_signature.\'",
"sign_method" : "sha1"
}
\';
$url = "https://api.weixin.qq.com/pay/orderquery?access_token=".$access_token;
$result = https_request($url, $jsonmenu);
var_dump($result);
完整代码如下所示:
1 include_once("WxPayHelper.php"); 2 3 //1. 获取access token 4 $appid = "wx0000000000000000"; 5 $appsecret = "e76050733ce76050733ce76050733cdd"; 6 $url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=$appid&secret=$appsecret"; 7 $result = https_request($url); 8 $jsoninfo = json_decode($result, true); 9 $access_token = $jsoninfo["access_token"]; 10 11 12 //2.准备参数 13 $timestamp = time(); 14 $sign= strtoupper(md5("out_trade_no=JfuKdiBig4zZnE4n&partner=1234567890&key=asdfasdfasdfasdfasdfasdfasdfasdf")); 15 $package = "out_trade_no=JfuKdiBig4zZnE4n&partner=1234567890&sign=".$sign; 16 17 //2.1构造最麻烦的app_signature 18 $obj[\'appid\'] = "wx0000000000000000"; 19 $obj[\'appkey\'] = "8mruTNOGeX8OVUlIYxIyw6kxCRvdJENpWpw8mruTNOGeX8OVUlIYxIyw6kxCRvdJENpWpw8mruTNOGeX8OVUlIYxIyw6kxCRvdJENpWpw8mruTNOGeX8OVUlIYxIyw6k"; 20 $obj[\'package\'] = $package; 21 $obj[\'timestamp\'] = $timestamp; 22 $WxPayHelper = new WxPayHelper(); 23 //get_biz_sign函数受保护,需要先取消一下,否则会报错 24 $app_signature = $WxPayHelper->get_biz_sign($obj); 25 26 //3. 将构造的json提交给微信服务器,查询 27 $jsonmenu = \' 28 { 29 "appid" : "wx0000000000000000", 30 "package" : "\'.$package.\'", 31 "timestamp" : "\'.$timestamp.\'", 32 "app_signature" : "\'.$app_signature.\'", 33 "sign_method" : "sha1" 34 } 35 \'; 36 37 $url = "https://api.weixin.qq.com/pay/orderquery?access_token=".$access_token; 38 $result = https_request($url, $jsonmenu); 39 var_dump($result); 40 41 function https_request($url, $data = null){ 42 $curl = curl_init(); 43 curl_setopt($curl, CURLOPT_URL, $url); 44 curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE); 45 curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, FALSE); 46 if (!empty($data)){ 47 curl_setopt($curl, CURLOPT_POST, 1); 48 curl_setopt($curl, CURLOPT_POSTFIELDS, $data); 49 } 50 curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); 51 $output = curl_exec($curl); 52 curl_close($curl); 53 return $output; 54 }
三、订单结果
上述程序执行后,获得订单结果如下
{
"errcode": 0,
"errmsg": "ok",
"order_info": {
"ret_code": 0,
"ret_msg": "",
"input_charset": "GBK",
"trade_state": "0",
"trade_mode": "1",
"partner": "1234567890",
"bank_type": "CMB_FP",
"bank_billno": "201405273540085997",
"total_fee": "1",
"fee_type": "1",
"transaction_id": "1218614901201405273313473135",
"out_trade_no": "JfuKdiBig4zZnE4n",
"is_split": "false",
"is_refund": "false",
"attach": "",
"time_end": "20140527194139",
"transport_fee": "0",
"product_fee": "1",
"discount": "0",
"rmb_total_fee": ""
}
}
各个字段的含义如表所示。
参数 |
说明 |
ret_code |
查询结果状态码,0表明成功,其他表明错误; |
ret_msg |
查询结果出错信息; |
input_charset |
返回信息中的编码方式; |
trade_state |
订单状态,0为成功,其他为失败; |
trade_mode |
交易模式,1为即时到帐,其他保留; |
partner |
财付通商户号,即前文的partnerid; |
bank_type |
银行类型; |
bank_billno |
银行订单号; |
total_fee |
总金额,单位为分; |
fee_type |
币种,1为人民币; |
transaction_id |
财付通订单号; |
out_trade_no |
第三方订单号; |
is_split |
是否分账,false为无分账,true为有分账; |
is_refund |
是否退款,false为无退款,ture为退款; |
attach |
商户数据包,即生成订单package时商户填入的attach; |
time_end |
支付完成时间; |
transport_fee |
物流费用,单位为分; |
product_fee |
物品费用,单位为分; |
discount |
折扣价格,单位为分; |
rmb_total_fee |
换算成人民币之后的总金额,单位为分,一般看total_fee即可。 |
如果程序有误,会在errcode和errmsg描述出来。
====================================================================
方倍工作室微信公众平台账号关注方法:
1. 微信通讯录-添加朋友-查找公众号-搜索“方倍工作室”
2. 微信通讯录-添加朋友-搜号码-输入“pondbaystudio”
3. 使用微信扫描下面的二维码