收藏
评论

【商家券API】常见问题 QA官方


文档地址 : 商家券


Q1:创建的商家券数量和实际的数量为什么不一致?

A1:该字段已经做了调整,具体调整情况麻烦参看文档最上方的调整周知。


Q2:商家券的APP业务配置是怎么样的?

A2:你好建议参考这篇文档【商家券】APPID业务配置规则说明


Q3:商家券核销方式是否都支持返佣?最高返佣是哪种方式?

A3:目前文档所支持的核销方式都支持返佣,跳小程序给到最高。


Q4:商家券消费门槛字段transaction_minimum不填写为什么会报错?

A4:该字段属于必填字段。可以填写为0。


Q5:使券失效接口是针对一张券还是一个批次失效

A5:是一张张失效,不是整个批次失效(请求参数中的coupon_code就是一张券)。


Q6:商家券判断是线上还是线下。是看发券场景还是看核销场景(返佣)

A6:如果是返佣的话   是看商家券关联的交易 是否是小程序交易。


Q7:商家券领券回调如何接收

A7:

  1. 需要在商户平台开通营销事件推送的能力 ;
  2. 通过该接口进行设置领券回调地址。


Q8:商家券领券回调我这边正常设置了地址,为什么接收不到回调信息。

A8:

  1. 需要检查您这边是否有正确设置apiv3。设置步骤如下:微信商户平台—>账户设置—>API安全—>设置apiv3】;
  2. 请检查回调url是否能正常公网访问;
  3. 如果是http地址,建议更换支持https;
  4. 是否开启了防火墙,如果开户了防火墙,请添加微信支付营销回调IP:

上海电信出口网段101.226.103.0/25  

上海联通出口网段 140.207.54.0/25  

上海CAP出口网段121.51.58.128/25


Q9:支付券创建后激活返回错误:卡包信息尚未注册完成,请稍后重试?

A9:券创建后需等待1分钟左右才能激活使用。


Q10:调用领券事件回调通知API,收到两次通知且两次通知里的coupon_code不一样,是什么原因?

A13:API发券,本来就会触发两次发券,商户可调API查询用户券列表就可以确认这个用户发了几张券。


Q10:卡包列表页的样式是取创建商家券API中的哪些字段?

A14:取的批次名称与商户简称。


Q11:下图中绿色框的这个二维码,是微信卡包添加的吗? 这个要怎么使用呢?红色框的 “推荐使用微信支付”  和  “查看优惠券详情  ” 这两个文案 都是默认添加的吗?

A11:

  1. 滴码核销,不用的话,可以做屏蔽,创建商家券文档样式信息中custom_entrance下的code展示模式 ;
  2. 是的,填NOT_SHOW即可不展示code。


Q12:调用修改商家券基本信息API返回:无法将输入源“/body/stock_id”映射到目标字段“批次号”中,此字段并非多重字段但被输入源“/uri_template/stock_id”映射过了

A12:参数stock_id传到请求url里面,body里面就不用传这个参数了,请注意。


Q13:创建商家券接口,使用的goods_name字段是展示在哪里的?

A13:展示在商家券详情里面的优惠说明中。


Q14:创建的商家券在卡包里面都归在其他商家里面了,怎么才能像京东购物一样有一个独立的分类?

A14:独立的分类,需要找对接的微信运营申请创建“卡包商家”。


Q15:创建商家券API,核销规则中的券可核销时间最长支持多久?

A15:最长支持1年、


Q16:小程序发券插件接口频率是多少?

A16:频率限制1000/s。


Q17:调用创建商家券接口返回:非法敏感图片?

A17:请求参数商户logo(merchant_logo_url)url不是通过营销图片上传API上传,请检查确认。


Q18:设置了回调地址, 调用发券插件, 发放成功 ,但没有收到回调通知?

A18:请按照以下几点检查:

  1. 请检查回调url是否能正常公网访问,不能是中文域名;
  2. 回调url是不能带参数的,请注意;
  3. 是否开启了防火墙,如果开户了防火墙,请添加微信支付回调IP(微信支付回调通知出口IP列表 );
  4. 是否有正确解析及接收回调通知;
  5. APIV3密钥没有设置,设置路径:登录微信支付商户平台,进入【账户中心】->【账户设置】->【API安全】->【APIv3密钥】。


Q19:怎么查询商家券批次已经发放多少张券?

A19:可以调用查询商家券详情API查询确认,返回的参数批次发放情况就有显示(文档地址


Q20:调用根据过滤条件查询用户券接口返回:你没有权限查询该批次,必须为批次的创建商户或者授权商户?

A20:请按照以下几点排查:

  1. 请求头商户号错误,请求头商户号得是制券商户号,不能是归属商户号;
  2. 请求url中的商户号必须要有一个与调用商户号一致。比如是创建商户号调用的,就必须要填creator_merchant,belong_merchant可填可不填。


Q21:调用创建商家券API返回:传入的小程序appid或商户appid,必须与调用方商户号存在关联关系?

A21:请按照以下几点排查:

  1. 商户传入的APPID得是与调用方商户号(即请求头里面的商户号)有绑定关系的APPID;
  2. 商户传入的APPID得是归属商户号有绑定关系的APPID;
  3. 间连模式,传入的APPID得是与渠道商商户号有绑定关系的APPID;
  4. 绑定关系的说明


Q22:商家券修改批次预算接口中当前批次和目标批次有什么区别?

A22:一个是当前的即未修改的。一个是需要修改的值即修改后的


Q23:创建商家券接口返回:只允许普通商户和子商户给自己创建批次

A23:请按照以下几点排查:

1,归属商户号belong_merchant错误,这个参数规则如下:

a,服务商模式,请填写为服务商下的子商户号

b,普通直连商户模式,请填写为普通直连商户的商户号

c,间连模式,请填写为间连子商户号

2,归属商户号校验规则指引请查看:https://pay.weixin.qq.com/wiki/doc/apiv3/open/pay/chapter5_2_2.shtml#part-7

3,请求参数中归属商户号belong_merchant中有空格,请去掉空格


Q24:商家券详情里的优惠说明显示规则如下:

1,换购券:“商家券批次名称stock_name”和“适用商品范围goods_name”拼接

2,满减券:   适用商品范围goods_name

3,折扣券:“折扣比例discount_percent”和“适用商品范围goods_name”拼接


Q25:创建商家券接口返回报错:{ "code": "INVALID_REQUEST", "message": "商户票据校验失败}

A25:请按照以下几点排查:

1,解析json串失败,请确认json串里面是否有注释符号,请去掉注释符号后重试

1,系统有抖动,批次实际已经创建成功。可以再拿原有的创建参数重试一次即可


Q26:调用营销补差付款API返回:微信支付订单商户单号与券核销商户单号不一致

A26:需要请求核销商家券API的use_request_no与微信支付下单的out_trade_no保持一致,

核销use_request_no = 下单out_trade_no,请注意!


Q27:创建商家券接口返回:创建请求重入,但本次请求与上次请求信息不一致

A27:重复请求创建商家券批次,需更换不同的商户请求单号out_request_no


Q28:营销图片上传接口,用官方的PHP demo ,返回的是空数组,是什么原因

A28:图片地址是在  $resp->getBody()->getContents() 里面。 $resp->getBody() 取不到结果。



最后一次编辑于  7小时前
收藏
登录 后发表内容