开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
支付产品
私域产品
小程序产品
权限集列表
搜索关键词
搜索直达
收藏
消息
小程序码
小程序服务
订单中心
小程序开发管理
接入指南
api 列表
隐私信息授权
小程序基础信息
小程序开发版本
小程序应用成员
个体账户
小程序类目
小程序二维码
代创建小程序
小程序域名
插件管理
小程序备案
生物核身
交易组件
小程序商品
支付有礼
商家粉丝群
营销产品
资金产品
会员产品
信用产品
广告产品
开发 > 服务端 > 私域产品 > 小程序产品 > 权限集列表 > 小程序开发管理 >  >  > 小程序备案文件材料上传接口
已更新
文档更新记录 >
收藏
订阅更新
我的文档
设置
接入检测
即可查看检测结果)
若有未通过的接入检测项,接口将无法调通
备案前,需要收集商户的各类材料,通过小程序备案文件材料上传接口上传,上传成功后记录返回的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以下)。

公共请求参数

参数类型是否必选最大长度描述示例值
app_idstring必选32
支付宝分配给开发者的应用id
2014072300007148
methodstring必选128
接口名称
alipay.open.mini.icp.media.upload
formatstring可选40
仅支持json
json
charsetstring必选10
请求使用的编码格式,如utf-8,gbk,gb2312等
utf-8
sign_typestring必选10
商户生成签名字符串所使用的签名算法类型,目前支持rsa2和rsa,推荐使用rsa2
rsa2
signstring必选344
商户请求参数的签名串,详见签名
详见示例
timestampstring必选19
发送请求的时间,格式"yyyy-mm-dd hh:mm:ss"
2014-07-24 03:07:50
versionstring必选3
调用的接口版本,固定为:1.0
1.0
app_auth_tokenstring可选40

业务请求参数

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' 
说明:本示例仅供参考。

公共响应参数

参数类型是否必选最大长度描述示例值
codestring必选-
网关返回码,
40004
msgstring必选-
网关返回码描述,
business failed
sub_codestring可选-
业务返回码,参见具体的api接口文档
acq.trade_has_success
sub_msgstring可选-
业务返回码描述,参见具体的api接口文档
交易已被支付
signstring必选-
签名,
dzxh8eetuahoye3w1j poiphfdxoybfunn1lket/v7p4zjdyojwea6izs6hz0ydw5cp/viufub5i0/v5wens3oyr8zredqo6d futdlhdc efyckiqhbxizgngpdpdfp1pis7bdhhzrszhbrqb7o4k3dxc aanfauu4v6zdwczo=

业务响应参数

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图片文件上传失败
请查看失败原因,上传符合要求的图片
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 2022 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
为开发者能享受更简单的协议处理逻辑、更丰富的开源工具配套、更低的接口响应时延,支付宝开放平台推出符合oas3.0规范的,助力开发体验。新版本文档请点击“查看v3版本”进行访问。
网站地图