微信支付-開發(fā)者文檔

返回上一層文檔首頁 / 下載平臺(tái)證書API

下載平臺(tái)證書API

最新更新時(shí)間：2019.09.09 版本說明

由于證書有效期限制和交易安全的原因，微信支付會(huì)不定期的更換平臺(tái)證書。微信支付提供了一系列接口，幫助商戶后臺(tái)系統(tǒng)實(shí)現(xiàn)平滑的證書更換。

更換指引：

● 建議開發(fā)者使用中控服務(wù)器（即統(tǒng)一管理和分發(fā)，注意證書的保密和安全性）統(tǒng)一下載和管理微信支付平臺(tái)證書。其他業(yè)務(wù)邏輯服務(wù)器通過該中控服務(wù)器進(jìn)行報(bào)文的驗(yàn)簽和解密。

● 在微信支付更換平臺(tái)證書之前，待更換的證書會(huì)提前24小時(shí)加入商戶的平臺(tái)證書列表。中控服務(wù)器需要定時(shí)查詢商戶的平臺(tái)證書列表，并及時(shí)下載新的平臺(tái)證書。

● 在微信支付更換平臺(tái)證書期間，商戶收到的應(yīng)答請(qǐng)求和回調(diào)通知中會(huì)同時(shí)存在不同的證書序列號(hào)，商戶要能正確處理這種情況。

● 獲取平臺(tái)證書的接口頻率限制規(guī)則:?單個(gè)商戶號(hào)?1000次/s?(查單接口為600次/s)。

最佳實(shí)踐：

在中控服務(wù)器上調(diào)用；

定時(shí)調(diào)用，間隔應(yīng)小于12小時(shí)；

與本地證書序列表對(duì)比，如果發(fā)現(xiàn)有新增證書序列號(hào)，則需要新?lián)Q的證書。老證書會(huì)在1天內(nèi)失效，應(yīng)及時(shí)清理；

獲取到證書后，分發(fā)到各業(yè)務(wù)接口服務(wù)器。

接口說明

適用對(duì)象：電商平臺(tái)

請(qǐng)求URL：https://api.mch.weixin.qq.com/v3/certificates

請(qǐng)求方式：GET

path指該參數(shù)為路徑參數(shù)

query指該參數(shù)需在請(qǐng)求URL傳參

body指該參數(shù)需在請(qǐng)求JSON傳參

請(qǐng)求參數(shù)

無請(qǐng)求參數(shù)

返回參數(shù)

參數(shù)名	變量	類型[長(zhǎng)度限制]	必填	描述
序列號(hào)	serial_no	string[1,32]	是	證書的序列號(hào)
證書	encrypt_certificate	string[1,4096]	是	證書內(nèi)容

異常返回

參數(shù)名	變量	類型[長(zhǎng)度限制]	必填	描述
返回狀態(tài)碼	code	string[1,32]	是	錯(cuò)誤碼，枚舉值見錯(cuò)誤碼列表示例值：INVALID_REQUEST
返回信息	message	string[1,256]	否	返回信息，如非空，為錯(cuò)誤原因示例值：參數(shù)格式校驗(yàn)錯(cuò)誤

返回示例


{
    "data" : [
        {
            "serial_no": "",
            "encrypt_certificate": ""
        },
        {
            "serial_no": "",
            "encrypt_certificate": ""
        }
    ]
}

    
{
	"code":"INVALID_REQUEST",
	"message":"參數(shù)格式校驗(yàn)錯(cuò)誤"
}

錯(cuò)誤碼公共錯(cuò)誤碼

狀態(tài)碼	錯(cuò)誤碼	描述	解決方案
500	SYSTEMERROR	系統(tǒng)錯(cuò)誤	系統(tǒng)異常，請(qǐng)使用相同參數(shù)稍后重新調(diào)用
400	PARAM_ERROR	參數(shù)錯(cuò)誤	請(qǐng)使用正確的參數(shù)重新調(diào)用
400	RESOURCE_ALREADY_EXISTS	存在流程進(jìn)行中的申請(qǐng)單，請(qǐng)檢查是否重入	可通過查詢申請(qǐng)狀態(tài)查看此申請(qǐng)單的申請(qǐng)狀態(tài)，或更換out_request_no提交新的申請(qǐng)單
403	NO_AUTH	商戶權(quán)限異常	請(qǐng)確認(rèn)是否已經(jīng)開通相關(guān)權(quán)限
404	RESOURCE_NOT_EXISTS	申請(qǐng)單不存在	確認(rèn)入?yún)ⅲ瑐魅胝_的申請(qǐng)單編號(hào)

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

微信支付合作伙伴平臺(tái)