查询订单

更新时间：2024.11.04

商户通过商户订单号，来查询订单信息

接口说明

支持商户：【普通服务商】

请求方式：【GET】/v3/vehicle/transactions/out-trade-no/{out_trade_no}

请求域名：【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引点击查看

请求参数

Header HTTP头参数

Authorization 　必填　string

请参考签名认证生成认证信息

Accept 　必填　string

请设置为application/json

path 路径参数

out_trade_no 　必填 string(32)

【商户订单号】商户系统内部订单号，只能是数字、大小写字母，且在同一个商户号下唯一

query 查询参数

sub_mchid 　必填 string(32)

【子商户号】微信支付分配的子商户号，服务商模式下必传

请求示例

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/vehicle/transactions/out-trade-no/20150806125346?sub_mchid=1900000109 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数

200 OK

appid 　必填 string(32)

【公众账号id】appid是商户在微信申请公众号或移动应用成功后分配的帐号ID，登录平台为mp.weixin.qq.com或open.weixin.qq.com

sub_appid 　选填 string(32)

【子商户公众账号id】子商户申请的公众号或移动应用appid，需要在服务商的商户平台为子商户绑定

sp_mchid 　必填 string(32)

【商户号】微信支付分配的商户号

sub_mchid 　必填 string(32)

【子商户号】微信支付分配的子商户号

description 　必填 string(128)

【服务描述】商户自定义字段，用于交易账单中对扣费服务的描述。

create_time 　必填 string(32)

【订单创建时间】订单成功创建时返回，遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日 13点29分35秒。

out_trade_no 　必填 string(32)

【商户订单号】商户系统内部订单号，只能是数字、大小写字母_-*且在同一个商户号下唯一

transaction_id 　选填 string(32)

【微信支付订单号】微信支付订单号

trade_state 　必填 string(32)

【交易状态】SUCCESS—支付成功
ACCEPTED—已接收，等待扣款
PAY_FAIL–支付失败(其他原因，如银行返回失败)
REFUND—转入退款

trade_state_description 　选填 string(256)

【交易状态描述】对当前订单状态的描述和下一步操作的指引

success_time 　选填 string(32)

【支付完成时间】订单支付完成时间，遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日 13点29分35秒。

bank_type 　选填 string(16)

【付款银行】银行类型，采用字符串类型的银行标识。BPA：该笔订单由微信进行垫付

user_repaid 　选填 string(1)

【用户是否已还款】枚举值：
Y：用户已还款
N：用户未还款
注意：使用此字段前需先确认bank_type字段值为BPA以及 trade_state字段值为SUCCESS。

attach 　选填 string(128)

【附加数据】附加数据，在查询API和支付通知中原样返回，可作为自定义参数使用

trade_scene 　必填 string(32)

【交易场景】交易场景值，目前支持：PARKING：车场停车场景

parking_info 　选填 object

【停车场景信息】返回信息中的trade_scene为PARKING，返回该场景信息

属性

parking_id 　必填 string(32)

【入场id】微信支付分停车服务为商户分配的入场id，商户通过入场通知接口获取入场id

plate_number 　必填 string(32)

【车牌号】车牌号，仅包括省份+车牌，不包括特殊字符。

plate_color 　必填 string

【车牌颜色】车牌颜色

可选取值：

BLUE: 蓝色

GREEN: 绿色

YELLOW: 黄色

BLACK: 黑色

WHITE: 白色

LIMEGREEN: 黄绿色

start_time 　必填 string(32)

【入场时间】用户入场时间，遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日 13点29分35秒。

end_time 　必填 string(32)

【出场时间】用户出场时间，遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日 13点29分35秒。

parking_name 　必填 string(32)

【停车场名称】所在停车位车场的名称

charging_duration 　必填 integer

【计费时长】计费的时间长，单位为秒

device_id 　必填 string(32)

【停车场设备id】停车场设备id

payer 　必填 object

【支付者信息】支付者信息

属性

amount 　必填 object

【订单金额信息】订单金额信息

属性

promotion_detail 　选填 array[object]

【优惠信息】优惠信息

属性

应答示例

200 OK

1{
2  "appid" : "wxcbda96de0b165486",
3  "sub_appid" : "wxcbda96de0b165489",
4  "sp_mchid" : "1230000109",
5  "sub_mchid" : "1900000109",
6  "description" : "停车场扣费",
7  "create_time" : "2017-08-26T10:43:39+08:00",
8  "out_trade_no" : "20150806125346",
9  "transaction_id" : "1009660380201506130728806387",
10  "trade_state" : "SUCCESS",
11  "trade_state_description" : "支付失败，请重新下单支付",
12  "success_time" : "2017-08-26T10:43:39+08:00",
13  "bank_type" : "CMC",
14  "user_repaid" : "Y",
15  "attach" : "深圳分店",
16  "trade_scene" : "PARKING",
17  "parking_info" : {
18    "parking_id" : "5K8264ILTKCH16CQ250",
19    "plate_number" : "粤B888888",
20    "plate_color" : "BLUE",
21    "start_time" : "2017-08-26T10:43:39+08:00",
22    "end_time" : "2017-08-26T10:43:39+08:00",
23    "parking_name" : "欢乐海岸停车场",
24    "charging_duration" : 3600,
25    "device_id" : "12313"
26  },
27  "payer" : {
28    "openid" : "oUpF8uMuAJOM2pxb1Q",
29    "sub_openid" : "oUpF8uMuAJOM2pxb1Q"
30  },
31  "amount" : {
32    "total" : 888,
33    "currency" : "CNY",
34    "payer_total" : 100,
35    "discount_total" : 100
36  },
37  "promotion_detail" : [
38    {
39      "coupon_id" : "109519",
40      "name" : "单品惠-6",
41      "scope" : "SINGLE",
42      "type" : "CASH",
43      "stock_id" : "931386",
44      "amount" : 5,
45      "wechatpay_contribute" : 1,
46      "merchant_contribute" : 1,
47      "other_contribute" : 1,
48      "currency" : "CNY"
49    }
50  ]
51}
52

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅接口规则
401	SIGN_ERROR	验证不通过	请参阅签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	不支持查询非支付分停车订单，请更换单号后再试	商户查询的订单非支付分停车订单，该接口只支持查询通过支付分停车受理扣款接口下单的订单信息，请更换单号后再试
400	INVALID_REQUEST	服务商和子商户没有绑定关系	检查请求中的sub_mchid与服务商商户号是否匹配，然后重试
400	PARAM_ERROR	参数错误，请检查out_trade_no	参数错误，请检查out_trade_no为创建订单时的商户订单号
404	NOT_FOUND	订单不存在	请确认out_trade_no正确且为当前商户的订单
429	RATELIMIT_EXCEEDED	达到调用速率限制	接口调用频率过快，请降低请求频率
500	SYSTEM_ERROR	出现内部服务器错误	5开头的错误码均为系统错误，请使用相同的参数稍后重试

文档是否有帮助

更多支持

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服