最新更新時(shí)間：2020.04.03 版本說(shuō)明
該接口用于商戶上傳用戶身份信息，微信支付會(huì)重新校驗(yàn)返回訂購(gòu)人和支付人身份信息校驗(yàn)結(jié)果，用于商戶糾正報(bào)關(guān)訂單里的信息。
身份信息校驗(yàn)不管是否一致，微信支付都只能以系統(tǒng)登記的支付人信息推送海關(guān)。 只有已經(jīng)報(bào)關(guān)的訂單才能夠調(diào)用該接口。
對(duì)于加密字段，請(qǐng)參照以下加密算法：
1、獲取微信支付平臺(tái)證書(shū)和對(duì)應(yīng)的平臺(tái)證書(shū)序列號(hào)，本接口請(qǐng)求 http 頭的“Wechatpay-Serial”需要傳平臺(tái)證書(shū)序列號(hào)。
2、使用微信支付平臺(tái)證書(shū)的公鑰，對(duì)于需要加密的參數(shù)值進(jìn)行 RSA 加密。填充方案使用 `RSAES-PKCS1-v1_5`。
3、加密后的密文，使用 base64 編碼后，作為請(qǐng)求中相應(yīng)參數(shù)的值。
適用對(duì)象：直連模式 機(jī)構(gòu)模式
接口URL：https://apihk.mch.weixin.qq.com/global/v3/customs /verify-certificate
請(qǐng)求方式：POST
接口規(guī)則：https://wechatpay-api.gitbook.io/wechatpay-api-v3/
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請(qǐng)求JSON傳參
| 參數(shù)名 | 變量 | 類型 | 必填 | 描述 |
|---|---|---|---|---|
| 機(jī)構(gòu)APPID | appid | string(32) | 是 | body 微信分配的公眾賬號(hào)ID 示例值：wxd678efh567hg6787 |
| 商戶號(hào) | mchid | string(32) | 是 | body 微信支付分配的商戶號(hào) 示例值：1230000109 |
| 商戶訂單號(hào) | out_trade_no | string(32) | 是 | body 商戶系統(tǒng)內(nèi)部訂單號(hào)，要求32個(gè)字符內(nèi)，只能是數(shù)字、大小寫(xiě)字母_-|*@ ，且在同一個(gè)商戶號(hào)下唯一 示例值：20150806125346 |
| 微信訂單號(hào) | transaction_id | string(32) | 是 | body 微信支付返回的訂單號(hào) 示例值：1000320306201511078440737890 |
| 商戶子訂單號(hào) | sub_order_no | string(32) | 否 | body 商戶子訂單號(hào)，如有拆單則必傳 注意：僅適用于機(jī)構(gòu)模式 示例值：20150806125346 |
| 海關(guān) | customs | string(32) | 是 | body 海關(guān)代碼，枚舉值參見(jiàn)參數(shù)規(guī)定-海關(guān)列表 示例值：SHANGHAI_ZS |
| 商戶海關(guān)備案號(hào) | merchant_customs_no | string(32) | 是 | body 商戶在海關(guān)登記的備案號(hào) 示例值：123456 |
| 證件類型 | certificate_type | string(16) | 是 | body 請(qǐng)傳固定值IDCARD，暫只支持大陸身份證 示例值：IDCARD |
| 證件號(hào) | certificate_id | string | 是 | body 用戶大陸身份證號(hào)，尾號(hào)為字母X的身份證號(hào)，請(qǐng)大寫(xiě)字母X。該字段需要進(jìn)行加密 示例值：330821198809085211 |
| 證件姓名 | certificate_name | string | 是 | body 證件姓名，字段值需要進(jìn)行加密 示例值：張三 |
{
"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": "張三"
}| 參數(shù)名 | 變量 | 類型 | 必填 | 描述 |
|---|---|---|---|---|
| 機(jī)構(gòu)APPID | appid | string(32) | 是 | 微信分配的公眾賬號(hào)ID 示例值：wxd678efh567hg6787 |
| 商戶號(hào) | mchid | string(32) | 是 | 微信支付分配的商戶號(hào) 示例值：1230000109 |
| 商戶訂單號(hào) | out_trade_no | string(32) | 是 | 商戶系統(tǒng)內(nèi)部訂單號(hào)，要求32個(gè)字符內(nèi)，只能是數(shù)字、大小寫(xiě)字母_-|*@ ，且在同一個(gè)商戶號(hào)下唯一 示例值：20150806125346 |
| 微信訂單號(hào) | transaction_id | string(32) | 是 | 微信支付返回的訂單號(hào) 示例值：1000320306201511078440737890 |
| 身份核驗(yàn)結(jié)果 | certificate_check_result | string(32) | 是 | 訂購(gòu)人和支付人身份信息校驗(yàn)結(jié)果 SAME：身份信息校驗(yàn)匹配 DIFFERENT：身份信息校驗(yàn)不匹配 示例值：SAME |
| 參數(shù)名 | 變量 | 類型 | 必填 | 描述 |
|---|---|---|---|---|
| 返回狀態(tài)碼 | code | string（32） | 是 | 錯(cuò)誤碼，枚舉值見(jiàn)錯(cuò)誤碼列表 示例值：INVALID_REQUEST |
| 返回信息 | message | string（256） | 是 | 返回信息，如非空，為錯(cuò)誤原因 示例值：參數(shù)格式校驗(yàn)錯(cuò)誤 |
| +詳細(xì)錯(cuò)誤描述 | detail | object | 否 | 當(dāng)code為PARAM_ERROR時(shí)返回，詳細(xì)說(shuō)明見(jiàn)下文 |
{
"appid": "wxd678efh567hg6787",
"mchid": "1230000109",
"out_trade_no": "20150806125346",
"transaction_id": "1000320306201511078440737890",
"certificate_check_result": "UNchECKED"
}
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP證