最新更新時(shí)間:2019.09.09 版本說(shuō)明
部分微信支付業(yè)務(wù)指定商戶(hù)需要使用圖片上傳 API來(lái)上報(bào)圖片信息,從而獲得必傳參數(shù)的值:圖片MediaID 。
適用對(duì)象:直連模式 機(jī)構(gòu)模式
請(qǐng)求URL:https://api.mch.weixin.qq.com/v3/merchant/media/upload
請(qǐng)求主體類(lèi)型:multipart/form-data
請(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ù)名 | 變量 | 類(lèi)型[長(zhǎng)度限制] | 必填 | 描述 |
---|---|---|---|---|
圖片文件 | file | message | 是 | body
將媒體圖片進(jìn)行二進(jìn)制轉(zhuǎn)換,得到的媒體圖片二進(jìn)制內(nèi)容,在請(qǐng)求body中上傳此二進(jìn)制內(nèi)容。媒體圖片只支持JPG、BMP、PNG格式,文件大小不能超過(guò)2M。 示例值:pic1 |
+媒體文件元信息 | meta | Object | 是 | body 媒體文件元信息,使用json表示,包含兩個(gè)對(duì)象:filename、sha256。 |
String filePath = "/your/home/hellokitty.png";
URI uri = new URI("https://api.mch.weixin.qq.com/v3/merchant/media/upload");
File file = new File(filePath);
try (FileInputStream ins1 = new FileInputStream(file)) {
String sha256 = DigestUtils.sha256Hex(ins1);
try (InputStream ins2 = new FileInputStream(file)) {
HttpPost request = new WechatPayUploadHttpPost.Builder(uri)
.withImage(file.getName(), sha256, ins2)
.build();
CloseableHttpResponse response1 = httpClient.execute(request);
}
}
JAVA詳細(xì)請(qǐng)求示例詳見(jiàn):wechatpay-apache-httpclient
PHP詳細(xì)請(qǐng)求示例詳見(jiàn):wechatpay-guzzle-middleware
參數(shù)名 | 變量 | 類(lèi)型[長(zhǎng)度限制][長(zhǎng)度限制] | 必填 | 描述 |
---|---|---|---|---|
媒體文件標(biāo)識(shí) Id | media_id | string[1,512] | 是 | 微信返回的媒體文件標(biāo)識(shí)Id。 示例值:6uqyGjGrCf2GtyXP8bxrbuH9-aAoTjH-rKeSl3Lf4_So6kdkQu4w8BYVP3bzLtvR38lxt4PjtCDXsQpzqge_hQEovHzOhsLleGFQVRF-U_0 |
{
"media_id": "H1ihR9JUtVj-J7CJqBUY5ZOrG_Je75H-rKhTG7FUmg9sxNTbRN54dFiUHnhg
rBQ6EKeHoGcHTJMHn5TAuLVjHUQDBInSWXcIHYXOeRa2OHA"
}
1.創(chuàng)建一個(gè)POST的方法請(qǐng)求/upload URI
例如: POST https://api.mch.weixin.qq.com/v3/merchant/media/upload HTTP/1.1
2.將文件的數(shù)據(jù)添加到請(qǐng)求主體
2.1 圖片文件file參數(shù)的獲取方式說(shuō)明:
媒體圖片二進(jìn)制內(nèi)容,放在請(qǐng)求http的body中。
2.2 媒體文件元信息meta參數(shù)的獲取方式說(shuō)明:
媒體文件元信息,使用json表示,包含兩個(gè)對(duì)象:filename、sha256。
● filename參數(shù)獲取方式說(shuō)明:
商戶(hù)上傳的媒體圖片的名稱(chēng),商戶(hù)自定義,必須以JPG、BMP、PNG為后綴。
● sha256參數(shù)獲取方式說(shuō)明:
圖片文件的文件摘要,即對(duì)圖片文件的二進(jìn)制內(nèi)容進(jìn)行sha256計(jì)算得到的值。
2.3 簽名計(jì)算說(shuō)明:
https://wechatpay-api.gitbook.io/wechatpay-api-v3/qian-ming-zhi-nan-1/qian-ming-sheng-cheng
參與簽名計(jì)算的請(qǐng)求主體為meta的json串:
{ "filename": "filea.jpg", "sha256": "hjkahkjsjkfsjk78687dhjahdajhk" }
待簽名串示例:
POST
/v3/merchant/media/upload
1566987169 //時(shí)間戳
12ced2db6f0193dda91ba86224ea1cd8 //隨機(jī)數(shù)
{"filename":" filea.jpg ","sha256":" hjkahkjsjkfsjk78687dhjahdajhk "}
3.添加HTTP頭:
Content-Type:multipart/form-data.設(shè)置為要上載的對(duì)象的MIME媒體類(lèi)型。
Authorization: WECHATPAY2-SHA256-RSA2048 mchid="1900231671",
nonce_str="PCHK6HSOEDTACETP6P3AL7DWPHTBKIAT",timestamp="1567067659",
serial_no="1FB89742D19F2BD30B69948D16DECA0FCB4481EB",
signature="PB6M7+3JL7TSCl5zqD1sdWVypOIEQsD4dgOU+vPiVM6GMRo2qYSWKf8u46i9ZJFhyZTBdZ7SFR+BjDZh6
89hFgN8LZL+QWTvq3cse/FEUFYyOLN7L/2IZX4GA4cWInuJ2MpOhZRMpm+emrcn42gTMKAPNQ7dBLO7ux6MoSuQp69
PW+p1ogmkER68exTVUXYqA5P3vITlWNr++RDy2+ExvB7qVISOKW0vBkxUxN9e7hwUbDwGln170ZXomoO1KpQSbw3f1u
WUCx/IlWJhJIun7rUMtVT+kfijNUqcILtSfE4hWKKVaZn9j5CX8M7aKbbDOFy3SvbSJ3WQgRnRbgog5w=="
Content-Type: multipart/form-data;boundary="boundary"
4.添加body:
// 以下為body的內(nèi)容
--boundary // boundary為商戶(hù)自定義的一個(gè)字符串
Content-Disposition: form-data; name="meta";
Content-Type: application/json
//此處必須有一個(gè)空行
{ "filename": "filea.jpg", "sha256": " hjkahkjsjkfsjk78687dhjahdajhk " }
--boundary
Content-Disposition: form-data; name="file"; filename="filea.jpg";
Content-Type: image/jpg
//此處必須有一個(gè)空行
pic1 //pic1即為媒體圖片的二進(jìn)制內(nèi)容
--boundary--
說(shuō)明:請(qǐng)求包體每行結(jié)尾都需要包含\r\n(空行也需要)。
5.發(fā)送請(qǐng)求
POST /v3/merchant/media/upload HTTP/1.1
Host: api.mch.weixin.qq.com
Authorization: WECHATPAY2-SHA256-RSA2048
mchid="1900231671",nonce_str="PCHK6HSOEDTACETP6P3AL7DWPHTBKIAT",
timestamp="1567067659",
serial_no="1FB89742D19F2BD30B69948D16DECA0FCB4481EB",
signature="PB6M7+3JL7TSCl5zqD1sdWVypOIEQsD4dgOU+vPiVM6GMRo2qYSWKf8u46i9ZJFhyZTBdZ7
SFR+BjDZh689hFgN8LZL+QWTvq3cse/FEUFYyOLN7L/2IZX4GA4cWInuJ2MpOhZRMpm+emrcn42gTMKAPN
Q7dBLO7ux6MoSuQp69PW+p1ogmkER68exTVUXYqA5P3vITlWNr++RDy2+ExvB7qVISOKW0vBkxUxN9e
7hwUbDwGln170ZXomoO1KpQSbw3f1uWUCx/IlWJhJIun7rUMtVT+kfijNUqcILtSfE4hWKKVaZn9j5CX8M
7aKbbDOFy3SvbSJ3WQgRnRbgog5w=="
Content-Type: multipart/form-data;boundary=boundary
--boundary
Content-Disposition: form-data; name="meta";
Content-Type: application/json
{ "filename": "filea.jpg", "sha256": " hjkahkjsjkfsjk78687dhjahdajhk " }
--boundary
Content-Disposition: form-data; name="file"; filename="filea.jpg";
Content-Type: image/jpg
pic1
--boundary--
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
500 | SYSTEMERROR | 系統(tǒng)錯(cuò)誤 | 系統(tǒng)異常,請(qǐng)使用相同參數(shù)稍后重新調(diào)用 |
SYSTEMERROR | 文件系統(tǒng)錯(cuò)誤,請(qǐng)稍后重試 | 文件系統(tǒng)異常,請(qǐng)使用相同參數(shù)稍后重新調(diào)用 | |
400 | PARAM_ERROR | 圖片文件名稱(chēng)不正確,請(qǐng)檢查后重新提交 | 圖片文件名稱(chēng)不正確,只支持jpg,jpeg,png,bmp,請(qǐng)使用正確圖片文件重新調(diào)用 |
PARAM_ERROR | 文件二進(jìn)制內(nèi)容不是圖片,請(qǐng)檢查后重新提交 | 上傳文件二進(jìn)制內(nèi)容頭部不正確,只支持jpg,jpeg,png,bmp,請(qǐng)使用正確圖片文件重新調(diào)用 | |
PARAM_ERROR | 圖片sha256值有誤,請(qǐng)檢查后重新提交 | 圖片sha256值計(jì)算有誤,請(qǐng)檢查算法,重新計(jì)算后提交 | |
PARAM_ERROR | 文件大小不能超過(guò)2M,請(qǐng)檢查后重新提交 | 商戶(hù)更換文件或者對(duì)圖片進(jìn)行壓縮后,重新調(diào)用 | |
PARAM_ERROR | 文件為空,請(qǐng)檢查后重新提交 | 商戶(hù)更換文件后,重新調(diào)用 | |
429 | FREQUENCY_LIMIT_EXCEED | 操作過(guò)快,請(qǐng)稍后重試 | 請(qǐng)商戶(hù)降低每秒調(diào)用頻率 |
FREQUENCY_LIMIT_EXCEED | 當(dāng)天上傳文件數(shù)已達(dá)上限 | 請(qǐng)商戶(hù)降低每天調(diào)用頻率 | |
403 | NO_AUTH | 商戶(hù)權(quán)限異常 | 請(qǐng)確認(rèn)是否已經(jīng)開(kāi)通相關(guān)權(quán)限 |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP證