收藏
评论

【营销工具】发放代金券API Q&A官方

发放代金券接口

接口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为制券方提供的数据外,其余数据均为接口调用方的数据

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

发邮件给v_yranzhou@tencent.com、v_jjinglliu@tencent.com、anthonylin@tencent.com,说明申请原因,以及制券商户号、发券商户号


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授权管理”中完成绑定,可参考指引:https://kf.qq.com/faq/1801116VJfua1801113QVNVz.html

服务商可通过以下流程申请绑定:发送邮件给v_jjinglliu@tencent.com、anthonylin@tencent.com,邮件名称:【服务商APPID多绑申请】商户号+商户名。邮件正文内容:申请绑定背景、APPID业务介绍、APPID、APPID主体名称、需要绑定的商户号、商户主体名称。(仅支持同主体APPID及商户号绑定,每个服务商商户号最多可以绑3个APPID)


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

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

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


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

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

1)若该代金券批次未开启“自然人拦截”,则该openid已达到该批次设定的单用户领取上限

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


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

A7:可参考以下指引:https://wechatpay-api.gitbook.io/wechatpay-api-v3/chang-jian-wen-ti/qian-ming-xiang-guan

以下为代金券V3接口,

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

链接:https://pan.baidu.com/s/1ojWl4o3btpxymQmvRjeKBg

提取码:yx8o

验证签名工具:

链接:https://pan.baidu.com/s/1ixOAnYyZVW13dFr0jWVpvw

提取码:wujv

最后一次编辑于  06-28
收藏
登录 后发表内容