常见问题 -凯发app官方网站更新时间:2023-07-27 10:08:33收藏我的文档设置返回文档小程序场景报名q:查不到目标招商方案?a:可能情况分为两大类:招商方案配置错误、商户不满足报名要求。每个大类有一些细分的情况类型:大类细分情况进一步细分的情况招商方案配置错误●招商方案不是可用状态(不是 enabled)●当前时间不在招商方案可报名时段●招商方案没有配置可在开放平台报名-商户不满足报名要求●要报名的商户不在招商方案的白名单中-●要报名的商户不满足招商方案上配置的商户可报名条件(商家资质)●不满足 小程序服务素材 要求。●不满足 物料门店覆盖 要求。●不满足 繁星签约 要求。●不满足 罗码签约 要求。●不满足 品牌下券 要求。每个细分情况的样例说明如下:●招商方案配置错误 - 招商方案不是可用状态(不是 enabled): 调用 查询可报名的方案列表接口 的响应:json复制代码9912345678910{ "alipay_marketing_recruit_planlist_query_response": { "code": "10000", "msg": "success", "page_num": 1, "page_size": 20, "total": 0 }, "sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"}查不到想要的目标招商方案,如:2022102501000100000000561034。调用 招商方案详情查询接口 的响应:991234567891011121314151617181920212223{ "alipay_marketing_recruit_plan_query_response": { "code": "10000", "msg": "success", "description": "用于小程序报名的测试", "enroll_end_time": "2023-09-30 23:59:59", "enroll_rules": [ { "max_size": 1, "min_size": 1, "required": true, "type": "mini_app" } ], "enroll_scene_type": "mini_app", "enroll_start_time": "2022-09-05 00:00:00", "logo": "https://xxxx", "plan_id": "2022102501000100000000561034", "plan_name": "测试小程序报名", "status": "disabled" }, "sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"}能看到想要的目标招商方案:2022102501000100000000561034 的状态是 status = disabled 未生效的状态,所以是不可以报名的(目前系统会实际拦截招商方案状态未生效时提交的报名)。●招商方案配置错误 - 当前时间不在招商方案可报名时段: 调用 查询可报名的方案列表接口 的响应:9912345678910{ "alipay_marketing_recruit_planlist_query_response": { "code": "10000", "msg": "success", "page_num": 1, "page_size": 20, "total": 0 }, "sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"}查不到想要的目标招商方案,如:2022102501000100000000561034。调用 招商方案详情查询接口 的响应:991234567891011121314151617181920212223{ "alipay_marketing_recruit_plan_query_response": { "code": "10000", "msg": "success", "description": "用于小程序报名的测试", "enroll_end_time": "2023-09-30 23:59:59", "enroll_rules": [ { "max_size": 1, "min_size": 1, "required": true, "type": "mini_app" } ], "enroll_scene_type": "mini_app", "enroll_start_time": "2022-12-05 00:00:00", "logo": "https://xxxx", "plan_id": "2022102501000100000000561034", "plan_name": "测试小程序报名", "status": "enabled" }, "sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"}能看到想要的目标招商方案:2022102501000100000000561034 的开始报名时间 enroll_start_time 是 “2022-12-05 00:00:00”,当前时间未到开始报名的时间,所以是不可以报名的(目前系统会实际拦截不在报名时间范围提交的报名)。●招商方案配置错误 - 招商方案没有配置可在开放平台报名: 调用 查询可报名的方案列表接口 的响应:查不到想要的目标招商方案,如:2022102501000100000000561034调用 招商方案详情查询接口 的响应:能看到想要的目标招商方案:2022102501000100000000561034 的状态是 status = enabled 已生效的状态,但是由于方案列表中查不到,所以是业务逻辑上是不可以报名的(但目前系统并未实际拦截这种情况的报名)。●商户不满足报名要求 - 要报名的商户不在招商方案的白名单中: 调用 查询可报名的方案列表接口 的响应:查不到想要的目标招商方案,如:2022102501000100000000561034。调用 招商方案详情查询接口 的响应:能看到想要的目标招商方案:2022102501000100000000561034 的状态是 status = enabled 已生效的状态,但是由于方案列表中查不到,所以是不可以报名的(目前系统会实际拦截不在白名单的商户报名)。●商户不满足报名要求 - 要报名的商户不满足招商方案上配置的商户可报名条件(商家资质): 不满足小程序服务素材要求、不满足物料门店覆盖要求、不满足繁星签约要求、不满足罗码签约要求、不满足品牌下券要求 造成的找不到目标方案,样例如下: 调用 查询可报名的方案列表接口 的响应:查不到想要的目标招商方案,如:2022102501000100000000561034。调用 招商方案详情查询接口 的响应:能看到想要的目标招商方案:2022102501000100000000561034 的状态是 status = enabled 已生效的状态,但是由于方案列表中查不到,所以是不可以报名的(目前系统会实际拦截不满足招商方案上配置的商户可报名条件的商户的报名)。q:调用提交报名接口失败?a:可能情况分为三大类:招商方案配置错误、商户不满足报名要求、提交报名的内容不满足报名要求。每个大类有一些细分的情况类型:大类细分情况进一步细分的情况招商方案配置错误●招商方案不是可用状态(不是 enabled)●当前时间不在招商方案可报名时段-商户不满足报名要求●要报名的商户不在招商方案的白名单中-●要报名的商户不满足招商方案上配置的商户可报名条件(商家资质)●不满足 小程序服务素材 要求。●不满足 物料门店覆盖 要求。●不满足 繁星签约 要求。●不满足 罗码签约 要求。●不满足 品牌下券 要求。提交报名的内容不满足报名要求●提报的小程序不满足报名要求●不满足 与报名商户的关系 要求。●不满足 可提报小程序能力等级 要求。●不满足 可提报小程序服务素材 要求。●提报的素材不满足报名要求●素材规范要求的关键字段丢失。●素材规范要求的关键字段传值错误。●素材规范导致的其他错误情况。每个细分情况的样例说明如下:●招商方案配置错误 - 招商方案不是可用状态(不是 enabled): 调用 招商报名提交接口 的响应:提交报名报错,提示信息里最关键的部分是“参数有误”四个字后面的内容:“方案当前状态不允许报名”。●招商方案配置错误 - 当前时间不在招商方案可报名时段: 调用 招商报名提交接口 的响应:提交报名报错,提示信息里最关键的部分是“参数有误”四个字后面的内容:“超过报名截止时间”。表示不在报名时间范围内,服务商可在查询方案详情中看到规定的报名时间范围。注意:目前系统实现中,即便是 未到报名开始时间,依然提示的是 “超过报名截止时间”。●商户不满足报名要求 - 要报名的商户不在招商方案的白名单中: 调用 招商报名提交接口 的响应:提交报名报错,提示信息里最关键的部分是“参数有误”四个字后面的内容:“抱歉,您目前不在该活动招商范围内”。●商户不满足报名要求 - 商家资质 - 不满足 小程序服务素材要求: 调用 招商报名提交接口 的响应:提交报名报错,提示信息里最关键的部分是“参数有误”四个字后面的内容:“抱歉,本次活动要求您品牌下完成服务直达素材提报且通过审核的小程序有数量要求”。●商户不满足报名要求 - 商家资质 - 不满足【物料门店覆盖要求】: 调用 招商报名提交接口 的响应:提交报名报错,提示信息里最关键的部分是“参数有误”四个字后面的内容:“抱歉,本次活动对同品牌物料门店覆盖率有要求,您未满足要求”。●商户不满足报名要求 - 商家资质 - 不满足 繁星签约要求: 调用 招商报名提交接口 的响应:提交报名报错,提示信息里最关键的部分是“参数有误”四个字后面的内容:“抱歉,本次活动要求您品牌下完成繁星签约的小程序有数量要求”。●商户不满足报名要求 - 商家资质 - 不满足 罗码签约要求: 调用 招商报名提交接口 的响应:提交报名报错,提示信息里最关键的部分是“参数有误”四个字后面的内容:“抱歉,本次活动要求您品牌下完成罗马签约的小程序有数量要求”。●商户不满足报名要求 - 商家资质 - 不满足 品牌下券要求: 调用 招商报名提交接口 的响应:提交报名报错,提示信息里最关键的部分是“参数有误”四个字后面的内容:“抱歉,本次活动要求您品牌下券库存要求,您未满足要求”。●商户不满足报名要求 - 商家资质 - 不满足以上多个要求时: 调用 招商报名提交接口 的响应:提交报名报错,提示信息里最关键的部分是“参数有误”四个字后面的内容:“抱歉,本次活动要求您品牌下完成服务直达素材提报且通过审核的小程序有数量要求”。当商户不满足多个可报名条件时,目前系统只返回了其中一个原因。在提交报名时才提示不满足商户可报名条件,按照正常逻辑,都是方案临时修改导致的,这个修改会导致在查询可报名方案列表时查不到目标招商方案。建议联系支付宝业务人员,咨询目标招商方案修改成什么样了。●提交报名的内容不满足报名要求 - 提报的小程序 - 不满足 与报名商户的关系 要求: 调用 招商报名提交接口 的响应:提交报名报错,提示信息里最关键的部分是“参数有误”四个字后面的内容:“无小程序[2018013102117915]使用权限”。●提交报名的内容不满足报名要求 - 提报的小程序 - 不满足 可提报小程序能力等级 要求: 调用 招商报名提交接口 的响应:提交报名报错,提示信息里最关键的部分是“参数有误”四个字后面的内容:“您的小程序不满足优质小程序要求”。可提报小程序能力等级要求 还可能配置限定为“合格小程序”,当配置为限定“合格小程序”时,返回的提示信息稍有变动:“您的小程序不满足合格小程序要求”。●提交报名的内容不满足报名要求 - 提报的小程序 - 不满足 可提报小程序服务素材 要求: 调用 招商报名提交接口 的响应:提交报名报错,提示信息里最关键的部分是“参数有误”四个字后面的内容:“您的小程序不满足具体服务素材的要求”。●提交报名的内容不满足报名要求 - 提报的小程序 - 同时不满足 可提报小程序能力等级、可提报小程序服务素材 等多个要求时: 调用 招商报名提交接口 的响应:提交报名报错,提示信息里最关键的部分是“参数有误”四个字后面的内容:“您的小程序不满足优质小程序要求;您的小程序不满足具体服务素材的要求”。可以看到,多个条件不满足时,每个条件的提示信息都拼接进去了。●提交报名的内容不满足报名要求 - 提报的素材 - 素材规范要求的关键字段丢失: 说明:提交报名内容中,内容类型为素材的部分,是十分特殊的。素材部分的规范要求会提前校验,如果发现素材不满足素材规范要求,则会将原因直接返回。 比如,调用 招商报名提交接口 核心传参:注意素材 materials 部分,里面 data 传值中的key:“brandlogo2” 其实是错误值,最后面多了一个数字 “2”,导致提交报名后取不到目标key:“brandlogo”,进而报错。响应:提交报名报错,提示信息里最关键的部分是“业务异常”四个字后面的内容:“[校验不通过明细:[字段:brandlogo][规则:composite][位置:-1][原因:值列表不能为空]]”。●提交报名的内容不满足报名要求 - 提报的素材 - 素材规范要求的关键字段传值错误: 比如,调用 招商报名提交接口 核心传参:注意素材 materials 部分,里面 data 传值中 aftsfileid 的值:“2a*4qsvq6aaqhuaaaaaaaaaaaaadun1aq” 其实是错误值,最前面多了一个数字 “2”,导致提交报名后无法正常解析素材信息。响应:提交报名报错,提示信息里最关键的部分是“业务异常”四个字后面的内容:“解析文件元信息返回结果为失败,request=[2a*4qsvq6aaqhuaaaaaaaaaaaaadun1aq,image],result=[{\"innererror\":{\"errorcode\":-1000,\"errormsg\":\"unknown error code:519\",\"errorurl\":\"get https://xxxx http/1.1\"},\"respcode\":\"unknown\",\"respmsg\":\"unknown error code:519\",\"succ\":false}]”。●提交报名的内容不满足报名要求 - 提报的素材 - 素材规范导致的其他错误情况: 在 提交报名接口,遇到 code = 40004 的业务异常,并且提示信息 sub_msg 的开头是 “业务异常”,那么通常都是违反了 素材规范 的缘故,可以根据实际提示信息做调整,如果实在看不懂提示信息,请咨询凯发app官方网站的技术支持小二。q:报名记录不存在?a:调用 报名详情查询接口,获取报名记录的详情信息,但是响应样例如下:提示信息里最关键的部分是“参数有误”四个字后面的内容:“报名记录不存在”。这说明提交报名接口没有调用成功,导致报名记录并未储存下来,可重新报名,观察提交报名接口的响应信息。q:调用下线报名接口报错?a:调用下线报名接口报错有两种可能的情况:报名记录不是审核通过状态(enabled)、没有报名记录的操作权限。注意:报名记录的状态值如果不是 审核通过状态(enabled),调用 (下线报名接口)肯定会报错。每个情况的样例说明如下:报名记录不是审核通过状态(enabled)响应:提交报名报错,提示信息里最关键的部分是“业务异常”四个字后面的内容:“当前报名状态不允许本操作”。注意:●如果报名记录状态是 closing (下线审核中),调用 (下线报名接口)也会报错。●如果报名记录状态是 closed (已下线),调用 (下线报名接口)也会报错。没有报名记录的操作权限响应:提交报名报错,提示信息里最关键的部分是“业务异常”四个字后面的内容:“无权限操作”。没有操作权限的情况有两种:报名记录不是当前服务商提交的。报名记录是当前服务商提交的,但不是在开放平台提交,而是在支付宝的 商家运营平台/服务商代运营平台 提交的。券场景报名q:查不到目标招商方案?a:与上面 小程序场景报名 的 q:查不到目标招商方案?相同。q:调用提交报名接口失败?a:可能情况分为三大类:招商方案配置错误、商户不满足报名要求、提交报名的内容不满足报名要求。每个大类有一些细分的情况类型:大类细分情况进一步细分的情况招商方案配置错误●招商方案不是可用状态(不是 enabled)●当前时间不在招商方案可报名时段-商户不满足报名要求●要报名的商户不在招商方案的白名单中-●要报名的商户不满足招商方案上配置的商户可报名条件(商家资质)●不满足 小程序服务素材 要求。●不满足 物料门店覆盖 要求。●不满足 繁星签约 要求。●不满足 罗码签约 要求。●不满足 品牌下券 要求。提交报名的内容不满足报名要求●提报的券不满足报名要求●不满足 券类型 要求。●不满足 领券开始时间 要求。●不满足 领券结束时间 要求。●不满足 券库存 要求。●不满足 券核销时间 要求。●不满足 券核销渠道 要求。●不满足 对应券类型的面额 要求。●提报的小程序不满足报名要求●不满足 与报名商户的关系 要求。●不满足 可提报小程序能力等级 要求。●不满足 可提报小程序服务素材 要求。●提报的素材不满足报名要求●素材规范要求的关键字段丢失。●素材规范要求的关键字段传值错误。●素材规范导致的其他错误情况。每个细分情况的样例说明如下:●招商方案配置错误 - 招商方案不是可用状态(不是 enabled): 与上面 小程序场景报名 的 q:调用提交报名接口失败?中 招商方案不是可用状态(不是 enabled) 的情况相同。●招商方案配置错误 - 当前时间不在招商方案可报名时段: 与上面 小程序场景报名 的 q:调用提交报名接口失败?中 当前时间不在招商方案可报名时段 的情况相同。●商户不满足报名要求 - 要报名的商户不在招商方案的白名单中: 与上面 小程序场景报名 的 q:调用提交报名接口失败?中 要报名的商户不在招商方案的白名单中 的情况相同。●商户不满足报名要求 - 商家资质 - 不满足 小程序服务素材要求: 商户不满足报名要求 - 商家资质 - 不满足 物料门店覆盖要求: 商户不满足报名要求 - 商家资质 - 不满足 繁星签约要求: 商户不满足报名要求 - 商家资质 - 不满足 罗码签约要求: 商户不满足报名要求 - 商家资质 - 不满足 品牌下券要求: 商户不满足报名要求 - 商家资质 - 不满足以上的多个要求时: 与上面 小程序场景报名 的 q:调用提交报名接口失败?中 商家资质 系列 的情况相同。●提交报名的内容不满足报名要求 - 提报的券 - 不满足 券类型 要求: 调用 (招商报名提交接口(券报名场景))的响应:提交报名报错,提示信息里最关键的部分是“参数有误”四个字后面的内容:“券类型不满足要求”。●提交报名的内容不满足报名要求 - 提报的券 - 不满足 领券开始时间 要求: 调用 (招商报名提交接口(券报名场景))的响应:提交报名报错,提示信息里最关键的部分是“参数有误”四个字后面的内容:“领券开始时间必须大于等于2022-10-01 00:00:00”。●提交报名的内容不满足报名要求 - 提报的券 - 不满足 领券结束时间 要求: 调用 (招商报名提交接口(券报名场景))的响应:提交报名报错,提示信息里最关键的部分是“参数有误”四个字后面的内容:“领券结束时间必须小于等于2022-10-08 23:59:59”。●提交报名的内容不满足报名要求 - 提报的券 - 不满足 券库存 要求: 调用 (招商报名提交接口(券报名场景))的响应:提交报名报错,提示信息里最关键的部分是“参数有误”四个字后面的内容:“券总库存数量必须大于等于999999”。●提交报名的内容不满足报名要求 - 提报的券 - 不满足【券核销时间】要求: 调用 (招商报名提交接口(券报名场景))的响应:提交报名报错,提示信息里最关键的部分是“参数有误”四个字后面的内容:“券核销时间天数必须大于等于10000”。券核销时间还可以限定为“固定时间”,然后配置固定时间范围:限定为“固定时间”,提示信息就是“券核销时间必须为绝对时间”。●提交报名的内容不满足报名要求 - 提报的券 - 不满足 券核销渠道 要求: 调用 (招商报名提交接口(券报名场景))的响应:提交报名报错,提示信息里最关键的部分是“参数有误”四个字后面的内容:“券投放/核销渠道必须支持[\"shop\",\"mini_app\"]”。券核销渠道还可以只限定成“门店” 或者 “小程序”:只限定为“门店”,提示信息就是“券投放/核销渠道必须支持[\"shop\"]”。只限定为“小程序”,提示信息就是“券投放/核销渠道必须支持[\"mini_app\"]”。●提交报名的内容不满足报名要求 - 提报的券 - 不满足【对应券类型的面额】要求: 调用 (招商报名提交接口(券报名场景))的响应:提交报名报错,提示信息里最关键的部分是“参数有误”四个字后面的内容:“券的原价必须大于等于5001并且小于等于5002;券门槛金额必须大于等于50001并且小于等于50002;券优惠面额必须大于等于501并且小于等于502”。招商方案上规定了每种类型的券的具体面额相关的要求,每种券可配置的面额相关要求是不一样的,比如样例中的“直领单品特价券”,可以限制 3 种条件:门槛金额,对应的提示文案是:“券门槛金额必须大于等于50001并且小于等于50002”。商品原价金额,对应的提示文案是:“券的原价必须大于等于5001并且小于等于5002”。特价券金额,对应的提示文案是:“券优惠面额必须大于等于501并且小于等于502”。●提交报名的内容不满足报名要求 - 提报的小程序 - 不满足 与报名商户的关系 要求: 调用 (招商报名提交接口(券报名场景))的响应:提交报名报错,提示信息里最关键的部分是“参数有误”四个字后面的内容:“无小程序[2018013102117915]使用权限”。●提交报名的内容不满足报名要求 - 提报的小程序 - 不满足【可提报小程序能力等级】要求: 调用 (招商报名提交接口(券报名场景))的响应:提交报名报错,提示信息里最关键的部分是“参数有误”四个字后面的内容:“您的小程序不满足优质小程序要求”。可提报小程序能力等级 要求还可能配置限定为“合格小程序”,当配置为限定“合格小程序”时,返回的提示信息稍有变动:“您的小程序不满足合格小程序要求”。●提交报名的内容不满足报名要求 - 提报的小程序 - 不满足【可提报小程序服务素材】要求: 调用 (招商报名提交接口(券报名场景))的响应:提交报名报错,提示信息里最关键的部分是“参数有误”四个字后面的内容:“您的小程序不满足具体服务素材的要求”。●提交报名的内容不满足报名要求 - 同时不满足以上多个要求时: 调用 (招商报名提交接口(券报名场景))的响应:提交报名报错,提示信息里最关键的部分是“参数有误”四个字后面的内容:“券的原价必须大于等于5001并且小于等于5002;无小程序[2018013102117915]使用权限;您的小程序不满足优质小程序要求;您的小程序不满足具体服务素材的要求;领券结束时间必须小于等于2022-10-08 23:59:59;券核销时间天数必须大于等于10000;券门槛金额必须大于等于50001并且小于等于50002;券投放/核销渠道必须支持[\"shop\",\"mini_app\"];领券开始时间必须大于等于2022-10-01 00:00:00;券总库存数量必须大于等于999999;券优惠面额必须大于等于501并且小于等于502”。可以看到,多个条件不满足时,每个条件的提示信息都拼接进去了。●提交报名的内容不满足报名要求 - 提报的素材 - 素材规范要求的关键字段丢失: 说明:提交报名内容中,内容类型为素材的部分,是十分特殊的。素材部分的规范要求会提前校验,如果发现素材不满足素材规范要求,则会将原因直接返回。 比如,调用 (招商报名提交接口(券报名场景))核心传参:注意:素材 materials 部分,里面 data 传值中的key:“brandlogo2” 其实是错误值,最后面多了一个数字 “2”,导致提交报名后取不到目标key:“brandlogo”,进而报错。响应:提交报名报错,提示信息里最关键的部分是“业务异常”四个字后面的内容:“[校验不通过明细:[字段:brandlogo][规则:composite][位置:-1][原因:值列表不能为空]]”。●提交报名的内容不满足报名要求 - 提报的素材 - 素材规范要求的关键字段传值错误: 比如,调用 (招商报名提交接口(券报名场景))传参:注意素材 materials 部分,里面 data 传值中 aftsfileid 的值:“2a*4qsvq6aaqhuaaaaaaaaaaaaadun1aq” 其实是错误值,最前面多了一个数字 “2”,导致提交报名后无法正常解析素材信息。响应:提交报名报错,提示信息里最关键的部分是“业务异常”四个字后面的内容:“解析文件元信息返回结果为失败,request=[2a*4qsvq6aaqhuaaaaaaaaaaaaadun1aq,image],result=[{\"innererror\":{\"errorcode\":-1000,\"errormsg\":\"unknown error code:519\",\"errorurl\":\"get https://xxxx http/1.1\"},\"respcode\":\"unknown\",\"respmsg\":\"unknown error code:519\",\"succ\":false}]”。●提交报名的内容不满足报名要求 - 提报的素材 - 素材规范导致的其他错误情况: 在提交报名接口,遇到 code = 40004 的业务异常,并且提示信息 sub_msg 的开头是 “业务异常”,那么通常都是违反了 素材规范 的缘故,可以根据实际提示信息做调整,如果实在看不懂提示信息,请咨询凯发app官方网站的技术支持小二。q:报名记录不存在?a:与上面 小程序场景报名 的 q:报名记录不存在?相同。q:调用下线报名接口报错?a:与上面 小程序场景报名 的 q:调用下线报名接口报错?相同。