Q1:商家券接口文档参数字段”适用商品范围goods_name”是在哪里展示的?
A1:在商家券详情里的优惠说明展示,具体展示规则如下:
- 换购券:“商家券批次名称stock_name”和“适用商品范围goods_name”拼接
- 满减券: 适用商品范围goods_name
- 折扣券:“折扣比例discount_percent”和“适用商品范围goods_name”拼接
Q2:调用创建商家券接口返回“传入的小程序appid或商户appid,必须与调用方商户号存在关联关系”,是什么原因?
A2:请按照以下几点排查:
- 商户传入的APPID得是与调用方商户号(即请求头里面的商户号)有绑定关系的APPID;
- 商户传入的APPID得是归属商户号有绑定关系的APPID;
- 间连模式,传入的APPID得是与渠道商商户号有绑定关系的APPID;
绑定说明指引
Q3:调用创建商家券接口返回“只允许普通商户和子商户给自己创建批次”怎么解决?
A3:请按照以下几点排查:
1、归属商户号belong_merchant错误,这个参数规则如下:
- 服务商模式,请填写为服务商下的子商户号
- 普通直连商户模式,请填写为普通直连商户的商户号
- 间连模式,请填写为间连子商户号
2、归属商户号校验规则指引请查看指引文档
3、请求参数中归属商户号belong_merchant中有空格,请去掉空格
Q4:调用创建商家券接口返回“创建请求重入,但本次请求与上次请求信息不一致”是什么原因?
A4:重复请求创建商家券批次,请更换不同的商户请求单号out_request_no
Q5:创建商家券API,核销规则中的券可核销时间最长支持多久?
A5:最长支持1年
Q6:商家券的APPID业务配置规则是怎么样的?
A6:你好,建议参考这篇文档【商家券】APPID业务配置规则说明。
Q7:商家券核销方式是否都支持返佣?最高返佣是哪种方式?
A7:目前文档所支持的核销方式都支持返佣,跳小程序给到最高。
Q8:使券失效接口是针对一张券还是一个批次失效?
A8:是针对领取后未核销的单张券进行失效处理,不是针对批次失效。
Q9: 调用发券插件发放成功 ,但没有收到领券通知,是什么原因?
A9:请按照以下几点检查:
- 请检查回调url是否能正常公网访问,不能是中文域名;
- 回调url不能带参数,必须支持https,请检查确认;
- 是否有正确解析及接收回调通知;
- APIV3密钥没有设置,设置路径:登录微信支付商户平台,进入【账户中心】->【账户设置】->【API安全】->【APIv3密钥】
- 是否开启了防火墙,如果开启了防火墙,请添加微信支付营销回调IP:
- 上海电信出口网段101.226.103.0/25
- 上海联通出口网段 140.207.54.0/25
- 上海CAP出口网段121.51.58.128/25
Q10:卡包列表页的样式是取创建商家券API中的哪些字段?
A10:取的批次名称与商户简称。
Q11:商家券样式中的二维码,是微信卡包添加的吗? 这个要怎么使用呢?
A11:不是微信卡包添加的。这个二维码,是商户在创建商家券接口自定义入口字段custom_entrance下的code展示模式添加的 ;如果不需要这个二维码,可以不传字段“code展示模式”
Q12:调用修改商家券基本信息API返回:无法将输入源“/body/stock_id”映射到目标字段“批次号”中,此字段并非多重字段但被输入源“/uri_template/stock_id”映射过了
A12:参数stock_id传到请求url里面了,body里面就不用传这个参数了,请注意。
Q13:创建的商家券在卡包里面都归在其他商家里面了,怎么才能像京东购物一样有一个独立的分类?
A13:独立的分类,需要找对接的微信运营申请创建“卡包商家”。
Q14:调用创建商家券接口返回:非法敏感图片?
A14:请求参数字段 商户logo(merchant_logo_url)url必须是通过营销图片上传API获取的,不能用其他非营销图片上传接口获取
Q15:怎么查询商家券批次已经发放多少张券?
A15:可以调用查询商家券详情API查询确认,返回的参数批次发放情况就有显示
Q16:调用根据过滤条件查询用户券接口返回:你没有权限查询该批次,必须为批次的创建商户或者授权商户?
A16:请按照以下几点排查:
- 请求头商户号错误,请求头商户号必须是制券商户号,不能是归属商户号;
- 请求url中的商户号必须要有一个与调用商户号一致。比如是创建商户号调用的,就必须要填creator_merchant,belong_merchant可填可不填。
Q17:商家券修改批次预算接口中当前批次和目标批次有什么区别?
A17:一个是当前的即未修改的;一个是需要修改的值即修改后的。
Q18:创建商家券接口返回报错:{ "code": "INVALID_REQUEST", "message": "商户票据校验失败}
A18:请按照以下几点排查:
- 解析json串失败,请确认json串里面是否有注释符号,请去掉注释符号后重试
- 系统有抖动,批次实际已经创建成功,可以再拿原有的创建参数重试一次即可
Q19:调用营销补差付款API返回:微信支付订单商户单号与券核销商户单号不一致
A19:请注意以下两点:
- 请求核销商家券API的use_request_no与微信支付统一下单中的out_trade_no需保持一致,
- 核销use_request_no = 下单out_trade_no
Q20:营销图片上传接口,用官方的PHP demo ,返回的是空数组,是什么原因?
A20:图片地址是在 $resp->getBody()->getContents() 里面。 $resp->getBody() 取不到结果。
Q21:如果商家券被用户删除了,那我们请求微信核销商家券的话,会有什么提示吗?
A21:会报错。错误码 400 RESOURCE_NOT_EXISTS 券已被删除
Q22:调用“根据过滤条件查询用户券API”没有返回参数“goods_name”,是什么原因?
A22:当返回数据条数大于10条的时候,goods_name、merchant_logo_url、coupon_image_url都不做返回,原因是这些信息如果商户填的过长,很容易导致回包数据大小超过限制而使接口失败。 商户如果需要全量的信息,建议使用查询单张券的API获取。
Q23:创建商家券接口,参数字段“领取后N天开始生效”,这里的N天是怎么算的?
A23:是按照自然天算的(比如n=2,就是后天0点生效)