此接口主要用于在商家系统主动查询代金券时使用,如果需要实时同步领券数量等,需要定时任务来同步;推荐做法,如果商家自身系统已经发券,就不要使用微信商户平台的发券方式,自身系统发券即可;或者可以做一个手动同步的口子,某一个时间点手动触发同步机制。
查询代金券信息官方文档如下:
https://pay.weixin.qq.com/wiki/doc/api/tools/sp_coupon.php?chapter=12_5&index=6此接口主要作用是查询某个用户的领券状态,代金券状态。
需要三个主要参数:coupon_id 代金券id、stock_id 批次号、openid 用户openid。
调用接口代码如下:
/** * 作用:商户平台-代金券或立减优惠-查询代金券信息<br> * 场景:查询代金券信息 * 接口文档地址:https://pay.weixin.qq.com/wiki/doc/api/tools/sp_coupon.php?chapter=12_5&index=6 * * @param coupon_id 代金券id * @param stock_id 批次号 * @param openid 用户openid * @return API返回数据 * @throws Exception e * * @author yclimb * @date 2018/9/14 */ public Map<String, String> queryCouponsInfo(String coupon_id, String stock_id, String openid) throws Exception { /** 构造请求参数数据 **/ Map<String, String> data = new HashMap<>(); // 代金券id coupon_id 是 1565 String 代金券id data.put("coupon_id", coupon_id); // 用户openid openid 是 onqOjjrXT-776SpHnfexGm1_P7iE String Openid信息,用户在appid下的唯一标识 data.put("openid", openid); // 批次号 stock_id 是 58818 String(32) 代金劵对应的批次号 data.put("stock_id", stock_id); /** 以下参数为非必填参数 **/ // 操作员 op_user_id 否 10000098 String(32) 操作员帐号, 默认为商户号 可在商户平台配置操作员对应的api权限 // 设备号 device_info 否 String(32) 微信支付分配的终端设备号 // 协议版本 version 否 1.0 String(32) 默认1.0 // 协议类型 type 否 XML String(32) XML【目前仅支持默认XML】 /** 以下四个参数,在 this.fillRequestData 方法中会自动赋值 **/ // 公众账号ID appid 是 wx5edab3bdfba3dc1c String(32) 微信为发券方商户分配的公众账号ID,接口传入的所有appid应该为公众号的appid(在mp.weixin.qq.com申请的),不能为APP的appid(在open.weixin.qq.com申请的)。 // 商户号 mch_id 是 10000098 String(32) 微信为发券方商户分配的商户号 // 随机字符串 nonce_str 是 1417574675 String(32) 随机字符串,不长于32位 // 签名 sign 是 841B3002FE2220C87A2D08ABD8A8F791 String(32) 签名参数,详见签名生成算法 // 微信调用接口 Map<String, String> resultMap = this.queryCouponsInfo(data); WXPayUtil.getLogger().info("wxPay.queryCouponsInfo:" + resultMap); return resultMap; } 立减优惠折扣在商户平台 - 产品中心 - 预充值立减与折扣 中开通功能即可,预充值立减与折扣是微信支付为商户提供的基础营销工具之一,商户可以在商户平台-营销中心配置预充值型立减或折扣,开展营销活动。
可自定义活动标题、减价面额、减价门槛、可用商户、预算、用户领取次数限制,也可以配置指定会员可用、指定某些商品享受优惠等。
此功能不需要开发,创建活动审核开通即生效,在微信支付时自动扣减。