小程序备案接口使用指南

说明：在对接小程序备案具体接口前，需要对此文档进行仔细阅读，本文档中不仅包含完整的接口备案流程，对备案过程中的注意事项有详细的描述，避免在接口提交过程中遇到过多的报错。

一、接口备案流程概述

服务商/商家 可以为已授权的小程序进行小程序备案，可分为三个部分进行执行：商家备案材料上传、商家人脸核验、备案提交，如下流程图所示：

二、商家材料上传

备案前，需要收集商家的各类材料，通过 alipay.open.mini.icp.media.upload（小程序备案文件材料上传接口） 接口上传，上传成功后记录返回的 media_id，作为后续提交备案中的请求参数。

具体需要的材料可见：支付宝小程序备案操作指引-备案材料准备

关于材料上传接口的说明：

1. ***常见的情况为：

• 商家为一般企业或者个体工商户。
• 小程序所经营的内容不包含出版、教育、医疗保健、药品和医疗器械、文化、广播电影电视节目、新闻、网络预约车、校外培训（高中及以下阶段）、宗教等需要前置审批项的内容。
• 商家主体负责人和商家小程序负责人为同一人。

以上情况需要准备的商家材料有：营业执照、法人身份证正反面即可。

若商家的基本情况不在上述范围内，则需要按照实际情况进行材料的准备及上传。

2. 上传材料的要求

• 上传的材料要求目前均为图片。
• 对于图片的要求为：

• 图片的逻辑说明：

• 工信部对图片大小要求为营业执照和身份证需要在 100～200KB 之间，其他材料需要在 200KB 以下。为便捷 服务商/商家 上传材料，调用小程序备案文件材料上传接口后，系统会有自动的图片大小压缩处理机制，该机制在 2M 以下压缩效果***，所以建议 服务商/商家 上传的材料大小控制在 2M 以内。
• 接口本身并没有限制 2M 以上的图片上传，5M 以内的图片均可通过接口上传，但压缩大小至工信部系统要求（100～200KB或200KB以下）失败的几率会相对较高，服务商/商家 也可以进行尝试自行压缩至工信部系统要求。
• 当接口返回“FILE_SIZE_ILLEGAL 图片文件大小不符合要求”报错时，代表图片压缩处理失败，此时 服务商/商家 可以重新拍摄证照或者压缩图片后进行上传；亦可直接压缩到工信部的要求，身份证和营业执照（100～200KB之间），其他材料（200KB以下）。

三、商家人脸核验

人脸核验为小程序备案过程中的必备环节，所以需要调用 alipay.open.mini.icp.faceauth.verify（小程序备案发起人脸核验接口），发起人脸核验任务，返回人脸核验的凭证 certify_id，certify_id 务必进行记录，后续查询状态以及判断是否过期均需要用到。

说明：

1. 服务商发起人脸核验后，会发送一条人脸消息到支付宝端 app 中，商家需要进行人脸核验。商家打开支付宝 app > 首页 > ***近消息 > 服务消息找到 支付宝开发者助手 小程序发送的人脸核验消息。
   
2. 接收人脸核验消息的账号为，小程序的主账号对应的实名认证人的个人支付宝账号。拆解下来有如下场景:

说明：

• 如果商家收不到核验消息，需要按照规则进行检查，匹配到对应人的个人支付宝账号进行查看。
• 如果个体工商户存在转让，但未及时在商家平台更新资质的场景下，需要个体工商户，先前往 商家平台 进行资质更新。

3. 人脸核验发起后，商家需要在 20 小时内进入支付宝 app 进行人脸核验，超期之后，需要重新发起；人脸核验完成后，人脸核验结果3 天有效，在 3 天内发起备案申请时，均可使用核验成功的 certify_id；当审核因为人脸图片不合格驳回时，需要重新发起人脸核验，核验成功后，再次提交备案申请。
4. 人脸核验的结果，可以通过监听 alipay.open.mini.icp.faceauth.completed（人脸核验完成结果通知接口）进行获取；也可通过 alipay.open.mini.icp.faceauth.query（小程序备案人脸核验结果查询接口）进行主动查询。

四、备案相关主数据接口

备案提交接口中，相关备案地区、单位性质、证件类型、前置审批项、服务内容标识对应的系统传输标识，需要传输通过主数据接口查询中的代码。

说明：

