收藏
评论

【H5/小程序插件/JSAPI 发券API】常见问题官方


文档地址:H5发劵小程序插件发券JSAPI发券


Q1:调用小程序发券插件API/H5发券API返回:签名验证失败?

A1:请按照以下几点进行排查:

  1. 使用签名检查工具选自定义参数校验签名算法是否有误;
  2. 确认秘钥是否有误,要使用发券商户号的秘钥,秘钥是在商户平台配置,如果不确定密钥是否正确,可以尝试设置与原先设置的一样的密钥。密钥设置指引
  3. 确认接口实际的请求参数与生成签名原串的参数一致,不能增加或缺少参数(比如请求中有coupon_code,实际签名里也要有coupon_code);
  4. 确认参数的大小写,参数名与接口文档一致;
  5. 签名原串的参数值使用原始值,不需要encode;
  6. 接口需要使用UTF-8编码 。


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

A2:频率限制1000/s。


Q3:小程序插件发券API发券返回:DUPREQUEST?

A3:请求中传了参数coupon_code,意思是已通过该发券凭证给用户发券,不能重复使用coupon_code。


Q4:调用小程序打开商家券券详情接口返回:openCard:missing auguments?

A4:请求参数错误,严格按照文档要求传参,严格区分参数字段大小写。


Q5:H5发券API返回:272756757是什么原因?

A5:用户openid对应的appid必须与发券商户号有绑定关系,请检查用户openid对应的appid与发券商户号是否有绑定关系

openid校验规则如下:

  1. 可用归属商户号绑定的APPID获取的openid
  2. 可用发券商户绑定的APPID获取的openid
  3. 获取openid请查看文档


Q6:调用商家券jsapi AddCard返回:invalid card_id?

A6:商家券H5的Jsapi已经支持拉起插卡,但是小程序的jsapi目前还不支持,小程序内目前只能通过小程序插件来领取商家券。


Q6:调用商家券jsapi AddCard返回:-202?

A6:原因是:查询不到该券,请确认批次号与coupon_code是否匹配,请排查确认。


Q7:通过jsApi 发商家券,一次最多支持发几张券?

A7:不同批次一次性最多领取10张 ; 同一批次一次性最多领取3张


Q8:小程序发券插件中, 发券商户号send_coupon_merchant是指服务商商户号还是服务商子商户号?发券参数中发券凭证(out_request_no)是否可随机生成?

A8:请参考以下两点:

  1. 直连模式,发券商户号是指直连商户号即创建券商户号;
  2. 服务商模式,发券商户号是指服务商商户号即创建券商户号。发券参数中发券凭证(out_request_no)可以随机生成。


Q9:H5发券接口,请求参数openid是小程序的用户openid还是微信公众号的openid?

A9:请参考以下两点:

  1. H5发券,验证的是调用发券接口商户号与传入的appid的绑定关系(要用这个绑定的APPID获取openid);
  2. H5发券,请求里面的openid,也可以用这个发券url里面的券批次ID对应的券归属商户号绑定的sub_appid来获取这个发券url里面的openid(配置的sub_appid不管是小程序的还是公众号的,只要用这个sub_appid获取的openid都可以)。


Q10:H5发券API,目前是否支持一键领取多张商家券?

A10:不支持,目前只能1张。


Q11:H5发券接口是否支持发放代金券?

A11:H5发券接口当前仅支持在H5场景下发放【微信支付商家券】 , 暂不支持发放【微信支付代金券】。


Q12:H5发券接口返回:批次不存在?

A12:请求参数中批次不存在或者批次ID填写错误,请仔细排查确认。


Q13:调用H5发券接口返回:抱歉,领取失败。你已经领过这张券了 272756753

A13:请按照以下几点进行排查:

  1. 用户已领取过这张券。同一张券,不能重复领取多次,请检查下设置是否有问题
  2. 发券凭证out_request_no重复使用,如果单个用户要多次领取的话需要每次都保持唯一


最后一次编辑于  2022-03-23
收藏

4 个评论

  • 子非鱼
    子非鱼
    06-28

    send-coupon组件的out_request_no参数规则有漏洞,这个参数是邀请每个劵批次id下每隔用户只能领取一次,也就是说同一个out_request_no只要不同的账户也是可以直接使用并生成相同的sign的(亲自尝试验证过),这个插件发劵时调的接口中能看到sign的,假如把这个sign保存下来,别人就可以通过脚本生成多个虚拟的微信号然后都使用这个sign进行领劵操作了,这样会有恶意刷劵的情况(尽管刷出来的劵可能在虚拟账号上不能用,但是会给发劵方造成很大影响)

    06-28
    赞同
    回复
  • 世界和平
    世界和平
    2021-10-22

    h5调用支付分的时候提示system:access_denied

    2021-10-22
    赞同
    回复
  • 青寒
    青寒
    2021-03-30

    支持!

    2021-03-30
    赞同
    回复
  • 北望沣渭
    北望沣渭
    2021-03-30

    使用「官方小程序发券插件」发送「商家券」签名的二三事儿


    2021-03-30
    赞同
    回复
登录 后发表内容