# 申请小程序认证及备案
接口应在服务器端调用,详细说明参见服务端API。
# 接口说明
# 接口英文名
submitAuthAndIcp
# 功能描述
使用该接口可一步申请小程序认证及备案。
# 注意事项
- 申请小程序认证及备案之前,请确保已经完成:
- 小程序名称、图标、描述等小程序基本信息已填写完成。
- 小程序至少存在一个审核通过的类目。
- 使用 小程序名称检测 API 检测待设置的小程序名称是否可用。
- 检测备案入口是否对该小程序开放(见
info.available
字段)。 - 小程序管理员人脸核身
- 上传所有附件。
- 本接口使用的所有媒体材料都是 上传小程序备案媒体材料 接口返回的
media_id
。 - 认证及备案的先后顺序是先完成认证,再完成备案。申请提交后,状态流转到备案阶段方可主动撤回,认证阶段不支持主动撤回。
- 本接口为异步接口,到达每个特定节点时均会有事件推送,见下方"事件推送"说明。亦可以使用认证及备案进度查询 API 查询进度。
- 如收到审核被驳回通知,可使用认证及备案进度查询 API 查询驳回原因。
- 认证环节需缴纳审核费用,如非服务商代缴,则本接口调用成功时会向小程序管理员发送交费通知,管理员需在 24 小时内完成支付,过期后需要重新创建任务。
- 根据《国家税务总局深圳市税务局关于开展全面数字化的电子发票试点工作的公告》的管理要求,**2024 年 5 月 15 日起,平台将不再支持开具增值税专票(纸质类型),对应统一调整为增值税专票(数电类型)。**调整后将无法提交纸质增值税专票开票申请。查看数电发票说明
- 人脸核身视频会用于生成核验照片,背景需白色或接近浅色,核验人不能裸露上半身,不能戴帽子、耳机、口罩等遮挡面部的物品,如视频不满足要求,即使人脸核身通过,本接口也会返回失败。
- 所有字段校验失败的原因会一次性返回。
- 小程序备注(必填)注意事项:
- 天津市个人主体备案小程序请按以下格式补充备注:应急联系电话手机号使用人为XXX,与小程序主办者关系为XX (注:应急联系方式必须为小程序主办者的直系亲属);天津市非个人主体备案小程序请按以下格式补充备注:应急联系电话手机号使用人为XXX公司员工XXX。
- 福建省个人主体备案小程序请按以下格式补充备注:请具体描述小程序实际经营内容、主要服务内容,该信息为主管部门审核重要依据,备注内容字数限制 20 - 200 字,请认真填写。且不能出现“XX公司官网,XX单位旗下产品”。
- 广东省备案小程序如果是非纯中文小程序昵称,要求在小程序备注位置注明中文名称以及小程序主要服务内容,并且在备注文案文末加上“承诺遵守中华人民共和国法律法规。”,备注内容字数限制 20 - 200 字,请认真填写。
- 若发起备案请求时,管理员实名信息未补充,且备案信息中小程序负责人为法人时,管理员实名信息将更新为小程序负责人(即法人)。
- 小程序负责人须与账号管理员实名信息一致。
# 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/wxa/sec/submit_auth_and_icp?access_token=ACCESS_TOKEN
# 第三方调用
调用方式以及出入参和HTTPS相同,仅是调用的token不同
该接口所属的权限集id为:18
服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用
# 请求参数
属性 | 类型 | 必填 | 说明 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
access_token | string | 是 | 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用authorizer_access_token | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
auth_data | object | 是 | 认证数据 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
icp_subject | object | 是 | 备案主体信息 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
icp_applets | object | 是 | 微信小程序信息 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
icp_materials | object | 是 | 其他备案媒体材料 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
# 返回参数
属性 | 类型 | 说明 | |||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
errcode | number | 错误码 | |||||||||||||||||
errmsg | string | 错误信息 | |||||||||||||||||
hints | array<object> | 错误提示 | |||||||||||||||||
| |||||||||||||||||||
procedure_id | string | 小程序认证及备案任务流程 id | |||||||||||||||||
pay_url | string | 小程序认证认证审核费用付费链接,当 pay_type 为 2 时返回 |
# 其他说明
# 事件推送
认证及备案流程的主要节点均有事件推送到第三方平台的授权事件接收接口,包括支付完成、派单给审核机构、审核打回、审核通过、审核失败等。
如需监听小程序认证年审和过期能力限制提醒,请参考小程序认证文档中的事件说明。
属性 | 类型 | 说明 |
---|---|---|
InfoType | string | 消息类型,固定为 notify_3rd_wxa_auth_and_icp |
appid | string | 小程序 appid |
procedure_id | string | 小程序认证及备案任务流程 id |
procedure_status | number | 当前任务流程状态,见“小程序认证及备案进度查询” API 文档中的任务流程状态枚举 |
dispatch_info.provider | string | 小程序认证审核机构名称(当 procedure_status 为 17 时有效) |
dispatch_info.contact | string | 小程序认证审核机构联系方式(当 procedure_status 为 17 时有效) |
dispatch_info.dispatch_time | number | 小程序认证派单时间戳(秒)(当 procedure_status 为 17 时有效) |
message | string | 提示信息 |
小程序认证审核费用支付完成的事件
<xml>
<AppId><![CDATA[wx31f828cesdfa4eabc]]></AppId>
<CreateTime>1700619290</CreateTime>
<InfoType><![CDATA[notify_3rd_wxa_auth_and_icp]]></InfoType>
<appid><![CDATA[wxaf614423g25ffd9b]]></appid>
<procedure_id><![CDATA[2df5025489464f2288e93395b75a628c]]></procedure_id>
<procedure_status>16</procedure_status>
<message><![CDATA[支付完成]]></message>
</xml>
小程序认证审核派单成功事件
<xml>
<AppId><![CDATA[wx31f828cesdfa4eabc]]></AppId>
<CreateTime>1700619311</CreateTime>
<InfoType><![CDATA[notify_3rd_wxa_auth_and_icp]]></InfoType>
<appid><![CDATA[wxaf614423g25ffd9b]]></appid>
<procedure_status>17</procedure_status>
<message><![CDATA[小程序认证审核派单通知]]></message>
<procedure_id><![CDATA[2df5025489464f2288e93395b75a628c]]></procedure_id>
<dispatch_info>
<provider><![CDATA[上海倍通企业信用征信有限公司(测试)]]></provider>
<contact><![CDATA[热线电话:0086-13249064176,咨询时间:周一至周五(工作日)8:30-17:30。]]></contact>
<dispatch_time>1700619300</dispatch_time>
</dispatch_info>
</xml>
小程序认证打回重填事件
<xml>
<AppId><![CDATA[wx31f828cesdfa4eabc]]></AppId>
<CreateTime>1700637974</CreateTime>
<InfoType><![CDATA[notify_3rd_wxa_auth_and_icp]]></InfoType>
<appid><![CDATA[wxaf614423g25ffd9b]]></appid>
<procedure_status>18</procedure_status>
<message><![CDATA[因存在XXX问题本次小程序认证审核不通过]]></message>
<procedure_id><![CDATA[2df5025489464f2288e93395b75a628c]]></procedure_id>
</xml>
小程序认证审核通过认证成功事件
<xml>
<AppId><![CDATA[wx31f828cesdfa4eabc]]></AppId>
<CreateTime>1700624277</CreateTime>
<InfoType><![CDATA[notify_3rd_wxa_auth_and_icp]]></InfoType>
<appid><![CDATA[wxaf614423g25ffd9b]]></appid>
<procedure_status>19</procedure_status>
<message><![CDATA[小程序认证成功]]></message>
<taskid><![CDATA[15086754e2a644d584517ff42057e3b8]]></taskid>
</xml>
小程序认证最终失败事件
<xml>
<AppId><![CDATA[wx31f828cesdfa4eabc]]></AppId>
<CreateTime>1700642375</CreateTime>
<InfoType><![CDATA[notify_3rd_wxa_auth_and_icp]]></InfoType>
<appid><![CDATA[wxaf614423g25ffd9b]]></appid>
<procedure_status>20</procedure_status>
<message><![CDATA[由于您由于您的申请已经超期,同时未提交xxxxxxx,无法继续申请,本次认证失败。]]></message>
<procedure_id><![CDATA[2df5025489464f2288e93395b75a628c]]></procedure_id>
</xml>
创建备案审核单失败事件
<xml>
<AppId><![CDATA[wx31f828cesdfa4eabc]]></AppId>
<CreateTime>1700642375</CreateTime>
<InfoType><![CDATA[notify_3rd_wxa_auth_and_icp]]></InfoType>
<appid><![CDATA[wxaf614423g25ffd9b]]></appid>
<procedure_status>21</procedure_status>
<message><![CDATA[小程序备案审核单创建失败]]></message>
<procedure_id><![CDATA[2df5025489464f2288e93395b75a628c]]></procedure_id>
</xml>
小程序备案审核派单成功事件
<xml>
<AppId><![CDATA[wx31f828cesdfa4eabc]]></AppId>
<CreateTime>1700619311</CreateTime>
<InfoType><![CDATA[notify_3rd_wxa_auth_and_icp]]></InfoType>
<appid><![CDATA[wxaf614423g25ffd9b]]></appid>
<procedure_status>22</procedure_status>
<message><![CDATA[小程序备案审核派单通知]]></message>
<procedure_id><![CDATA[2df5025489464f2288e93395b75a628c]]></procedure_id>
</xml>
小程序备案审核平台驳回事件
<xml>
<AppId><![CDATA[wx31f828cesdfa4eabc]]></AppId>
<CreateTime>1700619311</CreateTime>
<InfoType><![CDATA[notify_3rd_wxa_auth_and_icp]]></InfoType>
<appid><![CDATA[wxaf614423g25ffd9b]]></appid>
<procedure_status>23</procedure_status>
<message><![CDATA[小程序备案平台审核驳回]]></message>
<procedure_id><![CDATA[2df5025489464f2288e93395b75a628c]]></procedure_id>
</xml>
小程序备案备案管局审核事件
<xml>
<AppId><![CDATA[wx31f828cesdfa4eabc]]></AppId>
<CreateTime>1700619311</CreateTime>
<InfoType><![CDATA[notify_3rd_wxa_auth_and_icp]]></InfoType>
<appid><![CDATA[wxaf614423g25ffd9b]]></appid>
<procedure_status>24</procedure_status>
<message><![CDATA[小程序备案备案管局审核中]]></message>
<procedure_id><![CDATA[2df5025489464f2288e93395b75a628c]]></procedure_id>
</xml>
小程序备案备案管局驳回事件
<xml>
<AppId><![CDATA[wx31f828cesdfa4eabc]]></AppId>
<CreateTime>1700619311</CreateTime>
<InfoType><![CDATA[notify_3rd_wxa_auth_and_icp]]></InfoType>
<appid><![CDATA[wxaf614423g25ffd9b]]></appid>
<procedure_status>25</procedure_status>
<message><![CDATA[小程序备案备案管局驳回]]></message>
<procedure_id><![CDATA[2df5025489464f2288e93395b75a628c]]></procedure_id>
</xml>
小程序认证及备案完成事件
<xml>
<AppId><![CDATA[wx31f828cesdfa4eabc]]></AppId>
<CreateTime>1700619311</CreateTime>
<InfoType><![CDATA[notify_3rd_wxa_auth_and_icp]]></InfoType>
<appid><![CDATA[wxaf614423g25ffd9b]]></appid>
<procedure_status>26</procedure_status>
<message><![CDATA[认证及备案完成]]></message>
<procedure_id><![CDATA[2df5025489464f2288e93395b75a628c]]></procedure_id>
</xml>
# 调用示例
示例说明: 企业类型,商家缴纳审核费用
# 请求数据示例
{
"auth_data": {
"customer_type": 1,
"contact_info": {
"name": "王五",
"mobile": "13011111111",
"email": "wangwu@lisiwangwucorp.com"
},
"invoice_info": {
"invoice_type": 4,
"vat": {
"enterprise_phone": "400-1234567",
"id": "92111122223333443F",
"desc": "李四王五的小程序认证审核费用"
}
},
"account_name_type": 1,
"account_name": "李四王五的小程序",
"pay_type": 2,
"service_appid": "wx31f828cesdfa4eabc",
"third_party_phone": "400-7654321"
},
"icp_subject": {
"base_info": {
"type": 4, // 企业类型
"name": "李四王五有限责任公司",
"province": "440000", // 广东省
"city": "440100", // 广州市
"district": "440105", // 海珠区
"address": "新港中路TIT创意园B6栋",
"comment": "主体备注"
},
"organize_info": {
"certificate_type": 1, // 营业执照
"certificate_number": "92111122223333443F",
"certificate_address": "广东省广州市海珠区新港中路TIT创意园B6栋",
"certificate_photo": "4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7"
},
"principal_info": {
"name": "李四",
"mobile": "13022222221",
"email": "lisi@lisiwangwucorp.com",
"emergency_contact": "1722222234",
"certificate_type": 2, // 身份证
"certificate_number": "440105198802023334",
"certificate_validity_date_start": "20230815",
"certificate_validity_date_end": "20330815",
"certificate_photo_front": "4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7",
"certificate_photo_back": "4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7"
}
},
"icp_applets": {
"base_info": {
"service_content_types": [
3,
4
], // 工具 & 家政
"nrlx_details": [
{
"type": 24 // 以上都不涉及
}
],
"comment": "小程序备注"
},
"principal_info": {
"name": "王五",
"mobile": "13011111111",
"email": "wangwu@lisiwangwucorp.com",
"emergency_contact": "15522223333",
"certificate_type": 2, // 身份证
"certificate_number": "440105199001019999",
"certificate_validity_date_start": "20230815",
"certificate_validity_date_end": "20330815",
"certificate_photo_front": "4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7",
"certificate_photo_back": "4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7",
"verify_task_id": "R5PqRPNb6GmG3i0rqd4pTg"
}
},
"icp_materials": {
"commitment_letter": [
"4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7"
]
}
}
# 返回数据示例
{
"errcode": 0,
"errmsg": "ok",
"procedure_id": "2df5025489464f2288e93395b75a628c",
"pay_url": "https://mp.weixin.qq.com/"
}
# 错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
0 | ok | ok |
-1 | system error | 系统繁忙,此时请开发者稍候再试 |
86202 | 申请小程序备案失败 | 申请小程序备案失败,请根据返回的错误提示进行修改 |
86301 | 系统错误,请稍后重试 | 系统错误,请稍后重试 |
86302 | 输入信息与图片信息相差过大 | 重新拍摄上传图片 |
86303 | 无法获取号码归属地 | 请重试或更换一个号码 |
86308 | 证件有效期不满足要求 | 请确保证件在有效期内,且有效期大于3个月 |
86324 | 当前正在审核中,请勿重复提交 | 当前正在审核中,请勿重复提交 |
86358 | 存在订单尚未完成,不允许再次提交 | 存在订单尚未完成,不允许再次提交 |