最新更新時(shí)間:2019.09.09 版本說明
通過 POST 表單來調(diào)用該接口,表單媒體文件 id 為 media,需有 filename、filelength、content-type 等信息。
適用對(duì)象:直連模式 機(jī)構(gòu)模式
請(qǐng)求URL:https://api.mch.weixin.qq.com/secapi/mch/uploadmedia
請(qǐng)求主體類型:multipart/form-data
請(qǐng)求方式:POST
是否需要證書: 是, 詳見證書使用
參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
---|---|---|---|---|
商戶號(hào) | mch_id | string[1,32] | 是 | 微信支付分配的商戶號(hào) 示例值:1000000000 |
媒體文件 | media | string[1,256] | 是 | form-data中媒體文件標(biāo)識(shí),有filename、filelength、content-type等信息。支持 jpeg、jpg、bmp、png 格式,圖片大小不超過2M。不參與簽名計(jì)算 示例值:test.jpg |
媒體文件內(nèi)容hash值 | media_hash | string[1,32] | 是 | 根據(jù)媒體文件內(nèi)容進(jìn)行MD5計(jì)算后的值,注意小寫 示例值:hjkahkjsjkfsjk78687dhjahdajhk |
簽名 | sign | string[1,32] | 是 | 通過簽名算法計(jì)算得出的簽名值,詳見簽名生成算法 示例值:D675A1E471DBF7C0B1AC5883B5BDA9EF |
簽名方式 | sign_type | string[1,10] | 否 | HMAC-SHA256加密方式,其他或者不填為MD5方式 示例值:HMAC-SHA256 |
curl --cert ./apiclient_cert.pem --key ./apiclient_key.pem -F 'mch_id=1000000000' -F 'media_hash=709d1e858d2ef9d0501cc053668b2872' -F 'sign=D675A1E471DBF7C0B1AC5883B5BDA9EF' -F 'media=@test.jpg' https://api.mch.weixin.qq.com/secapi/mch/uploadmedia
參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
---|---|---|---|---|
返回狀態(tài)碼 | return_code | string[1,16] | 是 | SUCCESS/FAIL 此字段是通信標(biāo)識(shí),非交易標(biāo)識(shí),交易是否成功需要查看trade_state來判斷? 示例值:SUCCESS |
返回信息 | return_msg | string[1,128] | 是 | 返回信息,如非空,為錯(cuò)誤原因,簽名失敗,參數(shù)格式校驗(yàn)錯(cuò)誤? 示例值:簽名失敗 |
以下字段在return_code為SUCCESS的時(shí)候有返回
參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
---|---|---|---|---|
業(yè)務(wù)結(jié)果 | result_code | string[1,32] | 是 | SUCCESS/FAIL 示例值:FAIL |
媒體標(biāo)識(shí)Id | media_id | string[1,256] | 是 | 微信返回的媒體文件標(biāo)識(shí)Id 示例值:9UYfXi- WMUhgWXvJtEw4_gBl e_EfrD_pIL0bS8GAsK8 |
簽名 | sign | string[1,32] | 是 | 微信返回的簽名,詳見簽名生成算法 示例值:pIL0bS8GAsKpIL0bS8GAsKpIL0bS8GAs |
錯(cuò)誤代碼 | err_code | string[1,32] | 否 | 錯(cuò)誤代碼 示例值:INVALID_REQUEST |
錯(cuò)誤代碼描述 | err_code_de s | string[1,128] | 否 | 結(jié)果信息描述 示例值:商戶號(hào)信息有誤,請(qǐng)檢查修改后重試 |
<xml>?
<return_code><![CDATA[SUCCESS]]></return_code>?
<return_msg><![CDATA[OK]]></return_msg>?
<result_code><![CDATA[SUCCESS]]></result_code>?
<media_id><![CDATA[9UYfXi- WMUhgWXvJtEw4_gBle_EfrD_pIL0bS8GAsK8]]></media_id>
<sign><![CDATA[D675A1E471DBF7C0B1AC5883B5BDA9EF]]></sign>?
</xml>
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
NVALID_REQUEST | 不支持http get 方法 | 請(qǐng)使用post 方法,請(qǐng)檢查后重新提交 | 檢查輸入?yún)?shù) |
INVALID_REQUEST | xml格式錯(cuò)誤 | xml參數(shù)格式錯(cuò)誤,請(qǐng)檢查后重新提交 | 參數(shù)格式錯(cuò)誤,請(qǐng)檢查后重新提交 |
SIGNERROR | 驗(yàn)簽錯(cuò)誤 | 簽名校驗(yàn)失敗,請(qǐng)檢查后重試 | 簽名校驗(yàn)失敗,請(qǐng)檢查后重試 |
INVALID_REQUEST | 需要證書 | 獲取客戶端證書序列號(hào)失敗 獲取客戶端證書特征名稱(DN)域失敗 證書校驗(yàn)失敗,請(qǐng)檢查后重試 |
檢查證書 |
PARAM_ERROR | 參數(shù)錯(cuò)誤 | 參數(shù)填寫有誤,請(qǐng)檢查后重試 | 人工檢查過濾 |
PARAM_ERROR | 圖片文件錯(cuò)誤 | 圖片格式不正確,請(qǐng)檢查后重新提交 圖片大小不能超過2M,請(qǐng)檢查后重新提交 圖片Hash 值有誤,請(qǐng)檢查后重新提交 |
檢查圖片 |
PARAM_ERROR | 商戶號(hào)錯(cuò)誤 | 商戶號(hào)mchid 有誤,請(qǐng)檢查后重試 | 檢查商戶號(hào)是否正確 |
INVALID_REQUEST | 調(diào)用權(quán)限 | 暫無權(quán)限,請(qǐng)檢查后重試 | 檢查權(quán)限 |
FREQUENCY_LIMITED | 頻率限制 | 操作過快,請(qǐng)稍后重試 | 放慢上傳頻率 |
SYSTEMERROR | 上傳圖片失敗 | 上傳圖片失敗,請(qǐng)稍后重試 | 聯(lián)系微信支付客服 |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP證