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