最新更新時間:2019.09.09 版本說明
由于證書有效期限制和交易安全的原因,微信支付會不定期的更換平臺證書。微信支付提供了一系列接口,幫助商戶后臺系統(tǒng)實現(xiàn)平滑的證書更換。
● 建議開發(fā)者使用中控服務(wù)器(即統(tǒng)一管理和分發(fā),注意證書的保密和安全性)統(tǒng)一下載和管理微信支付平臺證書。其他業(yè)務(wù)邏輯服務(wù)器通過該中控服務(wù)器進行報文的驗簽和解密。
● 在微信支付更換平臺證書之前,待更換的證書會提前24小時加入商戶的平臺證書列表。中控服務(wù)器需要定時查詢商戶的平臺證書列表,并及時下載新的平臺證書。
● 在微信支付更換平臺證書期間,商戶收到的應(yīng)答請求和回調(diào)通知中會同時存在不同的證書序列號,商戶要能正確處理這種情況。
● 獲取平臺證書的接口頻率限制規(guī)則:?單個商戶號?1000次/s?(查單接口為600次/s)。
在中控服務(wù)器上調(diào)用;
定時調(diào)用,間隔應(yīng)小于12小時;
與本地證書序列表對比,如果發(fā)現(xiàn)有新增證書序列號,則需要新?lián)Q的證書。老證書會在1天內(nèi)失效,應(yīng)及時清理;
獲取到證書后,分發(fā)到各業(yè)務(wù)接口服務(wù)器。
適用對象:電商平臺
請求URL:https://api.mch.weixin.qq.com/v3/certificates
請求方式:GET
接口規(guī)則:http://www.tg885.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml
path指該參數(shù)為路徑參數(shù)
query指該參數(shù)需在請求URL傳參
body指該參數(shù)需在請求JSON傳參
無請求參數(shù)
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
序列號 | serial_no | string[1,32] | 是 | 證書的序列號 |
證書 | encrypt_certificate | string[1,4096] | 是 | 證書內(nèi)容 |
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
返回狀態(tài)碼 | code | string[1,32] | 是 | 錯誤碼,枚舉值見錯誤碼列表 示例值:INVALID_REQUEST |
返回信息 | message | string[1,256] | 否 | 返回信息,如非空,為錯誤原因 示例值:參數(shù)格式校驗錯誤 |
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
500 | SYSTEMERROR | 系統(tǒng)錯誤 | 系統(tǒng)異常,請使用相同參數(shù)稍后重新調(diào)用 |
400 | PARAM_ERROR | 參數(shù)錯誤 | 請使用正確的參數(shù)重新調(diào)用 |
400 | RESOURCE_ALREADY_EXISTS | 存在流程進行中的申請單,請檢查是否重入 | 可通過查詢申請狀態(tài)查看此申請單的申請狀態(tài),或更換out_request_no提交新的申請單 |
403 | NO_AUTH | 商戶權(quán)限異常 | 請確認是否已經(jīng)開通相關(guān)權(quán)限 |
404 | RESOURCE_NOT_EXISTS | 申請單不存在 | 確認入?yún)ⅲ瑐魅胝_的申請單編號 |