查询订单

更新时间：2024.11.18

前置条件：商户已创建支付分服务订单

接口说明

支持商户：【从业机构（支付机构）】

请求方式：【GET】/v3/payscore/acquiringbank/serviceorder

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

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

请求参数

Header HTTP头参数

Authorization 　必填　string

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

Accept 　必填　string

请设置为application/json

query 查询参数

service_id 　选填 string(32)

【服务ID】该服务ID有本接口对应产品的权限

sub_mchid 　必填 string(32)

【子商户商户号】子商户商户号，由微信支付生成并下发

channel_id 　必填 string(32)

【渠道商商户号】渠道商商户号

out_order_no 　选填 string(32)

【商户服务订单号】商户系统内部服务订单号（不是交易单号），要求32个字符内，只能是数字、大小写字母_-|* 且在同一个商户号下唯一。

query_id 　选填 string(512)

【单据查询ID】确认订单流程，微信侧回跳到商户前端时，携带的用于单据查询的ID。商户订单号与单据查单ID必填其一

请求示例

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/payscore/acquiringbank/serviceorder?service_id=2002000000000558128851361561536&sub_mchid=1900000109&channel_id=1230000109&out_order_no=1234323JKHDFE1243252&query_id=15646546545165651651 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数

200 OK

out_order_no 　必填 string(32)

【商户服务订单号】调用接口传入的商户订单号

service_id 　必填 string(32)

【服务ID】调用接口传入的服务ID

appid 　必填 string(32)

【服务商公众号ID】调用接口传入的服务商公众号ID

mchid 　必填 string(32)

【服务商商户号】调用接口传入的服务商商户号

sub_appid 　选填 string(32)

【子商户公众号ID】调用接口传入的子商户公众号ID

sub_mchid 　选填 string(32)

【子商户商户号】调用接口传入的子商户商户号

service_introduction 　必填 string(20)

【服务信息】调用接口传入的服务信息

state 　必填 string(32)

【服务订单状态】当前单据状态.

CREATED: 服务订单已创建
DOING: 服务订单进行中
DONE: 服务订单已完成
REVOKED: 商户取消服务订单
EXPIRED: 服务订单已失效，"CREATED"状态超过1小时未变动，则订单失效

state_description 　选填 string(32)

【订单状态说明】对服务订单"DOING"状态的附加说明.

USER_CONFIRM: 用户确认
MCH_COMPLETE：商户完结

post_payments 　选填 array[object]

【后付费项目】调用接口传入的后付费项目

属性

post_discounts 　选填 array[object]

【商户优惠】调用接口传入的商户优惠

属性

risk_fund 　选填 object

【服务风险金】调用接口传入的服务风险金

属性

total_amount 　选填 integer

【总金额】调用接口传入的总金额

collection 　选填 object

【收款信息】收款成功后，展示具体的收款信息

属性

state 　必填 string(32)

【收款状态】USER_PAYING：待支付；USER_PAID：已支付

total_amount 　选填 integer

【总收款金额】总金额，大于等于0的数字，单位为分需满足：总金额=付费项目金额之和-商户优惠项目金额之和<=订单风险金额未使用服务，取消订单时，该字段必须填0.

paying_amount 　选填 integer

【待收金额】等待用户付款金额

paid_amount 　选填 integer

【已收金额】用户已付款的金额

details 　选填 array[object]

【收款明细列表】收款明细列表

属性

bank_type 　选填 string

【收款银行】银行类型，采用字符串类型的银行标识。

time_range 　选填 object

【服务时间】调用接口传入的服务时间

属性

location 　选填 object

【服务位置】调用接口传入的服务位置

属性

attach 　选填 string(256)

【附加数据】调用接口传入的附加数据

notify_url 　选填 string(256)

【商户回调地址】调用接口传入的商户回调地址

openid 　选填 string(128)

【服务商公众号下的用户标识】调用接口传入的服务商公众号下的用户标识

sub_openid 　选填 string(128)

【子商户公众号下的用户标识】调用接口传入的子商户公众号下的用户标识

