图片上传接口用于上传商户进件所需的证件图片（如身份证、营业执照、银行卡等），上传成功后返回图片唯一标识ID。该ID在商户进件申请接口中用于传递证件图片信息。
【POST】/pay/applyment/upload
Content-Type: multipart/form-data
| 参数 | 必填 | 类型 | 说明 | 示例值 |
|---|
| file | 是 | File | 图片文件，支持jpg、jpeg、png格式，大小不超过5MB | - |
| image_type | 是 | String(32) | 图片类型，取值与 submit 接口字段对应
BUSINESS_LICENSE_PIC 营业执照照片
ID_DOC_FRONT 证件正面照（身份证人像面）
ID_DOC_BACK 证件反面照（身份证国徽面）
BANK_ACCOUNT_PIC 银行账户证明（开户证明/银行卡正面）
STORE_ENTRANCE_PIC 门店门头照片
INDOOR_PIC 门店内部照片
CASHIER_PIC 收银台照片
LEGAL_PERSON_COMMITMENT 法定代表人开户承诺函
ICP_LICENSE_PIC ICP 许可证或公众号主体信息截图
WEB_AUTHORISATION 网站授权函
QUALIFICATIONS 特殊资质照片
OTHER 其他 | ID_DOC_FRONT |
const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('image_type', 'ID_DOC_FRONT');
fetch('/pay/applyment/upload', {
method: 'POST',
body: formData
})
.then(response => response.json())
.then(data => {
console.log('media_id:', data.media_id);
});
| 参数 | 必填 | 类型 | 说明 | 示例值 |
|---|
| code | 是 | String(32) | 返回码，000000 表示成功 | 000000 |
| message | 是 | String(128) | 返回信息 | 上传成功 |
| media_id | 是 | String(64) | 图片唯一标识 ID，在 submit/modify 接口中作为对应字段的值传入 | media_id_doc_front |
{
"code": "000000",
"message": "上传成功",
"media_id": "media_id_doc_front"
}
| 错误码 | 说明 |
|---|
| 000000 | 成功 |
| FAIL | 失败 |
| MEDIA_FORMAT_ERROR | 图片格式错误，仅支持 jpg、jpeg、png |
| MEDIA_SIZE_EXCEED | 图片大小超过 5MB 限制 |
| MEDIA_TYPE_ERROR | image_type 参数错误 |
- 图片文件必须为 jpg、jpeg 或 png 格式
- 单个图片文件大小不超过 5MB
image_type 取值与 submit 接口字段一一对应，便于前端上传时与进件表单字段绑定- 返回的
media_id 需在 24 小时内于 submit/modify 接口中使用，超时可能被清理