1. 服务内容标识，传入支付宝小程序类目即可，如果 服务商/商家 本地没有保存，可以通过 alipay.open.mini.version.detail.query（小程序版本详情查询接口），获取 first_category_id 的值，进行填入。
2. 相关主数据接口有：

• 获取单位性质： alipay.open.mini.icp.subjecttype.query（获取单位性质接口）
• 获取区域信息：alipay.open.mini.icp.area.query（获取区域信息接口）
• 获取前置审批项类型：alipay.open.mini.icp.nrlxtype.query（获取前置审批项类型接口）
• 获取证件类型： alipay.open.mini.icp.certificatetype.query（获取证件类型接口）

五、备案提交

在完成材料上传、人脸核验后，服务商/商家 可以调用 alipay.open.mini.icp.apply（小程序申请备案接口）进行备案内容的提交，小程序备案接口包含了三大块的内容：小程序主体信息、小程序信息、小程序负责人信息。

1.小程序主体信息提交注意事项

• 人脸凭证 certify_id ，有效期为 3 天，超期会报错。人脸核验状态需要为“SUCCESS”，非该状态系统会进行报错。
• 主体证照信息，主体单位名称、主体单位编码、主体单位注册地址，需要保证提交的证照信息与实际证件信息完全一致，尤其需要注意 0 和 O，错别字（淌和洞，OCR识别很容易遇到），漏字的情况，否则将会被驳回。
• 主体负责人一般情况下，建议上传法人的身份证照信息，如果法人身份证无法拿到，则根据如下省份管局的要求，如果支持授权的，点击下载 主体负责人授权书 模版，填写上传材料后，获取到 media_id 后在 authorization_photo 字段中上传。

• 目前接口仅支持负责人的证件类型为居民身份证及港澳台通行证。如果小程序负责人证件为护照，则建议前往支付宝开放平台或者支付宝商家平台进行备案。
• 联系手机号需是主体负责人联系手机号。备案信息提交至工信部后，工信部会对主体负责人的手机号发送核验短信，且核验短信为 24 小时内，所以建议手机号不一定需要法人手机号，但一定是能够关注手机短信的人的手机号码，收到短信后可以立即前往 工信部网站，进行短信核验。

注意：短信核验为备案环节中必备环节，24 小时内未进行核验，会被工信部直接驳回，希望服务商发起后，能够提醒商家留意短信通知。

2.小程序信息提交注意事项

小程序信息为跟小程序本身提供的内容相关的信息，注意点如下：

• 服务内容标识，传入支付宝小程序类目即可，如果 服务商/商家 本地没有保存，可以通过 alipay.open.mini.version.detail.query（小程序版本详情查询接口），获取 first_category_id 的值，进行填入。
• 前置审批项，如果小程序提供的服务内容不包含，出版、教育、医疗保健、药品和医疗器械、文化、广播电影电视节目、新闻、网络预约车、互联网金融、校外培训（高中及以下阶段）、宗教等，则接口中传入不涉及前置审批项。如果涉及上述内容，则需要提供对应的证件材料及证件材料上的编号，需要证件的类型可 点击查看。
• 小程序备注：必须填写 当前小程序明确、具体的服务经营内容，请勿填写无关的、无服务特征的无效服务描述，请勿过多赘述广告成分。
  注意：该内容为通信主管部门备案审核的重要信息依据，请认真填写服务经营内容。
  备注示例：小程序提供餐饮经营服务，主要经营豆浆、油条等。
  错误示例：买车就上XXX平台，用户***信赖的甄选品牌，招商请联系XXXXXXXXX

• 如小程序实际经营 未涉及前置审批项经营内容 ，建议填写补充说明。
  建议格式：小程序主要经营XX服务内容+小程序实际经营不涉及前置审批项相关服务内容。
  说明示例：小程序提供经营药品信息展示服务，实际经营不涉及药品销售前置审批内容

3.小程序负责人提交注意事项

• 传入小程序负责人后，系统会校验小程序负责人是否与人脸核验的人为同一人，如果不是同一人，则会报错。
• 小程序负责人的手机号码填写时需要注意与主体负责人的手机号不一致，否则可能会被网信办驳回，另外对于手机号的要求，同上述主体负责人的手机号，需要能够及时的关注手机。在收到网信办核验短信后，立即前往 工信部网站 进行备案。
• 当传入小程序负责人时，需要对照如下表格，结合小程序备案地区，进行判断是否需要上传授权书，如果需要上传授权书，点击下载 小程序负责人授权书 模板，填写完后上传材料，获取 media_id，在小程序附件 attachement_photos 字段中传入小程序负责人授权书 media_id。

互联网承诺书：一般情况下为系统自动生成，无需传入。

但备案地为广东省时，需要下载 小程序备案者承诺书模版（广东省），手动填写后（注意：广东省区域，游戏类小程序请下载 小程序备案者承诺书模版（广东省游戏小程序专用）.docx），拍照上传材料上传接口，获得对应的 media_id，填入 commit_letter_materials 字段中。

六、备案提交后注意事项

备案提交后，会经过支付宝平台初审，工信部短信核验、工信部审核三大步骤。

1.支付宝平台审核

开发者/商家在支付宝开放平台提交小程序备案信息后，平台将会在 1-2 个工作日内完成备案信息初审（具体请以实际审核时间为准）。 在平台初审的过程中，请备案相关人员保持电话畅通，以便平台对您提交的备案信息进行核验。

平台审核的结果，可以通过 alipay.open.mini.icp.audit.notify（备案审核结果通知接口） 接收，也可以通过alipay.open.mini.icp.status.query（小程序备案状态查询接口）进行主动查询，平台审核通过后，会自动进入到监管审核环节，所以当接口中获取到状态值为 MIIT_AUDITING，则代表平台审核已通过。

2.工信部短信核验

根据工信部的要求，小程序备案需完成短信核验。备案初审通过后，提交接口中的主体负责人或者小程序负责人都可能会收到工信部发送的核验短信（发送号码：12381），请在收到短信的 24 小时内登录 工信部备案官网首页 完成短信核验，短信核验成功后备案申请进入通管局审核流程。

若核验时提示验证码错误或无效，商家可触发一次短信重发；24 小时内未核验成功，备案将被工信部系统自动驳回，商家需重新提交备案申请。

另外，短信发送的逻辑、核验逻辑、常见问题，请查看 工信部短信核验专题，建议仔细阅读，以便按照逻辑指导商家进行短信核验。

说明：短信未在 24 小时内完成核验，监管系统将会自动驳回，届时 服务商/商家 需要重新发起备案流程。

3.工信部审核

通过工信部短信核验后，会进入到工信部审核流程。

• 工信部审核的结果及驳回原因，可以通过 alipay.open.mini.icp.audit.notify（备案审核结果通知接口）接收，也可以通过 alipay.open.mini.icp.status.query（小程序备案状态查询接口）进行主动查询。
• 工信部审核结果（通过或驳回），工信部都会发送短信和邮件给到备案接口中提交的手机号和邮箱中，请提醒商家进行查收。
• 根据各省市要求在 1-20 个工作日内（具体以实际审核时间为准）完成审核并告知审核结果。

七、撤销备案

小程序发起备案后，当备案状态为平台审核驳回、平台审核中，可调用 alipay.open.mini.icp.cancel（小程序撤销备案接口） 进行备案的撤销；其余状态下，备案都不可撤销。

八、***快接入场景

小程序备案为一项复杂的系统工程，对于服务商***简单的场景为企业法人或者个体工商户本人进行人脸核验，主体负责人和小程序负责人也为企业法人或者个体工商户本人，需要提交的材料以及处理的逻辑***少，建议优先开发此逻辑，快速开展备案；如果有其他分支条件的情况下，例如法人身份信息获取不到、主体负责人和小程序负责人不一致的情况下，需要处理额外的一些复杂逻辑，建议服务商自行进行评估是否接入接口，或者直接可让商家前往 支付宝开放平台 或者 商家平台 进行备案。

建议备案作业流程：

1. 材料收集：营业执照、法人身份证正反面，并通过材料上传接口上传。
2. 人脸核验：触发人脸核验，法人或者个体工商户个人支付宝完成人脸核验。
3. 提交备案：主体信息（主体资质+主体负责人）、小程序信息（前置审批、备注、小程序类目）、小程序负责人信息（同主体负责人信息，另外如果是广东省，需要额外传入广东省承诺书）。
4. 审核状态获取：进入监管审核中后，提醒商家关注监管核验短信。

说明：如果有其他分支条件的情况下，例如法人身份信息获取不到、主体负责人和小程序负责人不一致的情况下，需要处理额外的一些复杂逻辑，建议服务商自行进行评估是否接入接口，或者直接可让商家前往 支付宝开放平台 或者 商家平台 进行备案。

建议阅读文档：支付宝小程序备案操作指引、备案常见问答、工信部常见驳回指引。