查询支付分订单

更新时间：2025.04.01

用于查询单笔微信支付分订单详细信息

注意：

前置条件：商户创建订单已受理。

1. 接口说明

适用对象: 机构模式

请求URL：https://apihk.mch.weixin.qq.com/v3/payscore/oversea/partner/serviceorder

请求方式：GET

Path 指该参数为路径参数

Query 指该参数为URL参数

Body 指该参数需在请求JSON传参

2. 请求参数

参数名	变量	类型[长度限制]	必填	描述
服务ID	service_id	string[1,32]	否	Query 该服务ID有本接口对应产品的权限示例值：2002000000000558128851361561536
子商户号	sub_mchid	string[1,32]	是	Query 子商户商户号，由微信支付生成并下发。示例值：1900000109
商户订单号	out_order_no	string[1,32]	否	Query 商户系统内部服务订单号（不是交易单号），要求32个字符内，只能是数字、大小写字母_-\|* 且在同一个商户号下唯一。示例值：1234323JKHDFE1243252
单据查询ID	query_id	string[1,512]	否	Query 确认订单流程，微信侧回跳到商户前端时，携带的用于单据查询的ID。商户订单号与单据查单ID必填其一。示例值：15646546545165651651

3. 请求示例

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

4. 返回参数

参数名

变量

类型[长度限制]

必填

描述

商户订单号

out_order_no

string[1,32]

是

调用接口传入的商户订单号
示例值：1234323JKHDFE1243252

服务ID

service_id

string[1,32]

是

调用接口传入的服务ID
示例值：2002000000000558128851361561536

服务商公众号ID

appid

string[1,32]

是

调用接口传入的服务商公众号ID
示例值：wxd678efh567hg6787

服务商商户号

mchid

string[1,32]

是

调用接口传入的服务商商户号
示例值：1230000109

子商户公众号ID

sub_appid

string[1,32]

否

调用接口传入的子商户公众号ID
示例值：wxd678efh567hg6999

子商户号

sub_mchid

string[1,32]

否

调用接口传入的子商户商户号
示例值：1900000109

服务信息

service_introduction

string[1,32]

是

调用接口传入的服务信息
示例值：XX充电宝

服务订单状态

state

string[1,32]

是

当前单据状态。

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

示例值：CREATED

订单状态说明

state_description

string[1,32]

否

对服务订单"DOING"状态的附加说明。

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

示例值：MCH_COMPLETE

后付费项目

post_payments

array[Payments]

否

调用接口传入的后付费项目，详细说明见下文

后付费项目

商户优惠

post_discounts

array[ServiceOrderCoupon]

否

调用接口传入的商户优惠，详细说明见下文

商户优惠

服务风险金

risk_fund

RiskFund

否

调用接口传入的服务风险金，详细说明见下文

服务风险金

总金额

total_amount

int

否

调用接口传入的总金额
示例值：40000

是否需要收款

need_collection

bool

否

调用接口传入的是否需要收款，
true：微信支付分代收款
false：无需微信支付分代收款
示例值：true

收款信息

collection

Collection

否

收款成功后，展示具体的收款信息，详细说明见下文

收款信息

参数名

变量

类型[长度限制]

必填

描述

收款状态

state

string[1,32]

是

USER_PAYING：待支付
USER_PAID：已支付
示例值：USER_PAID

总收款金额

total_amount

int

否

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

待收金额

paying_amount

int

否

等待用户付款金额。
示例值：40000

已收金额

paid_amount

int

否

用户已付款的金额
示例值：10000

收款明细列表

details

array[Detail]

否

收款明细列表，详细说明见下文

收款明细列表

参数名

变量

类型[长度限制]

必填

描述

收款序号

seq

int

否

从1开始递增
示例值：1

单笔收款金额

amount

int

否

单笔收款动作的金额
示例值：10000

收款成功渠道

paid_type

string[1,32]

否

微信支付分：NEWTON
商户渠道：MCH
示例值：NEWTON

收款成功时间

paid_time

string[1,64]

否

