通用场景
1、调用该接口之前，请先完成主账号人脸核身，以及上传所有需要用到的附件材料。
2、接口包含了三大块的内容，小程序主体信息、小程序信息、小程序负责人信息。
3、其余内容请仔细阅读，小程序备案openapi接口使用指南中，备案提交章节中的内容。
2、接口包含了三大块的内容，小程序主体信息、小程序信息、小程序负责人信息。
3、其余内容请仔细阅读，小程序备案openapi接口使用指南中，备案提交章节中的内容。
公共请求参数
业务请求参数
icp_subject｜小程序主体信息必选icpsubjectinfo
【描述】小程序备案主体信息
certify_id｜小程序主账号人脸核验凭证certify_id必选string[1,128]
【描述】小程序主账号人脸核验凭证certify_id（参考：发起小程序备案人脸核验接口）
【注意事项】人脸核验凭证certify_id ，有效期为3天，超期会报错；人脸核验状态需要为“success”，非该状态系统会进行报错。
【示例值】5df6g7g88d6d56v7g88g9gud
province｜小程序备案省份代码必选string[1,10]
【描述】备案省份，使用省份代码(参考：获取区域信息的接口)
【注意事项】可前往小程序备案openapi接口使用指南中，第四部分先行下载表格，代码查询接口将在后续进行提供。
【示例值】110000
city｜小程序备案城市代码必选string[1,10]
【描述】备案城市，使用城市代码（参考：获取区域信息的接口）
【注意事项】可前往小程序备案openapi接口使用指南中，第四部分先行下载表格，代码查询接口将在后续进行提供。
【示例值】110100
district｜小程序备案县区代码必选string[1,10]
【描述】备案县区，使用县区代码（参考：获取区域信息的接口）
【注意事项】可前往小程序备案openapi接口使用指南中，第四部分先行下载表格，代码查询接口将在后续进行提供。
【示例值】110105
type｜主体单位性质必选string[1,16]
【描述】主体单位性质(参考：获取单位性质的接口)
【注意事项】可前往小程序备案openapi接口使用指南中，第四部分先行下载表格，代码查询接口将在后续进行提供。
【示例值】5
certificate_address｜主体证件注册地必选string[1,128]
【描述】主体证件注册地
【注意事项】主体为个人的情况下，填写的是个人证件住所；主体为非个人的情况下填写的是单位证件的住所。
【示例值】北京市朝阳区高碑店路181号1栋12345室
address｜主体详细地址必选string[1,128]
【描述】主体详细地址
【注意事项】主体为个人的情况下，填写的是个人通讯地址；主体为非个人的情况下填写的是单位详细地址。
地址需要精确到具体门牌号，省、市、区无需重复填写。若所填写地址无门牌号且已是最详细地址，请在主办单位备注信息comment说明情况
【示例值】光明嘉园1号楼2单元203
directer_certificate_type｜主体负责人证件类型必选string[1,16]
【描述】主体负责人证件类型(参考：获取证件类型接口)
【注意事项】可前往小程序备案openapi接口使用指南中，第四部分先行下载表格，代码查询接口将在后续进行提供。
【示例值】5
directer_certificate_photo_front｜主体负责人证件正面材料凭证必选string[1,128]
【描述】主体负责人证件正面材料凭证media_id（参考：备案文件材料上传接口）
【注意事项】如果证件类型为居民身份证类型则表示正面，如果是其他的证件类型直接使用该字段directer_certificate_photo_front
【示例值】7dsyh8ifasfjkkli908uk
directer_name｜主体负责人姓名必选string[1,16]
【描述】主体负责人姓名
【示例值】张三
directer_certificate_number｜主体负责人证件号码必选string[1,64]
【描述】主体负责人证件号码
【示例值】110000000000000000
contact_phone_number｜主体联系人手机号必选string[1,16]
【描述】主体联系人手机号
【示例值】13000000000
contact_emergency_phone_number｜主体联系人应急手机号必选string[1,16]
【描述】主体联系人应急手机号
【示例值】13000000000
contact_email｜主体联系人邮箱必选string[1,32]
【描述】主体联系人邮箱
【示例值】1234@alitest.com
certificate_type｜主体证件类型可选string[1,16]
【描述】主体证件类型，示例值：2(参考：获取证件类型接口)
【注意事项】主体为个人的情况下非必选，主体为非个人的情况下必选
可前往小程序备案openapi接口使用指南中，第四部分先行下载表格，代码查询接口将在后续进行提供。
【示例值】2
certificate_photo｜主体证件材料凭证media_id可选string[1,128]
【描述】主体证件材料凭证media_id（参考：备案文件材料上传接口）
【注意事项】主体为个人的情况下非必选，主体为非个人的情况下必选
【示例值】4y5i7ufasfjkkli908uk
name｜主体单位名称可选string[1,128]
【描述】主体单位名称
【注意事项】主体为个人的情况下非必选，主体为非个人的情况下必选。填写的单位名称要与主体证件中的单位名称一致，否则提交备案失败
【示例值】李四的公司
certificate_number｜主体证件号码可选string[1,128]
【描述】主体证件号码
【注意事项】主体为个人的情况下非必选，主体为非个人的情况下必选。填写的证件编号要与主体证件中的证件编号一致，否则提交备案失败
【示例值】110000000000000000
comment｜主体备注信息可选string[1,128]
【描述】主体备注信息
【示例值】备注1
attachement_materials｜主体附件文件材料凭证可选array[1,10]
【描述】主体单位主体附件材料凭证media_id（参考：备案文件材料上传接口）
【示例值】["yhfdderttyuimng45yghu8uj","rr889tyghjiijhgy78j"]
directer_certificate_photo_back｜主体负责人证件反面材料凭证可选string[1,128]
【描述】主体负责人证件反面材料凭证media_id（参考：备案文件材料上传接口）
【注意事项】如果证件类型为居民身份证类型则表示反面，如果是其他的证件类型直接使用该字段directer_certificate_photo_front
【示例值】6giu8bj42lihbfesvu
directer_certificate_validate_start｜主体负责人证件有效期起始日期可选string[1,16]
【描述】主体负责人证件有效期起始日期，格式为 yyyy-mm-dd
【注意事项】当负责人证件为身份证时，有效期必填；其余证件类型，可不填写
【示例值】2003-08-15
directer_certificate_validate_end｜主体负责人证件有效期结束日期可选string[1,16]
【描述】主体负责人证件有效期结束日期
【注意事项】主体负责人证件有效期结束日期，格式为 yyyy-mm-dd
如果是长期有效，填写长期
当负责人证件为身份证时，有效期必填；其余证件类型，可不填写
【示例值】长期
authorization_material｜主体负责人法人授权书材料凭证可选string[1,128]
【描述】主体负责人法人授权书材料凭证media_id（参考：备案文件材料上传接口）
【注意事项】当主体单位证件类型为营业执照，主体负责人证件为身份证时，法人姓名不一致，且地区支持法定代表人授权时需要填写
【示例值】445667thhiygfd23t5jffdertr
icp_applets｜小程序备案小程序信息必选icpappletsinfo
【描述】小程序备案小程序信息
icp_audit_infos｜小程序前置审批项信息必选array
【描述】小程序前置审批项信息
【注意事项】小程序前置审批项，列表中不能存在重复的前置审批类型audit_type，如不涉及前置审批项，也需要填“以上都不涉及
audit_type｜小程序前置审批项类型必选string[1,16]
【描述】小程序前置审批项类型（参考：获取小程序前置审批项接口）
【注意事项】当小程序提供出版、教育、医疗保健、药品和医疗器械、文化、广播电影电视节目、新闻、网络预约车、互联网金融、校外培训（高中及以下阶段）、宗教等内容服务时请选择提供
如果不需要提供时，填写“以上都不涉及”
可前往小程序备案openapi接口使用指南中，第四部分先行下载表格，代码查询接口将在后续进行提供。
【示例值】以上都不涉及
audit_number｜小程序前置审批项号可选string[1,128]
【描述】小程序前置审批号
【注意事项】当小程序提供出版、教育、医疗保健、药品和医疗器械、文化、广播电影电视节目、新闻、网络预约车、互联网金融、校外培训（高中及以下阶段）、宗教等内容服务时请选择提供
如果前置审批类型不是“以上都不涉及”，则必填
【示例值】豫-45678号
audit_material｜小程序前置审批文件材料凭证可选string[1,128]
【描述】小程序前置审批文件材料凭证media_id（参考：备案文件材料上传接口）
【注意事项】当小程序提供出版、教育、医疗保健、药品和医疗器械、文化、广播电影电视节目、新闻、网络预约车、互联网金融、校外培训（高中及以下阶段）、宗教等内容服务时请选择提供 如果前置审批类型不是“以上都不涉及”，则必填
【示例值】5t7899yhhuyuihgf79hhj
comment｜小程序备注必选string[20,200]
【描述】小程序备注
【注意事项】请具体描述小程序实际经营内容、主要服务内容，该信息为主管部门审核重要依据，请认真填写。如果小程序不涉及前置审批项，则在备注的最后加上，“该小程序不涉及前置审批项”
【示例值】该小程序为*****（对象）提供********（功能详情）服务
main_category_id｜服务内容标识可选string[1,64]
【描述】小程序服务内容标识（参考：获取服务内容标识的接口）
【注意事项】小程序服务内容标识，示例值："xs1014_xs2119"，多级类目使用"_"进行分割
如果小程序没有类目的情况下必填
【示例值】xs1014_xs2119
attachement_materials｜小程序附件材料凭证可选array[1,10]
【描述】小程序附件材料凭证media_id（参考：备案文件材料上传接口）
【示例值】["56ytfffyhffr567hbfy","ffyuu7644tghjjyrtrfttnnjkk"]
icp_applets_principal_info｜小程序备案小程序负责人信息必选icpappletsprincipalinfo
【描述】小程序备案小程序负责人信息
certificate_type｜小程序负责人证件类型必选string[1,16]
【描述】小程序负责人证件类型（参考：获取证件类型的接口）
【注意事项】可前往小程序备案openapi接口使用指南中，第四部分先行下载表格，代码查询接口将在后续进行提供。
【示例值】5
certificate_photo_front｜小程序负责人证件正面材料凭证必选string[1,128]
【描述】小程序负责人证件正面文件材料凭证media_id（参考：备案文件材料上传接口）
【示例值】tijgfrtjjnnkjhgf
name｜小程序负责人姓名必选string[1,16]
【描述】小程序负责人姓名
【示例值】张三
certificate_number｜小程序负责人证件号码必选string[1,64]
【描述】小程序负责人证件号码
【示例值】11000000000000000
contact_phone_number｜小程序联系人手机号必选string[1,16]
【描述】小程序联系人手机号
【示例值】13000000000
contact_emergency_phone_number｜小程序联系人应急手机号必选string[1,16]
【描述】小程序联系人应急手机号
【示例值】13000000000
contact_email｜小程序联系人邮箱必选string[1,32]
【描述】小程序联系人邮箱
【示例值】1234@alitest.com
certificate_photo_back｜小程序负责人证件反面材料凭证可选string[1,128]
【描述】小程序负责人证件反面文件材料凭证media_id（参考：备案文件材料上传接口）
【注意事项】如果证件类型为居民身份证类型则表示反面，如果是其他的证件类型直接使用该字段certificate_photo_front
【示例值】5t7854htjjktdggth
certificate_validate_start｜小程序负责人证件有效期起始日期可选string[1,16]
【描述】小程序负责人证件有效期起始日期，格式为 yyyy-mm-dd
【注意事项】当负责人证件为身份证时，有效期必填；其余证件类型，可不填写
【示例值】2023-08-15
certificate_validate_end｜小程序负责人证件有效期结束日期可选string[1,16]
【描述】小程序负责人证件有效期结束日期，格式为 yyyy-mm-dd
如果是长期有效，填写"长期"
【注意事项】当负责人证件为身份证时，有效期必填；其余证件类型，可不填写
【示例值】长期
commit_letter_materials｜互联网承诺书文件材料凭证可选array[0,1]
【描述】互联网承诺书文件材料凭证media_id（参考：备案文件材料上传接口）
【注意事项】一般情况下由系统自动生成，无需传入，但备案地为广东省时，需要下载"小程序备案者承诺书模版（广东省）"，手动填写后，拍照上传文件材料上传接口获取对应的media_id
【示例值】["56thhjku75thhgffyknhu890y"]
authorization_materials｜小程序负责人授权书可选array[0,1]
【描述】小程序负责人授权书
【注意事项】不同省份对于小程序负责人非法人的情况下，需要用户上传小程序负责人授权书
【示例值】["sfs5s6d7s7d7sdfs7f7sd7f"]
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.mini.icp.apply&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'biz_content={
"icp_applets_principal_info":{
"certificate_validate_end":"长期",
"certificate_photo_front":"tijgfrtjjnnkjhgf",
"commit_letter_materials":[
"56thhjku75thhgffyknhu890y"
],
"authorization_materials":[
"sfs5s6d7s7d7sdfs7f7sd7f"
],
"contact_phone_number":"13000000000",
"certificate_photo_back":"5t7854htjjktdggth",
"name":"张三",
"certificate_type":"5",
"certificate_number":"11000000000000000",
"certificate_validate_start":"2023-08-15",
"contact_emergency_phone_number":"13000000000",
"contact_email":"1234@alitest.com"
},
"icp_applets":{
"attachement_materials":[
"56ytfffyhffr567hbfy",
"ffyuu7644tghjjyrtrfttnnjkk"
],
"icp_audit_infos":[
{
"audit_number":"豫-45678号",
"audit_material":"5t7899yhhuyuihgf79hhj",
"audit_type":"以上都不涉及"
}
],
"comment":"该小程序为*****（对象）提供********（功能详情）服务",
"main_category_id":"xs1014_xs2119"
},
"icp_subject":{
"certify_id":"5df6g7g88d6d56v7g88g9gud",
"directer_certificate_number":"110000000000000000",
"address":"光明嘉园1号楼2单元203",
"city":"110100",
"certificate_photo":"4y5i7ufasfjkkli908uk",
"directer_certificate_validate_start":"2003-08-15",
"contact_phone_number":"13000000000",
"directer_certificate_type":"5",
"directer_certificate_photo_back":"6giu8bj42lihbfesvu",
"type":"5",
"authorization_material":"445667thhiygfd23t5jffdertr",
"certificate_number":"110000000000000000",
"contact_emergency_phone_number":"13000000000",
"contact_email":"1234@alitest.com",
"attachement_materials":[
"yhfdderttyuimng45yghu8uj",
"rr889tyghjiijhgy78j"
],
"directer_certificate_photo_front":"7dsyh8ifasfjkkli908uk",
"directer_name":"张三",
"province":"110000",
"district":"110105",
"name":"李四的公司",
"comment":"备注1",
"certificate_type":"2",
"directer_certificate_validate_end":"长期",
"certificate_address":"北京市朝阳区高碑店路181号1栋12345室"
}
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
无业务响应参数
响应示例
正常示例
异常示例
{
"alipay_open_mini_icp_apply_response": {
"code": "10000",
"msg": "success"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| application_type_error | 应用类型不是小程序 | 请检查应用类型是否是小程序 |
| icp_applets_audit_photo_is_empty_error | 小程序备案审批项文件不能为空 | 请填写小程序审批项文件材料media_id |
| icp_applets_audit_type_duplicate_error | 小程序备案审批项类型重复 | 请重新填写小程序审批项类型 |
| icp_applets_main_categoryid_error | 小程序备案小程序信息服务内容标识不能为空 | 请填写小程序信息的服务内容标识信息 |
| icp_applets_main_categoryid_invalid | 非法的小程序类目信息 | 请填写正确的小程序的类目信息 |
| icp_applets_principal_certificate_type_error | 小程序备案小程序负责人证件类型填写错误 | 请填写正确的小程序负责人证件类型代码 |
| icp_applets_principal_commit_letter_photo_gen_error | 小程序备案互联网承诺书合成失败 | 请稍后重试，或者联系官方凯发app官方网站的技术支持解决 |
| icp_applets_principal_info_error | 小程序备案小程序负责人与小程序主账号不一致 | 请填写与小程序主账号一致的小程序负责人信息 |
| icp_certificate_vaildate_format_illegal | 小程序负责人身份证有效期格式错误 | 请检查小程序负责人身份证有效期格式是否正确 |
| icp_certify_type_illegal | 小程序主账号证件类型不支持 | 小程序主账号身份证件类型不支持，护照等其他类型则建议小程序前往支付宝开放平台或者支付宝商家平台进行备案 |
| icp_exist_security_audiing_error | 存在平台备案中流程 | 存在平台备案中流程，无须再次提交备案 |
| icp_faceauth_fail | 小程序备案人脸核验未通过 | 当前人脸核验已发起未认证，23个小时内有效，请让商户直接在支付宝app端最近消息中，点击人脸核验消息进行人脸核验 |
| icp_faceauth_not_complete_expired | 当前人脸核验未认证的凭证certify_id已过期 | 当前人脸核验未认证凭证certify_id已过期,有效期为23个小时,请重新调用发起人脸核验的接口 |
| icp_main_category_error | 备案填写的小程序服务内容标识与小程序信息当前主营类目不一致 | 请填写正确的小程序的主营类目信息 |
| icp_mediaid_error | 小程序备案文件材料凭证media_id填写错误 | 请检查填写的文件材料凭证media_id是否正确 |
| icp_status_processing_error | 小程序正在进行备案中 | 正在备案中，无需重新提交备案 |
| icp_subject_certificate_type_error | 小程序备案主体单位证件类型填写错误 | 请填写正确的主体单位证件类型代码 |
| icp_subject_certify_id_expired | 当前人脸核验成功的凭证certify_id已过期 | 当前人脸核验成功的凭证certify_id已过期,有效期为三天,请重新调用发起人脸核验的接口 |
| icp_subject_certify_id_fail | 当前人脸核验凭证certify_id核验失败 | 请重新调用发起人脸核验的接口 |
| icp_subject_certify_id_notexist | 当前人脸核验凭证certify_id不存在 | 请检查人脸核验凭证certify_id是否填写正确 |
| icp_subject_directer_certificate_type_error | 小程序备案主体负责人证件类型填写错误 | 请填写正确的主体负责人证件类型代码 |
| icp_subject_directer_error | 小程序备案主体负责人与小程序主账号不一致 | 请填写与小程序主账号一致的主体负责人信息 |
| icp_subject_face_auth_faile | 当前人脸核验凭证certify_id认证结果面部被遮挡 | 请重新发起人脸核验接口 |
| icp_subject_province_error | 小程序备案主体信息省市区填写错误 | 请填写正确的小程序备案主体信息省市区 |
| icp_subject_type_error | 小程序备案主体单位性质填写错误 | 请填写正确的主体单位性质代码 |
| merchat_certificate_info_not_exist | 没有查询到实名信息 | 请前往支付宝开放平台或者商家平台进行备案 |