Login expired. Please log in again.

Feedback

0/300

Feedback

Submitted successfully

ok

Feedback

Network exception, please try again later

ok

身份信息校验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 证件姓名,字段值需要进行加密
示例值:张三

请求示例:

{
  "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"
}

版本说明

关闭
V1.0
2020年4月3日
1. 身份信息校验API上线

About  WeChat  Pay

Powered By Tencent & Tenpay Copyright©

2005-2024 Tenpay All Rights Reserved.

Contact Us
Wechat Pay Global

WeChat Pay Global