Login expired. Please log in again.

Feedback

0/300

Feedback

Submitted successfully

ok

Feedback

Network exception, please try again later

ok

上传文件API

公共API
上传文件
联系我们
联系我们

上传文件API

最新更新时间:2022.05.11 版本说明


部分微信支付境外业务指定商户需要上传文件资料,可使用本API来提交资料,获取其他业务API所需的FileID值。

注意:

• 微信侧未成功的分账单不会出现在对账单中;

• 对账单中涉及金额的字段单位为“元”。

接口说明

适用对象:直连模式 机构模式

请求URL:https://api.mch.weixin.qq.com/v3/global/merchant-storage/file/upload

请求主体类型:multipart/form-data

请求方式:POST


path 指该参数为路径参数

query 指该参数为URL参数

body 指该参数需在请求JSON传参


请求参数

参数名 变量 类型[长度限制] 必填 描述
+ 文件信息 file object body将文件进行二进制转换,得到的二进制内容,在请求body中上传此二进制内容。文件支持PDF、JPG、BMP、PNG格式,文件大小不能超过5M。
参数名 变量 类型[长度限制] 必填 描述
文件名 filename string 由表单上传的文件部分的文件名
文件类型 content_type string 表示上传文件的 Content-Type
文件内容 content string 一个二进制串表示上传文件的整体内容
+ 文件元信息 meta object body文件元信息,使用json表示,包含两个对象:filename、digest
参数名 变量 类型[长度限制] 必填 描述
文件名称 filename string[1, 256] 商户上传文件的名称,商户自定义,必须以PDF、JPG、BMP、PNG为后缀。
示例值:verify.pdf
文件摘要 digest string[64, 64] 文件摘要,即对上传文件的二进制内容进行sha256计算得到的值。
示例值:ff3f4036a1164d1ddbad5b3edf9022addb3e1961a54a922708a6c1ffc49e5489

各语言请求示例

---示例代码待更新---

返回参数

参数名 变量 类型[长度限制] 必填 描述
文件标识ID file_id string[16, 64] 微信返回的文件标识ID
示例值:b6a17e2a-1dc4-4376-8630-e73d06490c0d

返回示例


{
  "file_id": "b6a17e2a-1dc4-4376-8630-e73d06490c0d"
}
                    

http://2323weixin.qq.com
                    

请求步骤

1.创建一个POST方法请求

例如:


POST https://apihk.mch.weixin.qq.com/v3/global/merchant-storage/file/upload HTTP/1.1
                    

2.将文件的数据添加到请求主体

2.1 文件信息file参数的获取方式说明:
将文件进行二进制转换,得到的二进制内容, 放在请求http的body中。


2.2 文件元信息meta参数的获取方式说明:
文件元信息,使用json表示,包含两个对象:filename、digest。
● filename参数获取方式说明:
商户上传文件的名称,商户自定义,必须以PDF、JPG、BMP、PNG为后缀。
● digest参数获取方式说明:
文件摘要,即对上传文件的二进制内容进行sha256计算得到的值。


2.3 签名计算说明:
签名生成
参与签名计算的请求主体为meta的json串:
​ {"filename": "file1.pdf", "sha256": "hjkahkjsjkfsjk78687dhjahdajhk"}


待签名串示例:

POST
/v3/global/merchant-storage/file/upload
1566987169           // 时间戳
12ced2db6f0193dda91ba86224ea1cd8   // 随机数
{"filename": "file1.pdf", "sha256": "hjkahkjsjkfsjk78687dhjahdajhk"} 

3.添加HTTP头:


Content-Type:multipart/form-data.设置为要上载的对象的MIME媒体类型。
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的内容
--boundary  // boundary为商户自定义的一个字符串
Content-Disposition: form-data; name="meta";
Content-Type: application/json
//此处必须有一个空行
{"filename": "file1.pdf", "sha256": "hjkahkjsjkfsjk78687dhjahdajhk"} 
--boundary
Content-Disposition: form-data; name="file"; filename="file1.pdf";
Content-Type: application/pdf
//此处必须有一个空行
context123    //context123即为所要上传文件的二进制内容
--boundary--

说明:请求包体每行结尾都需要包含\r\n(空行也需要)。


5.发送请求


POST /v3/global/merchant-storage/file/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": "file1.pdf", "sha256": "hjkahkjsjkfsjk78687dhjahdajhk"} 
--boundary
Content-Disposition: form-data; name="file"; filename="file1.pdf";
Content-Type: application/pdf

context123
--boundary--

错误码

状态码 错误码 描述 解决方案
400 INVALID_REQUEST 上传文件的文件大小不能超过5M,请检查所传字段(content)的大小 请更换文件或者对文件进行压缩后,重新调用
400 INVALID_REQUEST 上传文件的内容经过sha256加密算法计算后的值和所传字段(digest)的值不一致,请检查所传字段(digest)的计算方式 请参考指引,检查所传字段(digest)的计算方式
400 INVALID_REQUEST 上传文件的文件类型暂时不支持 请检查所传字段(content_type)是否在pdf, jpg, bmp, png中




版本说明

关闭
V1.0
2022年05月11日
上传文件API接口上线

About  WeChat  Pay

Powered By Tencent & Tenpay Copyright©

2005-2024 Tenpay All Rights Reserved.

Contact Us
Wechat Pay Global

WeChat Pay Global