| 接口名称 | image_upload |
|---|---|
| 是否幂等 | 否 |
| 接口模式 | 直连 |
| 异步通知 | 否 |
应用场景：
商户上传反馈图片的接口。 将媒体图片进行二进制转换，得到的媒体图片二进制内容，在请求body中上传此二进制内容。 媒体图片只支持jpg、png、bmp格式，文件大小不能超过2M。
接口参数
- 请求：
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 代理商商户号 | agentMerId | 否 | S(16) | 100000 | 宝付支付分配的商户号 |
| 代理商终端号 | agentTerId | 否 | S(16) | 100000 | 宝付支付分配的终端号 |
| 交易商户号 | merId | 是 | S(16) | 100000 | 宝付支付分配的商户号 |
| 交易终端号 | terId | 是 | S(16) | 100000 | 宝付支付分配的终端号 |
| 商户识别码 | subMchId | 否 | S(30) | 微信/支付宝分配的商户识别码 | |
| 图片信息 | imageInfo | 是 | 图片信息 |
- 微信图片信息:
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 图片流 | file | 是 | S | iVBORw0KGgoAAAANSUhEUgAAAAoAAAAKCAYAAAC | 图片上传类型为：WECHAT，必填 将媒体图片进行二进制转换，得到的媒体图片二进制内容，在请求body中上传此二进制经Base64编码内容。媒体图片只支持JPG、BMP、PNG格式，文件大小不能超过2M |
| 媒体文件元信息 | images_meta | 是 | 图片上传类型为：WECHAT，必填 媒体文件元信息，使用json表示，包含两个对象：filename、sha256 |
||
| - 文件名称 | file_name | 是 | S(128) | filea.jpg | 商户上传的媒体图片的名称，商户自定义，必须以jpg、png、bmp为后缀。 |
| - 文件摘要 | sha256 | 是 | C | hjkahkjsjkfsjk78687dhjahdajhk | 图片文件的文件摘要，即对图片文件的二进制内容进行sha256计算得到的值。 |
- 支付宝图片信息:
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 图片/视频格式 | image_type | 是 | S(16) | jpg | 图片格式，支持格式：bmp、jpg、jpeg、png、gif. |
| 文件名称 | file_name | 是 | S(128) | filea.jpg | 商户上传的媒体图片的名称，商户自定义，必须以bmp、jpg、jpeg、png、gif为后缀。 |
| 图片流 | image_content | 是 | C | 图片二进制字节流经过Base64编码，图片字节流最大为10M byte数组最大长度 10485750 |
- 返回
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 代理商商户号 | agentMerId | 否 | S(16) | 100000 | 宝付支付分配的商户号 |
| 代理商终端号 | agentTerId | 否 | S(16) | 100000 | 宝付支付分配的终端号 |
| 商户号 | merId | 是 | S(16) | 100000 | 宝付支付分配的商户号 |
| 终端号 | terId | 是 | S(16) | 100000 | 宝付支付分配的终端号 |
| 媒体文件标识 ID | mediaId | 否 | S(512) | BB04A5DEEFEA18D4F2554C1EDD3B610B.bmp | |
| 业务结果 | resultCode | 是 | S(16) | SUCCESS | 业务处理结果 |
| 错误代码 | errCode | 否 | S(32) | 当业务结果FAIL时，返回错误代码 | |
| 错误描述 | errMsg | 否 | S(128) | 当业务结果为FAIL时，返回错误描述 |
作者：郑成定 创建时间：2026-05-22 15:07
最后编辑：郑成定 更新时间：2026-09-17 19:13
最后编辑：郑成定 更新时间：2026-09-17 19:13
