报关查询

更新时间：2025.01.07

商户通过订单号查询提交的订单附加信息及订单报关状态。

注意：

对于加密字段，请参照以下加密算法：

获取微信支付平台证书和对应的平台证书序列号，本接口请求 http 头的“Wechatpay-Serial”需要传平台证书序列号。

使用微信支付平台证书的公钥，对于需要加密的参数值进行 RSA 加密。填充方案使用 `RSAES-PKCS1-v1_5`。

加密后的密文，使用 base64 编码后，作为请求中相应参数的值。

1. 接口说明

适用对象: 直连模式机构模式

请求URL: https://apihk.mch.weixin.qq.com/v3/global/customs/orders

请求方式: GET

Path 指该参数为路径参数

Query 指该参数为URL参数

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

2. 请求参数

参数名	变量	类型[长度限制]	必填	描述
机构APPID	appid	string[1,32]	是	Query 微信分配的公众账号ID 示例值：wxd678efh567hg6787
商户号	mchid	string[1,32]	是	Query 微信支付分配的商户号示例值：1230000109
订单类型	order_type	string[1,16]	是	Query 4种订单号类型，选择一种 out_trade_no 商户订单号 transaction_id 微信支付订单号 sub_order_no 商户子订单号 sub_order_id 微信子订单号示例值：out_trade_no
订单号	order_no	string[1,32]	是	Query 根据订单号类型，传入不同的订单号码示例值：20150806125346
海关	customs	string[1,32]	是	Query 海关代码，枚举值参见海关列表示例值：SHANGHAI_ZS
偏移量	offset	int	否	Query 非0整数，该次请求资源的起始位置，从0开始计数。调用方选填，默认为0 示例值：1
请求最大记录条数	limit	int	否	Query 非0非负的整数，该次请求可返回的最大资源条数。调用方选填，默认值建议为20 示例值：20

请求示例

URL

1https://apihk.mch.weixin.qq.com/v3/global/customs/orders?appid=wxd678efh567hg6787&mchid=1230000109&order_type=transaction_id&order_no=20150806125346&customs=SHANGHAI_ZS&offset=1&limit=20

3. 返回参数

正常返回

参数名

变量

类型[长度限制]

必填

描述

机构APPID

appid

string[1,32]

是

微信分配的公众账号ID
示例值：wxd678efh567hg6787

商户号

mchid

string[1,32]

是

微信支付分配的商户号
示例值：1230000109

微信订单号

transaction_id

string[1,32]

是

微信支付返回的订单号
示例值：1000320306201511078440737890

核验机构

verify_department

string[1,16]

是

核验机构代码
UNIONPAY：银联
NETSUNION：网联
OTHERS：其他
示例值：UNIONPAY

核验机构流水号

verify_department_trade_id

string[1,64]

是

交易流水号，来自验核机构，如银联记录的交易流水号，供商户报备海关
示例值：2018112288340107038204310100000

偏移量

offset

int

是

返回请求时设置的偏移值
示例值：0

请求最大记录条数

limit

int

是

返回请求时设置的最大记录数
示例值：20

查询结果总条数

total_count

int

是

查询结果总条数
示例值：1

报关数据包

data

array

是

报关单结果数组，具体内容参见下方描述

报关数据包

异常返回

参数名

变量

类型[长度限制]

必填

描述

返回状态码

code

string[1, 32]

是

错误码，枚举值见错误码列表

示例值：INVALID_REQUEST

返回信息

message

string[1, 256]

是

返回信息，如非空，为错误原因

示例值：参数格式校验错误

详细的错误描述

detail

object

否

当code为PARAM_ERROR时返回，详细说明见下

详细的错误描述

返回示例

正常示例

1{
2	"appid": "wxd678efh567hg6787",
3	"mchid": "1230000109",
4	"transaction_id": "1000320306201511078440737890",
5	"verify_department": "UNIONPAY",
6	"verify_department_trade_id": "2018112288340107038204310100000",
7	"offset": 0,
8	"limit": 20,
9	"total_count": 1,
10	"data": [{
11		"sub_order_no": "20150806125346",
12		"sub_order_id": "20150806125346",
13		"mch_customs_no": "1234567",
14		"customs": "SHANGHAI_ZS",
15		"fee_type": "CNY",
16		"order_fee": 888,
17		"duty": 888,
18		"transport_fee": 888,
19		"product_fee": 888,
20		"state": "PROCESSING",
21		"explanation": "支付单已存在并且为非退单状态",
22		"modify_time": "2015-09-01T10:00:00+08:00"
23	}]
24}

异常示例

1{
2	"code": "INVALID_REQUEST",
3	"message": "Parameter format verification error",
4	"detail": {
5		"field": "#/properties/payer",
6		"value": "1346177081915535577",
7		"issue": "与ALLOF schema不符",
8		"location": "body"
9	}
10}

4. 错误码

错误码	描述	解决方案
INVALID_REQUEST	该订单没有申报	该订单没有申报，请申报后再查询
	查询指定记录不存在，请重新选择条件查询	查询记录不存在，请按要求重新查询
	海关配置未设置	报关接口需要商户已配置过海关信息才可以访问。请参照上文中的海关备案指引，进行海关信息报备
NOAUTH	商户未在当前申报的海关进行备案	商户未在申报的海关中备案，请商户完成备案后重试；
NOAUTH	未开通自助清关功能	请检查当前商户是否已开通自助清关功能，开通路径：微信支付商户平台-产品中心-自助清关中申请开通。
PARAM_ERROR	参数错误	参数错误，可能参数有误或参数遗漏，请检查接口参数是否按要求提交
SYSTEMERROR	系统错误	请重新报关，或联系微信支付小助手排查原因