支付成功时间，遵循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秒
示例值：2019-11-11T16:24:05+08:00

微信支付交易单号

transaction_id

string[1,64]

否

结单交易单号,等于普通支付接口中的transaction_id，可以使用该订单号在APP支付->API列表->查询订单进行查询订单、申请退款。只有单据状态为USER_PAID，且收款成功渠道为支付分渠道, 才会返回结单交易单号。
示例值：15646546545165651651

优惠功能

promotion_detail

array[PromotionDetail]

否

优惠功能，详细说明见下文

优惠功能

收款银行

bank_type

string

否

银行类型，采用字符串类型的银行标识。
示例值：example_bank_type

服务时间

time_range

object

否

调用接口传入的服务时间，详细说明见下文

服务时间

服务位置

location

object

否

服务使用位置信息，详细说明见下文

服务位置

附加数据

attach

string[1,256]

否

调用接口传入的附加数据
示例值：Easdfowealsdkjfnlaksjdlfkwqoi&wl3l2sald

商户回调地址

notify_url

string[1,256]

否

调用接口传入的商户回调地址
示例值：https://api.test.com

服务商公众号下的用户标识

openid

string[1,128]

否

调用接口传入的服务商公众号下的用户标识
示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o

子商户公众号下的用户标识

sub_openid

string[1,128]

否

调用接口传入的子商户公众号下的用户标识
示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o

微信支付服务订单号

order_id

string[1,64]

否

微信支付服务订单号，每个微信支付服务订单号与商户号下对应的商户服务订单号一一对应
示例值：0000300001201908301055157220022

货币类型

currency

string[1,16]

否

为收款商户的结算币种类型，同一个商户号下唯一
示例值：HKD

汇率值

currency_price

int

否

确认订单时锁定的汇率值
示例值：90000000

汇率

currency_rate_info

string

否

确认订单时锁定的汇率，由汇率值换算得到
示例值：1HKD=0.90CNY

5. 返回示例

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  "need_collection" : true,
34  "collection" : {
35    "state" : "USER_PAID",
36    "total_amount" : 50000,
37    "paying_amount" : 40000,
38    "paid_amount" : 10000,
39    "details" : [
40      {
41        "seq" : 1,
42        "amount" : 10000,
43        "paid_type" : "NEWTON",
44        "paid_time" : "2019-11-11T16:24:05+08:00",
45        "transaction_id" : "15646546545165651651",
46        "promotion_detail" : [
47          {
48            "coupon_id" : "123456",
49            "name" : "单品优惠-6",
50            "scope" : "GLOBAL",
51            "type" : "CASH",
52            "amount" : 100,
53            "stock_id" : "activity_id",
54            "wechatpay_contribute" : 100,
55            "merchant_contribute" : 100,
56            "other_contribute" : 100,
57            "currency" : "CNY",
58            "goods_detail" : [
59              {
60                "goods_id" : "M1006",
61                "quantity" : 1,
62                "unit_price" : 1,
63                "discount_amount" : 100,
64                "goods_remark" : "商品备注信息"
65              }
66            ]
67          }
68        ]
69      }
70    ],
71    "bank_type" : "example_bank_type"
72  },
73  "time_range" : {
74    "start_time" : "2019-11-11T16:24:05+08:00",
75    "end_time" : "2019-11-11T16:24:05+08:00",
76    "start_time_remark" : "备注1",
77    "end_time_remark" : "备注2"
78  },
79  "location" : {
80    "start_location" : "嗨客时尚主题展餐厅",
81    "end_location" : "嗨客时尚主题展餐厅"
82  },
83  "attach" : "Easdfowealsdkjfnlaksjdlfkwqoi&wl3l2sald",
84  "notify_url" : "https://api.test.com",
85  "openid" : "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
86  "sub_openid" : "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
87  "order_id" : "0000300001201908301055157220022",
88  "currency" : "HKD",
89  "currency_price" : 90000000,
90  "currency_rate_info" : "1HKD=0.90CNY"
91}

6. 错误码

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