微信支付境外文檔-報關

返回上一層報關 / 身份信息校驗API

身份信息校驗API

最新更新時間：2020.04.03 版本說明

該接口用于商戶上傳用戶身份信息，微信支付會重新校驗返回訂購人和支付人身份信息校驗結果，用于商戶糾正報關訂單里的信息。

注意：

身份信息校驗不管是否一致，微信支付都只能以系統(tǒng)登記的支付人信息推送海關。只有已經報關的訂單才能夠調用該接口。

接口說明

適用對象：直連模式

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

請求方式：POST

接口規(guī)則：https://wechatpay-api.gitbook.io/wechatpay-api-v3/

請求參數

參數名	變量	類型	必填	描述
機構APPID	appid	string(32)	是	微信分配的公眾賬號ID 示例值：wxd678efh567hg6787
商戶號	mchid	string(32)	是	微信支付分配的商戶號示例值：1230000109
商戶訂單號	out_trade_no	string(32)	是	商戶系統(tǒng)內部訂單號，要求32個字符內，只能是數字、大小寫字母_-\|*@ ，且在同一個商戶號下唯一示例值：20150806125346
微信訂單號	transaction_id	string(32)	是	微信支付返回的訂單號示例值：1000320306201511078440737890
商戶子訂單號	sub_order_no	string(32)	否	商戶子訂單號，如有拆單則必傳示例值：20150806125346
海關	customs	string(32)	是	海關代碼，枚舉值參見參數規(guī)定-海關列表示例值：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)	是	商戶系統(tǒng)內部訂單號，要求32個字符內，只能是數字、大小寫字母_-\|*@ ，且在同一個商戶號下唯一示例值：20150806125346
微信訂單號	transaction_id	string(32)	是	微信支付返回的訂單號示例值：1000320306201511078440737890
身份核驗結果	certificate_check_result	string(32)	是	訂購人和支付人身份信息校驗結果 UNchECKED SAME：身份信息校驗匹配 DIFFERENT：身份信息校驗不匹配示例值：UNchECKED

異常返回

參數名

變量

類型

必填

描述

返回狀態(tài)碼

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	系統(tǒng)錯誤	請重新報關，或聯系微信支付小助手排查原因
USER_ACCOUNT_ABNORMAL	用戶非身份證實名注冊，不允許報關	支付單的申報實名信息與實際支付人的實名信息不符，請輸入實際支付人的實名信息并重新申報

视频一区二区三区自拍_千金肉奴隷1985未删减版在线观看_国产成人黄色视频在线播放_少女免费播放片高清在线观看_国产精品v欧美精品v

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

報關 API

身份信息校驗API

注意：

接口說明

請求參數

請求示例：

返回參數

正常返回

異常返回

返回示例：

錯誤碼

版本說明