因为某一方技术的原因，可能导致商户在预期时间内都收不到最终支付通知，此时商户可以通过该API来查询订单的详细支付状态。
订单查询API的URL为：
|
1
|
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
2
3
4
5
6
|
$appid = "wx0000000000000000";$appsecret = "e76050733c695748537fc4d4c21d0e2c";$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. 参数生成
appid: 直接赋值
timestamp：程序直接获取
|
1
|
$timestamp = time(); |
sign_method：这里为sha1
难点1：package 值的获得
先要获得sign
sign是out_trade_no，partner，key(partnerkey)三项信息的字典序排序，再MD5运算，再转为大写
|
1
|
$sign= strtoupper(md5("out_trade_no=JfuKdiBig4zZnE4n&partner=1234567890&key=ebf5cf381de2d716d432bfda34fa9e57")); |
package 是查询订单的关键信息数据，包含第三方唯一订单号 out_trade_no、财付通商户身仹标识 partner（即前文所述的 partnerid） 、签名 sign
|
1
|
$package = "out_trade_no=JfuKdiBig4zZnE4n&partner=1234567890&sign=".$sign; |
难点2：获得app_signature
app_signature 依然是根据支付签名（paySign）生成方法中所讲的签名方式生成的，参加签名字段为：appid、appkey、package、timestamp；
|
1
2
3
4
5
|
$obj['appid'] = "wx0000000000000000";$obj['appkey'] = "8mruTNOGeX8OVUlIYxIyw6kxCRvdJENpWpw8mruTNOGeX8OVUlIYxIyw6kxCRvdJENpWpw8mruTNOGeX8OVUlIYxIyw6kxCRvdJENpWpw8mruTNOGeX8OVUlIYxIyw6k";$obj['package'] = $package;$obj['timestamp'] = $timestamp;$WxPayHelper->get_biz_sign($obj); |
这样各项参数都获得了
3.提交查询
|
1
2
3
4
5
6
7
8
9
10
11
12
13
|
$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
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
|
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.准备参数$timestamp = time();$sign= strtoupper(md5("out_trade_no=JfuKdiBig4zZnE4n&partner=1234567890&key=asdfasdfasdfasdfasdfasdfasdfasdf"));$package = "out_trade_no=JfuKdiBig4zZnE4n&partner=1234567890&sign=".$sign;//2.1构造最麻烦的app_signature$obj['appid'] = "wx0000000000000000";$obj['appkey'] = "8mruTNOGeX8OVUlIYxIyw6kxCRvdJENpWpw8mruTNOGeX8OVUlIYxIyw6kxCRvdJENpWpw8mruTNOGeX8OVUlIYxIyw6kxCRvdJENpWpw8mruTNOGeX8OVUlIYxIyw6k";$obj['package'] = $package;$obj['timestamp'] = $timestamp;$WxPayHelper = new WxPayHelper();//get_biz_sign函数受保护，需要先取消一下，否则会报错$app_signature = $WxPayHelper->get_biz_sign($obj);//3. 将构造的json提交给微信服务器，查询$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);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;} |
三、订单结果
上述程序执行后，获得订单结果如下
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
|
{ "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描述出来。
以上就是对微信支付开发中查询功能的资料整理，希望能帮到微信开发支付的朋友。
