更新时间：2023-07-17 17:05:54文档更新记录 >收藏订阅更新我的文档设置返回文档1 制券1.1 q：创建的商家券能否在商家平台、服务商平台查询到？a：目前仅支持通过接口查询。1.2 q：商家券的券码 code，是要保证每个活动不重复吗？a：需每个活动都不重复，否则商家在线下核销时，反查不到活动 id activity_id。1.3 q：创建商家券的时候，商家品牌名、商家 logo、券封面等信息是如何展示的？a：voucher_detail_images（券详细图列表）展示在商品详解栏位中。其余参数与界面展示关系如下：1.4 q：business_type 什么情况下入参 isv ，什么情况下入参 isv_for_merchant？a：如果是为当前账号创建商家券，需要入参 isv；如果是帮助其它账号创建商家券，需要入参 isv_for_merchant。1.5 q：为何商家券制券接口中的 mini_app_path 已传入，但是会场链接跳转失败？a：商家券制券接口中的 mini_app_path 需要进行 encode 编码。1.6 q：natural_person_limit 和 phone_number_limit 如果同时设置为 true 的情况下，领取限制是怎么样的呢？a：默认是按支付宝账号限制的，当开启身份证或手机号限制后，只要该用户购买过券，那购买券对应的支付宝账号、身份证号、手机号码都会被记录下来，后续无论是换了支付宝账号，还是换手机号码，只要这三个中的任意一个号码和之前有购买的记录相同，都不能再购买券了。1.7 q：修改接口报错"未知的错误码 activity_expired"，如何处理？a：活动修改需要在有效期内进行。1.8 q：alipay.marketing.activity.ordervoucher.create 报错“异常原因：立即邀约授权|缺少代运营授权关”（需要拓展）a：1调用 alipay.open.sp.operation.apply 接口的时候入参 app_auth_token 信息导致，去掉该值重新调用即可。2没有绑定代运营授权关系，根据 指引完成操作。1.9 q：alipay.marketing.activity.ordervoucher.create 报错“参数有误request_param_illegal|异常原因：请求参数非法|打开了身份证计次和电话号码计次.则 voucherquantitylimitperuser 必须大于0 ”a：natural_person_limit 和 phone_number_limit 字段入参为 true 的情况下，voucher_quantity_limit_per_user 参数必须要入参。1.10 q：alipay.marketing.activity.ordervoucher.create 报错“request_param_illegal|异常原因：请求参数非法|用户引导信息 miniapppath 有值，则 miniappid 必须有值”a：入参了 mini_app_path 参数的情况下，mini_app_id 参数必须要入参。1.11 q：是否支持制券账号 pid 和发券/核销小程序归属 pid 不一致？a：支持。假设：商家券对接的主体账号（假设为pid a）和承接发券/核销的小程序（指接口传入的 customer_guide#voucher_use_guide#mini_app_id 的小程序）的主体账号（pid b）不一致，需要 pid a 邀请 pid b 授权，操作方式如下：●pid a 账号登录，进入 账号中心 > 授权管理。●选择 商户授权 > 授权给我的商家，并点击 邀请商户授权。●选择 经营推广 场景，点击下一步。●获取二维码/url 链接，发送至 pid b，并引导其完全授权确认说明：代运营模式下，此处 pid a 为创建券活动时传入的 belong_merchant_info#merchant_id。1.12 q：券名称拼接规则为何？当前不支持商家定义券名称；支付宝将通过拼接字段的方式向用户展示券名称。拼接规则如下：券类型拼接规则（字段均来自接口：alipay.marketing.activity.ordervoucher.create 创建商家券活动)全场满减券●全场 [fix_voucher#amount] 元券●[brand_name] 全场券●[brand_name] 全场[fix_voucher#amount]元券全场折扣券●全场 [discount_voucher#discount] 折券●[brand_name] 全场券●[brand_name] 全场 [discount_voucher#discount] 折券单品满减券●[fix_voucher#goods_name] [fix_voucher#amount] 元券●[brand_name] [fix_voucher#goods_name] 券●[brand_name] [fix_voucher#goods_name][fix_voucher#amount]元券单品折扣券●[discount_voucher#goods_name] [fix_voucher#amount] 折券●[brand_name] [discount_voucher#goods_name] 券●[brand_name] [discount_voucher#goods_name][fix_voucher#amount]折券单品特价券●[special_voucher#goods_name] [special_voucher#special_amount] 元特价券●[brand_name] [special_voucher#goods_name] 特价券●[brand_name] [special_voucher#goods_name] [special_voucher#special_amount] 元特价券2 领券2.1 q：领券通知信息能返回发券渠道和发券商家吗？a：目前字段里没有渠道相关信息，区分哪个商家发的券需要商家在创建的时候自行维护活动 id 和券的归属方。2.2 q：为何用户通过插件领取优惠券时报错：“活动触发出现业务异常, errormsg=[10000005]参数错误, campid不可为空”？a：商家券活动未激活成功，原因如下：1没有调用追加接口。2没收到创建消息回调。3没收到追加消息回调。2.3 q：业务异常 agency_relation_ship_is_null|异常原因：立即邀约授权|缺少代运营授权关系a：没有绑定代运营授权关系，根据 指引完成操作。2.4 q：业务异常 store_id_invalid|异常原因：门店无效|门店无效.请检查门店是否存在.并且确认传入的门店是否属于活动的归属者(belong_merchant_info) a：入参的门店信息与当前券的归属方不同。2.5 q：业务异常 mini_app_id_invalid|异常原因：门店无效|小程序无效.请检查小程序是否存在,并且小程序属于该商家 pid，如何处理？a：mini_app_id、shop_ids、real_shop_ids 必须三选一传入。3 核销3.1 q：商家券用户在线下核销，门店人员使用扫码枪扫码后，如果我们没有调用接口核销，卡券还是会在卡包里吗？在卡包里的已经被扫码枪扫过的券，下次展示给扫码会是什么效果？提示已使用过吗？a：若没有核销，券还是会展示在卡包中，下次用户还是可以使用的。3.2 q：目前有接口可以查询用户可用的商家券列表吗？a：暂时没有，需要商家/服务商自行记录。3.3 q：用户使用券的相对时间的计算规则是怎么样的？a：按照接收到领券通知的 event_time 时间加上创建券活动时入参的可核销时间（24 小时制）计算。3.4 q：核销接口报错{"code":"40004","msg":"business failed","sub_code":"biz_error","sub_msg":"业务异常券码状态不正确"}，如何处理？a：当前商家券活动下，券码已核销。3.5 q：核销接口报错{"code":"40004","msg":"business failed","sub_code":"system_error","sub_msg":"下游系统调用异常"}，如何处理？a：创建的商家券活动未追加，活动未生效导致，并且未领券直接核销了。
