收藏
评论

【发放代金券API】 常见问题官方


接口url :https://api.mch.weixin.qq.com/v3/marketing/favor/users/{openid}/coupons


文档地址:发放代金券接口


Q1:商户号A调用接口,可以发放其他商户号(商户号B)创建的代金券吗?如何实现?

A1:商户号A默认只允许发放本商户号创建的代金券,如需发放商户号B创建的代金券,可参考以下指引:

商户号A、商户号B需要分别开通“跨商户号发券”权限。开通权限后,商户号A制券时,会出现“可发券商户”配置项。商户号A将商户号B添加为“可发券商户”后,商户号B即可调用发券接口发放该批次代金券。

跨商户发券调用接口时需注意,接口传入的参数中,除stock_creator_mchid、stock_id为制券方提供的数据外,其余数据均为接口调用方的数据。


附:“跨商户号发券”权限申请流程:

申请流程:发邮件给weixincard@tencent.com,抄送himhe@tencent.com、marshalzhou@tencent.com,邮件名称:【跨商户号发券申请】。邮件提供内容:说明申请原因、制券的商户号、发券商户号,批量申请请提供表格附件。权限by商户号申请,已有权限商户号无需重复申请


Q2:通过接口发放的代金券,是否支持插入微信卡包?

A2:通过接口发放的代金券,不会自动插入微信卡包,

如需申请自动插入卡包的能力,可向对接的微信支付行业运营同事了解申请流程(仅向部分商户开放)。代金券发券成功后,即使不插入微信卡包,也不会影响使用。


Q3:发放代金券API返回报错“参数错误,请核对文档要求”,是什么原因?

A3:请参考文档核对参数,着重核对以下两项:

  1. stock_creator_mchid要填写创建批次商户号,且stock_creator_mchid与stock_id是否有对应关系;
  2. 如不需要,请勿传入coupon_value、coupon_minimum两项参数。


Q4:发放代金券API返回报错“商户号和APPID不匹配”,是什么原因?

A4:接口传入的appid需要与调用接口的商户号(即请求头中的商户号)有绑定关系

普通商户可登陆商户平台,在“产品中心-APPID授权管理”中完成绑定,可参考指引

普通服务商可支持自助绑定同主体appid,绑定总数量为3个,操作指引


Q5:发放代金券API返回报错“用户非法”,是什么原因?

A5:报错“用户非法”的原因是,调用发放的代金券批次开启了安全防刷,且该用户被系统判定为疑似羊毛党、灰产用户、机器账号,故发放失败,

如对发券无风控要求,可在创建代金券时,关闭“安全防刷”选项。


Q6:发放代金券API返回报错“用户已达最大领券次数”,是什么原因?

A6:可根据以下两种情况排查:

  1. 若该代金券批次未开启“自然人拦截”,则该openid已达到该批次设定的单用户领取上限;
  2. 若该代金券批次开启了“自然人拦截”,则与该openid绑定了相同身份证/银行卡的所有微信账户合计已达到领取上限。


Q7:发放代金券API返回报错“签名错误”,是什么原因?

A7:可参考指引

以下为代金券V3接口:

商户侧验证微信返回签名的验签示例(PHP)

提取码:yx8o

验证签名工具

提取码:wujv


最后一次编辑于  2023-02-10
收藏

16 个评论

  • 特务小强
    特务小强
    2022-05-18

    发放代金券请求频率有限制么?


    2022-05-18
    赞同
    回复 1
    • toby
      toby
      2022-12-23
      貌似是有滴   强哥
      2022-12-23
      回复
  • 四月天
    四月天
    2022-01-25

    发放代金券批次API接口,统一批次号用户领取3次,微信卡包只有一张,接口返回coupon_id都是一样的,这个是对的吗,还是有其他原因?

    2022-01-25
    赞同
    回复
  • 老伍
    老伍
    2021-07-16

    我们有活动给用户发放立减金,在给有些用户发券时返回:err_code=ACCOUNTERROR, return_msg=, result_code=FAIL, err_code_des=账号行为异常,无法领券, return_code=SUCCESS,这种是什么情况?

    2021-07-16
    赞同
    回复
  • 东泽
    东泽
    2021-06-25

    跨商户发券调用接口时需注意,接口传入的参数中,除stock_creator_mchid、stock_id为制券方提供的数据外,其余数据均为接口调用方的数据

    ——————————

    这个方法亲自试了下,报错

    2021-06-25
    赞同
    回复 1
    • 庞🤐
      庞🤐
      2023-01-10
      你好 这个问题解决了吗
      2023-01-10
      回复
  • ZCheung
    ZCheung
    2021-05-14

    返回“该批次不支持API发放”是什么原因

    2021-05-14
    赞同
    回复 1
    • 飞鱼
      飞鱼
      2021-09-03
      建券的时候,发放方式设置不对吧
      2021-09-03
      回复
  • 守望
    守望
    2020-09-12

    请问如何联系微信支付行业运营同事?我想申请开通插入卡包的权限,不然无法在支付有礼中使用

    2020-09-12
    赞同
    回复 2
    • 星
      2021-04-26
      发个邮件就好啦
      2021-04-26
      回复
    • .
      .
      2021-09-16
      可以提供一下邮件地址吗
      2021-09-16
      回复

正在加载...

登录 后发表内容