制券

Q：创建的商家券能否在商家平台、服务商平台查询到？

A：目前仅支持通过接口查询。

Q：商家券的券码 code，是要保证每个活动不重复吗？

A：需每个活动都不重复，否则商家在线下核销时，反查不到活动 ID activity_id。

Q：创建商家券的时候，商家品牌名、商家 LOGO、券封面等信息是如何展示的？

A：voucher_detail_images（券详细图列表）展示在商品详解栏位中。其余参数与界面展示关系如下：

Q：business_type 什么情况下入参 ISV ，什么情况下入参 ISV_FOR_MERCHANT？

A：如果是为当前账号创建商家券，需要入参 ISV；如果是帮助其它账号创建商家券，需要入参 ISV_FOR_MERCHANT。

Q：为何商家券制券接口中的 mini_app_path 已传入，但是会场链接跳转失败？

A：商家券制券接口中的 mini_app_path 需要进行 encode 编码。

Q：natural_person_limit 和 phone_number_limit 如果同时设置为 true 的情况下，领取限制是怎么样的呢？

A：默认是按支付宝账号限制的，当开启身份证或手机号限制后，只要该用户购买过券，那购买券对应的支付宝账号、身份证号、手机号码都会被记录下来，后续无论是换了支付宝账号，还是换手机号码，只要这三个中的任意一个号码和之前有购买的记录相同，都不能再购买券了。

Q：修改接口报错"未知的错误码 ACTIVITY_EXPIRED"，如何处理？

A：活动修改需要在有效期内进行。

Q：alipay.marketing.activity.ordervoucher.create 报错“异常原因：立即邀约授权|缺少代运营授权关”（需要拓展）

A：

调用 alipay.open.sp.operation.apply 接口的时候入参 app_auth_token 信息导致，去掉该值重新调用即可。

没有绑定代运营授权关系，根据接入代运营授权指引完成操作。

Q：alipay.marketing.activity.ordervoucher.create 报错“参数有误REQUEST_PARAM_ILLEGAL|异常原因：请求参数非法|打开了身份证计次和电话号码计次.则 voucherQuantityLimitPerUser 必须大于0 ”

A：natural_person_limit 和 phone_number_limit 字段入参为 true 的情况下，voucher_quantity_limit_per_user 参数必须要入参。

Q：alipay.marketing.activity.ordervoucher.create 报错“REQUEST_PARAM_ILLEGAL|异常原因：请求参数非法|用户引导信息 miniAppPath 有值，则 miniAppId 必须有值”

A：入参了 mini_app_path 参数的情况下，mini_app_id 参数必须要入参。

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。

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] 元特价券

领券

Q：领券通知信息能返回发券渠道和发券商家吗？

A：目前字段里没有渠道相关信息，区分哪个商家发的券需要商家在创建的时候自行维护活动 ID 和券的归属方。

Q：为何用户通过插件领取优惠券时报错：“活动触发出现业务异常, errorMsg=[10000005]参数错误, campId不可为空”？

A：商家券活动未激活成功，原因如下：

没有调用追加接口。

没收到创建消息回调。

没收到追加消息回调。

Q：业务异常 AGENCY_RELATION_SHIP_IS_NULL|异常原因：立即邀约授权|缺少代运营授权关系

A：没有绑定代运营授权关系，根据接入代运营授权指引完成操作。

Q：业务异常 STORE_ID_INVALID|异常原因：门店无效|门店无效.请检查门店是否存在.并且确认传入的门店是否属于活动的归属者(belong_merchant_info)

A：入参的门店信息与当前券的归属方不同。

Q：业务异常 MINI_APP_ID_INVALID|异常原因：门店无效|小程序无效.请检查小程序是否存在,并且小程序属于该商家 pid，如何处理？

A：mini_app_id、shop_ids、real_shop_ids 必须三选一传入。

核销

Q：商家券用户在线下核销，门店人员使用扫码枪扫码后，如果我们没有调用接口核销，卡券还是会在卡包里吗？在卡包里的已经被扫码枪扫过的券，下次展示给扫码会是什么效果？提示已使用过吗？

A：若没有核销，券还是会展示在卡包中，下次用户还是可以使用的。

Q：目前有接口可以查询用户可用的商家券列表吗？

A：暂时没有，需要商家/服务商自行记录。

Q：用户使用券的相对时间的计算规则是怎么样的？

A：按照接收到领券通知的 event_time 时间加上创建券活动时入参的可核销时间（24 小时制）计算。

Q：核销接口报错{"code":"BIZ_ERROR","msg":"业务异常券码状态不正确"}，如何处理？

A：当前商家券活动下，券码已核销。

Q：核销接口报错{"code:"SYSTEM_ERROR","msg":"下游系统调用异常"}，如何处理？

A：创建的商家券活动未追加，活动未生效导致，并且未领券直接核销了。

常见问题

制券#

Q：创建的商家券能否在商家平台、服务商平台查询到？#

Q：商家券的券码 code，是要保证每个活动不重复吗？#

Q：创建商家券的时候，商家品牌名、商家 LOGO、券封面等信息是如何展示的？#

#

Q：business_type 什么情况下入参 ISV ，什么情况下入参 ISV_FOR_MERCHANT？#

Q：为何商家券制券接口中的 mini_app_path 已传入，但是会场链接跳转失败？#

Q：natural_person_limit 和 phone_number_limit 如果同时设置为 true 的情况下，领取限制是怎么样的呢？#

Q：修改接口报错"未知的错误码 ACTIVITY_EXPIRED"，如何处理？#

Q：alipay.marketing.activity.ordervoucher.create 报错“异常原因：立即邀约授权|缺少代运营授权关”（需要拓展）#

Q：alipay.marketing.activity.ordervoucher.create 报错“参数有误REQUEST_PARAM_ILLEGAL|异常原因：请求参数非法|打开了身份证计次和电话号码计次.则 voucherQuantityLimitPerUser 必须大于0 ”#

Q：alipay.marketing.activity.ordervoucher.create 报错“REQUEST_PARAM_ILLEGAL|异常原因：请求参数非法|用户引导信息 miniAppPath 有值，则 miniAppId 必须有值”#

Q：是否支持制券账号 PID 和发券/核销小程序归属 PID 不一致？#

Q：券名称拼接规则为何？#

领券#

Q：领券通知信息能返回发券渠道和发券商家吗？#

Q：为何用户通过插件领取优惠券时报错：“活动触发出现业务异常, errorMsg=[10000005]参数错误, campId不可为空”？#

Q：业务异常 AGENCY_RELATION_SHIP_IS_NULL|异常原因：立即邀约授权|缺少代运营授权关系#

Q：业务异常 STORE_ID_INVALID|异常原因：门店无效|门店无效.请检查门店是否存在.并且确认传入的门店是否属于活动的归属者(belong_merchant_info)#

Q：业务异常 MINI_APP_ID_INVALID|异常原因：门店无效|小程序无效.请检查小程序是否存在,并且小程序属于该商家 pid，如何处理？#

核销#

Q：商家券用户在线下核销，门店人员使用扫码枪扫码后，如果我们没有调用接口核销，卡券还是会在卡包里吗？在卡包里的已经被扫码枪扫过的券，下次展示给扫码会是什么效果？提示已使用过吗？#

Q：目前有接口可以查询用户可用的商家券列表吗？#

Q：用户使用券的相对时间的计算规则是怎么样的？#

Q：核销接口报错{"code":"BIZ_ERROR","msg":"业务异常券码状态不正确"}，如何处理？#

Q：核销接口报错{"code:"SYSTEM_ERROR","msg":"下游系统调用异常"}，如何处理？#

制券