order_id 　选填 string(64)

【微信支付服务订单号】微信支付服务订单号，每个微信支付服务订单号与商户号下对应的商户服务订单号一一对应

channel_id 　必填 string(32)

【渠道商商户号】渠道商商户号

应答示例

200 OK

1{
2  "out_order_no" : "1234323JKHDFE1243252",
3  "service_id" : "2002000000000558128851361561536",
4  "appid" : "wxd678efh567hg6787",
5  "mchid" : "1230000109",
6  "sub_appid" : "wxd678efh567hg6999",
7  "sub_mchid" : "1900000109",
8  "service_introduction" : "XX充电宝",
9  "state" : "CREATED",
10  "state_description" : "MCH_COMPLETE",
11  "post_payments" : [
12    {
13      "name" : "就餐费用",
14      "amount" : 40000,
15      "description" : "就餐人均100元",
16      "count" : 4
17    }
18  ],
19  "post_discounts" : [
20    {
21      "name" : "满20减1元",
22      "description" : "不与其他优惠叠加",
23      "amount" : 100,
24      "count" : 2
25    }
26  ],
27  "risk_fund" : {
28    "name" : "DEPOSIT",
29    "amount" : 10000,
30    "description" : "就餐的预估费用"
31  },
32  "total_amount" : 40000,
33  "collection" : {
34    "state" : "USER_PAID",
35    "total_amount" : 50000,
36    "paying_amount" : 40000,
37    "paid_amount" : 10000,
38    "details" : [
39      {
40        "seq" : 1,
41        "amount" : 10000,
42        "paid_type" : "NEWTON",
43        "paid_time" : "20091225091210",
44        "transaction_id" : "15646546545165651651",
45        "promotion_detail" : [
46          {
47            "coupon_id" : "123456",
48            "name" : "单品优惠-6",
49            "scope" : "GLOBAL",
50            "type" : "CASH",
51            "amount" : 100,
52            "stock_id" : "activity_id",
53            "wechatpay_contribute" : 100,
54            "merchant_contribute" : 100,
55            "other_contribute" : 100,
56            "currency" : "CNY",
57            "goods_detail" : [
58              {
59                "goods_id" : "M1006",
60                "quantity" : 1,
61                "unit_price" : 1,
62                "discount_amount" : 100,
63                "goods_remark" : "商品备注信息"
64              }
65            ]
66          }
67        ]
68      }
69    ],
70    "bank_type" : "example_bank_type"
71  },
72  "time_range" : {
73    "start_time" : "20091225091010",
74    "end_time" : "20091225121010",
75    "start_time_remark" : "备注1",
76    "end_time_remark" : "备注2"
77  },
78  "location" : {
79    "start_location" : "嗨客时尚主题展餐厅",
80    "end_location" : "嗨客时尚主题展餐厅"
81  },
82  "attach" : "Easdfowealsdkjfnlaksjdlfkwqoi&wl3l2sald",
83  "notify_url" : "https://api.test.com",
84  "openid" : "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
85  "sub_openid" : "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
86  "order_id" : "0000300001201908301055157220022",
87  "channel_id" : "1230000109"
88}
89

错误码

公共错误码

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

业务错误码

状态码	错误码	描述	解决方案
400	INVALID_ORDER_STATE	单据状态错误	确认操作是否符合流程
400	INVALID_REQUEST	请求参数符合参数格式，但不符合业务规则	请确认相同单号是否使用了不同的参数
400	ORDER_CANCELED	单据已取消	当前状态无需操作
400	ORDER_DONE	订单已完成	当前状态无需操作
403	NO_AUTH	商户信息不合法	登录商户平台核对，传入正确信息
404	ORDER_NOT_EXIST	订单不存在	确认入参，传入正确单据
429	FREQUENCY_LIMITED	频率超限	请求量不要超过接口调用频率限制
500	SYSTEM_ERROR	系统错误	5开头的状态码都为系统问题，请使用相同参数稍后重新调用

文档是否有帮助

更多支持

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