有赞新零售社区

发帖
API使用问题»有赞云礼品卡和储值卡查询接口问题

[API调用-商品/交易] 有赞云礼品卡和储值卡查询接口问题

未来 06-09 1621 浏览 6 评论 | 只看楼主 [打印]
一、礼品卡接口问题
调用youzan.cardvoucher.giftcard.detail.query/3.0.1 礼品卡接口 请求参数{"mobile": "xxxxxxxxxxx", "page": 1, "page_size": 50}  返回"total_count":值是4033即这个应用下所有用户的激活和未激活的礼品卡。
礼品卡的 "expire_begin_time": 1599023437000 即时间是"2020-09-02 13:10:37",  "update_time": 1655517021000 即时间是"2022-06-18 09:50:21","expire_end_time":253402271999000  即时间是"9999-12-31 23:59:59"
1、礼品卡接口如何按手机号码查询指定用户下的礼品卡信息,现在接口返回所有礼品卡,要我们调用api不停分页查询n次,对于我们开说明开销很大,对于有赞云服务器来说负载也大,因为一个用户就要查询n次,调用n次api接口。
请帮助给出具体按手机号码查询礼品卡方法,或者说 其他用户标识来查询指定用户的礼品卡的api调用方法?
2、是否是要更新有赞云sdk到指定版本? 如果是请提供下载链接和具体版本,我们后台是php源码实现的
3、如何在尽可能少的查询次数获取指定用户的礼品卡信息?请帮助给出api查询接口请求参数构造示例

二、储值卡接口问题
调用 储值卡接口 请求参数{"mobile": "xxxxxxxxxxx"} 返回参数中 "value_card_type" : 1002  根据api接口文档描述数是: "卡类型,1001:储值余额;1002:储值卡(即礼品卡)"。
储值卡查询出来的返回参数存在卡号"card_no"、手机号码"mobile"与礼品卡接口查询存在相同的卡,此时储值卡"value_card_type"值是1002,而且储值卡"denomination"值和相同的礼品卡查询返回参数的"sum_dnom"值也相同 (见附件图片 01.jpg和02.jpg)
4、储值卡接口和礼品卡查询的卡号"card_no"、手机号码"mobile"相同卡是否是同一个卡?
需要我们调用者自己来比对过滤? 还是在调用api接口时候通过请求参数设置特定值来让有赞云过滤后返回给我们?

5、现在我们要上线礼品卡,所以现在用户消费时,我们先根据手机号码查询用户的所有可用礼品卡,然后再查询所有可用储值卡。
然后调用有赞云支付youzan.cardvoucher.valuecard.fund.pay.3.0.1接口时候,在请求参数"card_nos"中优先把礼品卡的card_no放在前面进行请求支付。
目前遇到上面4个 礼品卡和储值卡查询问题请帮助指导和解决,谢谢


用手机打开
收藏 ··· 回复

    尊敬的开发者您好:


    一、礼品卡接口问题
    1. 当前礼品卡接口未提供按手机号精准过滤能力,如果需要查询卡激活金额、剩余金额、有效期
    可以使用根据卡模板号分页查询卡信息列表youzan.cardvoucher.giftcard.template.query.3.0.0

    2. SDK 更新问题:如果没新增接口权限则不需要更新sdk

    二、储值卡接口问题
    1. 卡号重复说明:
    - 储值卡类型 1002 即为礼品卡类型
    - 同一卡在两个接口会重复出现,需通过 value_card_type 字段自行过滤
    - 建议优先使用礼品卡专用接口查询

    2.
    - 推荐调用 youzan.cardvoucher.valuecard.info.bysup.query 接口
    - 该接口可直接返回当前店铺可用卡列表(含余额)
    - 支付接口 card_nos 参数支持混合卡号,系统会自动识别卡类型
    • 未来 06-10
      因为用户可能存在既有礼品卡,也有储值卡,目前我们先查询礼品卡然后再查询储值卡,即查询用户名下所有卡,然后支付
        根据我们实测  youzan.cardvoucher.valuecard.info.bysup.query 接口查询获取有礼品卡和储值卡,但是获取包含的礼品卡不是这个用户所有的礼品卡。 比如用户名下有5张礼品卡,youzan.cardvoucher.valuecard.info.bysup.query 接口查看会只查询到2张礼品卡。

      请问youzan.cardvoucher.giftcard.template.query/3.0.0 接口分页模板查询礼品卡接口的 请求参数 template_no值如何获取后传入?


      所以我们的场景需求就是,查询用户的所有可用的礼品卡和储值卡,然后支付,请帮助指导给出接口调用方案,具体调用哪些接口以及请求参数如何填写?? 谢谢
    • 千寻 回复 未来 06-10
      使用youzan.cardvoucher.valuecard.info.query接口
      {  
        "yz_open_id": "abc123xyz",  
        "status": 1  // 1=有效卡  
      }  
      关键注意事项
      权限要求:
      礼品卡需 card_advanced(高级卡券权限)
      储值卡需 valuecard_advanced(储值卡高级权限)
    • 未来 回复 千寻 06-10
      感谢回复,请问yz_open_id这个值如何获取? 是调用api接口查询获取还是有赞小程序管理配置后台查询配置项获取?
    • 未来 回复 未来 7 天前
      目前我们已知的就是用户手机号码,请问调用哪个接口可以通过手机号码获取 yz_open_id?
    • 千寻 回复 未来 7 天前
      抱歉久等了,可以通过youzan.users.info.query接口获取,文档:https://doc.youzanyun.com/detail/API/0/4451

    1跳至
    您需要登录后才可以回帖 登录 | 立即注册

    本版积分规则

    复制链接
    新浪微博
    QQ空间
    微信扫码
    • 回复

    • 评分

    客服工作时间是9:00-18:00,客服妹子当前不在线,若不能及时回复请谅解。试试右上角的搜索吧,论坛有丰富的经验贴、公告贴,相信一定能够帮到您~

    复制成功