部分微信支付業(yè)務指定商戶需要使用圖片上傳 API來上報圖片信息，從而獲得必傳參數(shù)的值：圖片MediaID 。

# 接口說明

請求主體類型： multipart/form-data

# 字段說明

# 請求步驟

# 圖片上傳步驟

# 1. 創(chuàng)建一個POST的方法請求/upload URI

例如： POST https://api.mch.weixin.qq.com/v3/merchant/media/upload HTTP/1.1

# 2. 將文件的數(shù)據(jù)添加到請求主體

2.1. 圖片文件file參數(shù)的獲取方式說明：

媒體圖片二進制內(nèi)容，放在請求HTTP的body中。

2.2. 媒體文件元信息meta參數(shù)的獲取方式說明：

媒體文件元信息，使用json表示，包含兩個對象：filename、sha256。

• filename參數(shù)獲取方式說明：

商戶上傳的媒體圖片的名稱，商戶自定義，必須以JPG、BMP、PNG為后綴。

• sha256參數(shù)獲取方式說明：

圖片文件的文件摘要，即對圖片文件的二進制內(nèi)容進行sha256計算得到的值。

2.3. 簽名計算說明：

簽名生成 (opens new window)

參與簽名計算的請求主體為meta的json串：

{ "filename": "filea.jpg", "sha256": "hjkahkjsjkfsjk78687dhjahdajhk" }

待簽名串示例：

1POST
2/v3/merchant/media/upload
31566987169           //時間戳
412ced2db6f0193dda91ba86224ea1cd8   //隨機數(shù)
5{"filename":"filea.jpg","sha256":"hjkahkjsjkfsjk78687dhjahdajhk"}

# 3. 添加HTTP頭

1Content-Type：multipart/form-data.設置為要上載的對象的MIME媒體類型。
2Authorization: WECHATPAY2-SHA256-RSA2048 mchid="1900231671",
3nonce_str="PCHK6HSOEDTACETP6P3AL7DWPHTBKIAT",timestamp="1567067659",
4serial_no="1FB89742D19F2BD30B69948D16DECA0FCB4481EB",
5signature="PB6M7+3JL7TSCl5zqD1sdWVypOIEQsD4dgOU+vPiVM6GMRo2qYSWKf8u46i9ZJFhyZTBdZ7SFR+BjDZh6
689hFgN8LZL+QWTvq3cse/FEUFYyOLN7L/2IZX4GA4cWInuJ2MpOhZRMpm+emrcn42gTMKAPNQ7dBLO7ux6MoSuQp69
7PW+p1ogmkER68exTVUXYqA5P3vITlWNr++RDy2+ExvB7qVISOKW0vBkxUxN9e7hwUbDwGln170ZXomoO1KpQSbw3f1u
8WUCx/IlWJhJIun7rUMtVT+kfijNUqcILtSfE4hWKKVaZn9j5CX8M7aKbbDOFy3SvbSJ3WQgRnRbgog5w=="
9Content-Type: multipart/form-data;boundary=boundary

# 4. 添加body

1// 以下為body的內(nèi)容
2--boundary  // boundary為商戶自定義的一個字符串
3Content-Disposition: form-data; name="meta";
4Content-Type: application/json
5//此處必須有一個空行
6{ "filename": "filea.jpg", "sha256": "hjkahkjsjkfsjk78687dhjahdajhk" }
7--boundary
8Content-Disposition: form-data; name="file"; filename="filea.jpg";
9Content-Type: image/jpg
10//此處必須有一個空行
11pic1  //pic1即為媒體圖片的二進制內(nèi)容
12--boundary--

# 5.發(fā)送請求

1POST /v3/merchant/media/upload HTTP/1.1
2Host: api.mch.weixin.qq.com
3Authorization: WECHATPAY2-SHA256-RSA2048 
4mchid="1900231671",nonce_str="PCHK6HSOEDTACETP6P3AL7DWPHTBKIAT",
5timestamp="1567067659",
6serial_no="1FB89742D19F2BD30B69948D16DECA0FCB4481EB",
7signature="PB6M7+3JL7TSCl5zqD1sdWVypOIEQsD4dgOU+vPiVM6GMRo2qYSWKf8u46i9ZJFhyZTBdZ7
8SFR+BjDZh689hFgN8LZL+QWTvq3cse/FEUFYyOLN7L/2IZX4GA4cWInuJ2MpOhZRMpm+emrcn42gTMKAPN
9Q7dBLO7ux6MoSuQp69PW+p1ogmkER68exTVUXYqA5P3vITlWNr++RDy2+ExvB7qVISOKW0vBkxUxN9e
107hwUbDwGln170ZXomoO1KpQSbw3f1uWUCx/IlWJhJIun7rUMtVT+kfijNUqcILtSfE4hWKKVaZn9j5CX8M
117aKbbDOFy3SvbSJ3WQgRnRbgog5w=="
12Content-Type: multipart/form-data;boundary=boundary
13
14--boundary  
15Content-Disposition: form-data; name="meta";
16Content-Type: application/json
17
18{ "filename": "filea.jpg", "sha256": "hjkahkjsjkfsjk78687dhjahdajhk" }
19--boundary
20Content-Disposition: form-data; name="file"; filename="filea.jpg";
21Content-Type: image/jpg
22
23pic1
24--boundary--

# 錯誤碼