API字典 / 海关报关 / 身份信息校验API

身份信息校验API

最新更新时间：2022.08.04 版本说明

该接口用于商户提交海关需要的订单附加信息。

注意：

身份信息校验不管是否一致，微信支付都只能以系统登记的支付人信息推送海关。只有已经报关的订单才能够调用该接口。

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

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

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

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

1. 接口说明

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

请求URL: https://apihk.mch.weixin.qq.com/v3/global/customs/verify-certificate

请求方式: POST

Path指该参数为路径参数

Query指该参数为URL参数

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

2. 请求参数

参数名	变量	类型[长度限制]	必填	描述
机构APPID	appid	string[1,32]	是	Body 微信分配的公众账号ID 示例值：wxd678efh567hg6787
商户号	mchid	string[1,32]	是	Body 微信支付分配的商户号示例值：1230000109
商户订单号	out_trade_no	string[1,32]	是	Body 商户系统内部订单号，要求32个字符内，只能是数字、大小写字母_-\|*@ ，且在同一个商户号下唯一示例值：20150806125346
微信订单号	transaction_id	string[1,32]	是	Body 微信支付返回的订单号示例值：1000320306201511078440737890
商户子订单号	sub_order_no	string[1,32]	否	Body 商户子订单号，如有拆单则必传注意：仅适用于机构模式示例值：20150806125346
海关	customs	string[1,32]	是	Body 海关代码，枚举值参见海关列表示例值：SHANGHAI_ZS
商户海关备案号	merchant_customs_no	string[1,32]	是	Body 商户在海关登记的备案号示例值：123456
证件类型	certificate_type	string[1,16]	是	Body 请传固定值IDCARD，暂只支持大陆身份证示例值：IDCARD
证件号	certificate_id	string	是	Body 用户大陆身份证号，尾号为字母X的身份证号，请大写字母X。该字段需要进行加密示例值：330821198809085211
证件姓名	certificate_name	string	是	Body 证件姓名，字段值需要进行加密示例值：张三

请求示例

JSON


{
  "appid": "wxd678efh567hg6787",
  "mchid": "1230000109",
  "out_trade_no": "20150806125346",
  "transaction_id": "1000320306201511078440737890",
  "sub_order_no": "20150806125346",
  "customs": "SHANGHAI_ZS",
  "merchant_customs_no": "123456",
  "certificate_type": "IDCARD",
  "certificate_id": "330821198809085211",
  "certificate_name": "张三"
}

{
    "appid": "wx2421b1c4370ec43b",
    "m",
      "device_id" : "013467007045764",
      "operator_id": "P001",
      "store_info" : {
        "id": "SZTX001"
      }
    }
}


									{
										"stock_id": ".NET",
										"limit": 10,
									}


									{
										"stock_id": "Python",
										"stock_creator_mchid": "123456",
										"limit": 10,
									}

3. 返回参数

正常返回

参数名	变量	类型[长度限制]	必填	描述
机构APPID	appid	string[1,32]	是	微信分配的公众账号ID 示例值：wxd678efh567hg6787
商户号	mchid	string[1,32]	是	微信支付分配的商户号示例值：1230000109
商户订单号	out_trade_no	string[1,32]	是	商户系统内部订单号，要求32个字符内，只能是数字、大小写字母_-\|*@ ，且在同一个商户号下唯一示例值：20150806125346
微信订单号	transaction_id	string[1,32]	是	微信支付返回的订单号示例值：1000320306201511078440737890
身份核验结果	certificate_check_result	string[1,32]	是	订购人和支付人身份信息校验结果 SAME：身份信息校验匹配 DIFFERENT：身份信息校验不匹配示例值：SAME

异常返回

参数名

变量

类型[长度限制]

必填

描述

返回状态码

code

string[1, 32]

是

错误码，枚举值见错误码列表
示例值：INVALID_REQUEST

返回信息

message

string[1, 256]

是

返回信息，如非空，为错误原因
示例值：参数格式校验错误

详细的错误描述

detail

object

否

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

参数名	变量	类型[长度限制]	必填	描述
指示错误参数的位置	field	string[1, 256]	是	当错误参数位于请求body的JSON时，填写指向参数的JSON Pointer 当错误参数位于请求的url或者querystring时，填写参数的变量名示例值：#/properties/payer
错误参数的值	value	string[1, 256]	是	错误参数的值示例值：1346177081915535577
具体错误原因	issue	string[1, 256]	是	具体错误原因示例值：与ALLOF schema不符
错误参数的位置	location	string[1, 256]	否	body：错误参数位于请求body的JSON中 url：错误参数位于请求url中 query：错误参数位于请求的querystring中示例值：body

收起

返回示例

正常示例异常示例

{
  "appid": "wxd678efh567hg6787",
  "mchid": "1230000109",
  "out_trade_no": "20150806125346",
  "transaction_id": "1000320306201511078440737890",
  "certificate_check_result": "UNchECKED"
}

{
	"code": "INVALID_REQUEST",
	"message": "Parameter format verification error",
	"detail": {
		"field": "#/properties/payer",
		"value": "1346177081915535577",
		"issue": "与ALLOF schema不符",
		"location": "body"
	}
}

4. 错误码

错误码	描述	解决方案
INVALID_REQUEST	微信实名身份证号格式异常，请检查	支付人微信实名信息异常，请联系微信支付小助手排查原因
	海关申报记录不存在	海关申报记录不存在，请重新申请或联系微信支付小助手排查原因
	海关配置未设置	报关接口需要商户已配置过海关信息才可以访问。请参照上文中的海关备案指引，进行海关信息报备
NOAUTH	商户未在当前申报的海关进行备案	商户未在申报的海关中备案，请商户完成备案后重试；
NOAUTH	未开通自助清关功能	请检查当前商户是否已开通自助清关功能，开通路径：微信支付商户平台-产品中心-自助清关中申请开通。
PARAM_ERROR	参数错误	参数错误，可能参数有误或参数遗漏，请检查接口参数是否按要求提交
PARAM_ERROR	商户传入用户身份证格式错误	请输入正确格式的身份证号，若仍然报错，请联系微信支付小助手排查原因
SYSTEMERROR	系统错误	请重新报关，或联系微信支付小助手排查原因
USER_ACCOUNT_ABNORMAL	用户非身份证实名注册，不允许报关	支付单的申报实名信息与实际支付人的实名信息不符，请输入实际支付人的实名信息并重新申报

页面导航

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

支付产品

资金类产品

其他产品

身份信息校验API

1. 接口说明

2. 请求参数

请求示例

3. 返回参数

正常返回

异常返回

返回示例

4. 错误码