通用场景
备案前,需要收集商户的各类材料,通过小程序备案文件材料上传接口上传,上传成功后记录返回的media_id,作为后续提交备案中的入参。
具体需要的材料可见:支付宝小程序备案操作指引-备案材料准备
关于材料上传接口的几点说明:
1、最常见的情况为,
(1)商户为一般企业或者个体工商户
(2)小程序所经营的内容不包含出版、教育、医疗保健、药品和医疗器械、文化、广播电影电视节目、新闻、网络预约车、互联网金融、校外培训(高中及以下阶段)、宗教等需要前置审批项的内容
(3)商户主体负责人和商户小程序负责人为同一人
则需要准备的商户材料有,营业执照、法人身份证正反面即可。
若商户的基本情况不在上述范围内,则需要按照实际情况进行材料的准备及上传。
2、上传材料的要求
(1)上传的材料要求目前均为图片
(2)对于图片的要求为:
图片类别 图片格式 图片尺寸 图片大小 图片其他要求
营业执照 jpg、jpeg、png 不低于1100*1500或者1500*1100 2m 彩色并在有效期内
身份证 jpg、jpeg、png 不低于720*1280或者1280*720 2m 彩色并在有效期内
其他业务图片 jpg、jpeg、png 无 2m 无
(3)图片的逻辑说明:
● 工信部对图片大小要求为营业执照和身份证需要在100~200kb之间,其他材料需要在200kb以下。为便捷服务商上传材料,调用小程序备案文件材料上传接口后,系统会有自动的图片大小压缩处理机制,该机制在2m以下压缩效果最好,所以建议服务商上传的材料大小控制在2m以下。
● 接口本身并没有限制2m以上的图片上传,5m以内的图片均可通过接口上传,但压缩大小至工信部系统要求(100~200kbor200kb以下)失败的几率会相对较高,服务商也可以进行尝试。
● 当接口返回“file_size_illegal图片文件大小不符合要求”报错时,代表图片压缩处理失败,此时服务商可以重新拍摄证照或者压缩图片后进行上传;亦可直接压缩到工信部的要求,身份证和营业执照(100~200kb之间),其他材料(200kb以下)。
具体需要的材料可见:支付宝小程序备案操作指引-备案材料准备
关于材料上传接口的几点说明:
1、最常见的情况为,
(1)商户为一般企业或者个体工商户
(2)小程序所经营的内容不包含出版、教育、医疗保健、药品和医疗器械、文化、广播电影电视节目、新闻、网络预约车、互联网金融、校外培训(高中及以下阶段)、宗教等需要前置审批项的内容
(3)商户主体负责人和商户小程序负责人为同一人
则需要准备的商户材料有,营业执照、法人身份证正反面即可。
若商户的基本情况不在上述范围内,则需要按照实际情况进行材料的准备及上传。
2、上传材料的要求
(1)上传的材料要求目前均为图片
(2)对于图片的要求为:
图片类别 图片格式 图片尺寸 图片大小 图片其他要求
营业执照 jpg、jpeg、png 不低于1100*1500或者1500*1100 2m 彩色并在有效期内
身份证 jpg、jpeg、png 不低于720*1280或者1280*720 2m 彩色并在有效期内
其他业务图片 jpg、jpeg、png 无 2m 无
(3)图片的逻辑说明:
● 工信部对图片大小要求为营业执照和身份证需要在100~200kb之间,其他材料需要在200kb以下。为便捷服务商上传材料,调用小程序备案文件材料上传接口后,系统会有自动的图片大小压缩处理机制,该机制在2m以下压缩效果最好,所以建议服务商上传的材料大小控制在2m以下。
● 接口本身并没有限制2m以上的图片上传,5m以内的图片均可通过接口上传,但压缩大小至工信部系统要求(100~200kbor200kb以下)失败的几率会相对较高,服务商也可以进行尝试。
● 当接口返回“file_size_illegal图片文件大小不符合要求”报错时,代表图片压缩处理失败,此时服务商可以重新拍摄证照或者压缩图片后进行上传;亦可直接压缩到工信部的要求,身份证和营业执照(100~200kb之间),其他材料(200kb以下)。
公共请求参数
业务请求参数
file_content|文件材料二进制信息必选byte[][1,5242880]
【描述】文件材料信息,不同的文件类型的材料文件对应的格式要求不一致。具体如下:
● 图片格式仅支持,jpg、jpeg、png
● 营业执照要求:图片大小不低于100k不超过2m,分辨率不低于1100*1500或者1500*1100,必须为彩色,需要在有效期内;
● 身份证照片要求:图片大小不低于100k不超过2m,分辨率不低于720*1280或者1280*720,必须为彩色,需要在有效期内
● 其他附件类型的图片要求不大于2m即可
【示例值】二进制信息
file_type|文件类型可选string[1,25]
【描述】文件材料的文件类型,身份证,营业执照,其他附件等
【枚举值】
营业执照: business_license
身份证: id_card
其他附件: mini_program_attachment
【注意事项】文件材料分为营业执照、身份证、其他三种类型。具体要求在功能描述中已进行详细叙述,在上传营业执照、身份证时,类型必传,不传入则默认其他附件类型。
【示例值】business_license
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.mini.icp.media.upload&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'file_content=@/home/admin/test.jpg' \
-f 'file_type=business_license'
说明:本示例仅供参考。
公共响应参数
业务响应参数
media_id|小程序备案文件材料凭证id可选string(48)
【描述】申请备案时填写的文件材料凭证id
【注意事项】记录入参file_type对应的文件材料凭证id的映射关系,用于申请备案时使用,如果申请备案填写错误有可能会被驳回
【示例值】cjo4szfm3xcaaaaaaaaaaaaadhowaabr
响应示例
正常示例
异常示例
{
"alipay_open_mini_icp_media_upload_response": {
"code": "10000",
"msg": "success",
"media_id": "cjo4szfm3xcaaaaaaaaaaaaadhowaabr"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}
说明:本示例仅供参考。
公共错误码
业务错误码
错误码 | 错误描述 | 凯发app官方网站的解决方案 |
---|---|---|
system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常,导致服务调用失败,商户可以用同样的请求发起重试 |
invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息,修改参数后进行重试 |
application_type_error | 应用类型不是小程序 | 请检查应用类型是否是小程序 |
file_content_is_error | 文件内容错误 | 请上传符合要求的二进制文件 |
file_parse_fail | 图片文件解析失败 | 请重新上传文件进行充实 |
file_upload_fail | 图片文件上传失败 | 请查看失败原因,上传符合要求的图片 |