微信支付境外文档-报关

返回上一层报关 / 身份信息校验API

身份信息校验API

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

该接口用于商户上传用户身份信息，微信支付会重新校验返回订购人和支付人身份信息校验结果，用于商户纠正报关订单里的信息。

注意：

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

接口说明

适用对象：直连模式

接口URL：https://apihk.mch.weixin.qq.com/global/v3/customs /verify-certificate

请求方式：POST

接口规则：https://wechatpay-api.gitbook.io/wechatpay-api-v3/

请求参数

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

请求示例：

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": "张三"
}

    
｛
JAVA示例代码
｝

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

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

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

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

返回参数

正常返回

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

异常返回

参数名

变量

类型

必填

描述

返回状态码

code

string（32）

是

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

返回信息

message

string（256）

是

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

+详细错误描述

detail

object

否

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

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

返回示例：

正常示例

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

错误码

错误码	描述	解决方案
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

身份信息校验API

注意：

接口说明

请求参数

请求示例：

返回参数

正常返回

异常返回

返回示例：

错误码

版本说明