淺析微信支付：商戶平臺代金券或立減優(yōu)惠開通、指定用戶代金券發(fā)放、查詢等

neroneroffy 發(fā)布于2019-08-16 13:46 / 1076人閱讀

摘要：本文是淺析微信支付系列文章的第十四篇，主要講解在如何開通商戶平臺的代金券或立減優(yōu)惠功能，商家向指定用戶發(fā)送代金券，查詢發(fā)送記錄，代金券信息等。代金券微信支付代金券業(yè)務(wù)是基于微信支付，為了協(xié)助商戶方便地實(shí)現(xiàn)營銷優(yōu)惠措施。

本文是【淺析微信支付】系列文章的第十四篇，主要講解在如何開通商戶平臺的代金券或立減優(yōu)惠功能，商家向指定用戶發(fā)送代金券，查詢發(fā)送記錄，代金券信息等。

淺析微信支付系列已經(jīng)更新十四篇了喲～，沒有看過的朋友們可以看一下哦。

淺析微信支付：商戶平臺開通現(xiàn)金紅包、指定用戶發(fā)放、紅包記錄查詢

淺析微信支付：(余額提現(xiàn))企業(yè)付款到微信用戶零錢或銀行卡賬戶

淺析微信支付：支付驗(yàn)收示例和驗(yàn)收指引

淺析微信支付：如何使用沙箱環(huán)境測試

首先我們需要了解一下什么是代金券和立減優(yōu)惠？

代金券是微信支付為商家提供的一個(gè)營銷工具，他的主要功能可以簡單理解為商家的滿減券，比如常見的“滿十減一”、“滿x減x”這類，需要用戶主動(dòng)領(lǐng)取或者平臺主動(dòng)為用戶發(fā)放，核銷時(shí)會在微信支付調(diào)起界面顯示優(yōu)惠券信息。

立減優(yōu)惠是微信支付為商家提供的另一種自主核銷優(yōu)惠，為何叫自主核銷？因?yàn)榇藘?yōu)惠是一個(gè)門檻，不需要用戶領(lǐng)取，商家設(shè)置一個(gè)用戶群里，比如全員優(yōu)惠“滿十減一”，那么所有人都可以享受這個(gè)優(yōu)惠，直接在購買商品時(shí)自動(dòng)扣減金額。

以上為簡單的解釋，下面我會結(jié)合官方文檔來解釋這兩個(gè)優(yōu)惠方式。

代金券

微信支付代金券業(yè)務(wù)是基于微信支付，為了協(xié)助商戶方便地實(shí)現(xiàn)營銷優(yōu)惠措施。針對部分有開發(fā)能力的商戶，微信支付提供通過API接口實(shí)現(xiàn)運(yùn)營代金券的功能

官方文檔地址：

https://pay.weixin.qq.com/wiki/doc/api/tools/sp_coupon.php?chapter=12_2&index=2

首先，這里我們講接口發(fā)放代金券的方式，下面是代金券的三個(gè)接口：

操作代金券開通和如何手動(dòng)創(chuàng)建的官方文檔如下：

https://pay.weixin.qq.com/wiki/doc/api/tools/sp_coupon.php?chapter=12_7&index=3

這里說一下重點(diǎn)需要注意的地方，首先，代金券分為單品券和全場券，簡單理解：

單品券：指定某幾個(gè)商品ID的商品可以使用的代金券

全場券：所有商品都可以使用的代金券

PS：通過高級接口發(fā)放的代金券不能插入卡包，并且用戶是沒有感知的，這是一個(gè)缺點(diǎn)，大家一定要記住。

微信支付的代金券核銷時(shí)都是在微信的確認(rèn)支付窗口，如果有多個(gè)代金券，可以選擇或者合并代金券支付，支付后在支付通知中會顯示記錄代金券使用的記錄。

還需要注意一點(diǎn)，單品代金券核銷時(shí)需要驗(yàn)證商品ID，這個(gè)商品ID在預(yù)支付單中單品優(yōu)惠活動(dòng)detail字段傳入，json格式必填參數(shù)，字段中goods_id就是我們在商戶后臺創(chuàng)建代金券時(shí)填入的商品ID，具體的代碼可以看我的統(tǒng)一下單接口文章和GitHub源碼。

淺析微信支付：統(tǒng)一下單接口

show me the code:

/**
 * [單品優(yōu)惠券] - 根據(jù)訂單VO拼接統(tǒng)一下單需要的 detail 參數(shù)，此參數(shù)用于[單品優(yōu)惠券]時(shí)自動(dòng)抵扣 

 * 統(tǒng)一下單API(支持單品優(yōu)惠參數(shù)) - 享受了單品優(yōu)惠的訂單不支持部分退款，對賬單與普通支付保持一致 

 * 接口地址：https://pay.weixin.qq.com/wiki/doc/api/danpin.php?chapter=9_102&index=2
 * @param orderList 訂單list
 * @return 微信支付統(tǒng)一下單 detail 參數(shù)
 *
 * @author yclimb
 * @date 2018/9/14
 */
public JSONObject setWxPayUnifiedOrderDetail(List orderList) {
    if (orderList == null || orderList.isEmpty()) {
        return null;
    }
    // 單品優(yōu)惠活動(dòng)detail字段列表說明：
    JSONObject detail = new JSONObject();
    /* 訂單原價(jià)    cost_price    否    int    608800
       1.商戶側(cè)一張小票訂單可能被分多次支付，訂單原價(jià)用于記錄整張小票的交易金額。
       2.當(dāng)訂單原價(jià)與支付金額不相等，則不享受優(yōu)惠。
       3.該字段主要用于防止同一張小票分多次支付，以享受多次優(yōu)惠的情況，正常支付訂單不必上傳此參數(shù)。*/
    // detail.put("cost_price", createTradeVo.getTrade().getTotalPayMoney());
    // 商品小票ID    receipt_id    否    String(32)    wx123    商家小票ID
    // detail.put("receipt_id", "");

    // 單品優(yōu)惠活動(dòng)goods_detail字段說明：
    JSONArray goodsDetailList = new JSONArray();

    for (Order order : orderList) {
        JSONObject goodsDetail = new JSONObject();
        // 商品編碼    goods_id    是    String(32)    商品編碼    由半角的大小寫字母、數(shù)字、中劃線、下劃線中的一種或幾種組成
        goodsDetail.put("goods_id", order.getProductId());
        // 微信側(cè)商品編碼    wxpay_goods_id    否    String(32)    1001    微信支付定義的統(tǒng)一商品編號（沒有可不傳）
        // goodsDetail.put("wxpay_goods_id", "");
        // 商品名稱    goods_name    否    String(256)    iPhone6s 16G    商品的實(shí)際名稱
        goodsDetail.put("goods_name", order.getProductName());
        // 商品數(shù)量    quantity    是    int    1    用戶購買的數(shù)量
        goodsDetail.put("quantity", order.getItemNum());
        // 商品單價(jià)    price    是    int    528800    單位為：分。如果商戶有優(yōu)惠，需傳輸商戶優(yōu)惠后的單價(jià)(例如：用戶對一筆100元的訂單使用了商場發(fā)的紙質(zhì)優(yōu)惠券100-50，則活動(dòng)商品的單價(jià)應(yīng)為原單價(jià)-50)
        goodsDetail.put("price", NumberUtil.mul(order.getPayMoney(), 100));

        // 加入單品優(yōu)惠集合
        goodsDetailList.add(goodsDetail);
    }

    // 單品列表    goods_detail    是    String    示例見下文    單品信息，使用Json數(shù)組格式提交
    detail.put("goods_detail", goodsDetailList);

    return detail;
}

發(fā)放代金券接口鏈接

https://api.mch.weixin.qq.com/mmpaymkttransfers/send_coupon

是否需要證書

請求需要雙向證書。

調(diào)用接口

用于商戶主動(dòng)調(diào)用接口給用戶發(fā)放代金券的場景，已做防小號處理，給小號發(fā)放代金券將返回錯(cuò)誤碼。

注意：通過接口發(fā)放的代金券不會進(jìn)入微信卡包

接口很簡單，需要代金券批次ID和用戶openid，代金券批次ID在哪里？每個(gè)代金券創(chuàng)建后就會有一個(gè)代金券批次ID，在商戶平臺-營銷管理-代金券管理中可以看到。

下面為調(diào)用方式：

// 微信支付對象
WXPay wxPay = new WXPay(WXPayConfigImpl.getInstance());

// 調(diào)用發(fā)送代金券接口
Map resultMap = wxPay.sendCoupon(coupon_stock_id, partner_trade_no, openid);

微信接口調(diào)用：

/**
 * 作用：商戶平臺-代金券或立減優(yōu)惠-發(fā)放代金券

 * 場景：用于商戶主動(dòng)調(diào)用接口給用戶發(fā)放代金券的場景，已做防小號處理，給小號發(fā)放代金券將返回錯(cuò)誤碼。
 * 注意：通過接口發(fā)放的代金券不會進(jìn)入微信卡包
 * 接口文檔地址：https://pay.weixin.qq.com/wiki/doc/api/tools/sp_coupon.php?chapter=12_3&index=4
 *
 * @param coupon_stock_id 代金券批次id
 * @param partner_trade_no 商戶單據(jù)號
 * @param openid 用戶openid
 * @return API返回?cái)?shù)據(jù)
 * @throws Exception e
 *
 * @author yclimb
 * @date 2018/9/14
 */
public Map sendCoupon(String coupon_stock_id, String partner_trade_no, String openid) throws Exception {

    /** 構(gòu)造請求參數(shù)數(shù)據(jù) **/
    Map data = new HashMap<>();

    // 代金券批次id    coupon_stock_id    是    1757    String    代金券批次id
    data.put("coupon_stock_id", coupon_stock_id);
    // openid記錄數(shù)    openid_count    是    1    int    openid記錄數(shù)（目前支持num=1）
    data.put("openid_count", "1");
    // 商戶單據(jù)號    partner_trade_no    是    1000009820141203515766    String    商戶此次發(fā)放憑據(jù)號（格式：商戶id+日期+流水號），商戶側(cè)需保持唯一性
    data.put("partner_trade_no", partner_trade_no);
    // 用戶openid    openid    是    onqOjjrXT-776SpHnfexGm1_P7iE    String    Openid信息，用戶在appid下的唯一標(biāo)識
    data.put("openid", openid);

    /** 以下參數(shù)為非必填參數(shù) **/
    // 操作員    op_user_id    否    10000098    String(32)    操作員帳號, 默認(rèn)為商戶號 可在商戶平臺配置操作員對應(yīng)的api權(quán)限
    // 設(shè)備號    device_info    否         String(32)    微信支付分配的終端設(shè)備號
    // 協(xié)議版本    version    否    1.0    String(32)    默認(rèn)1.0
    // 協(xié)議類型    type    否    XML    String(32)    XML【目前僅支持默認(rèn)XML】


    /** 以下四個(gè)參數(shù)，在 this.fillRequestData 方法中會自動(dòng)賦值 **/
    // 公眾賬號ID appid    是    wx5edab3bdfba3dc1c    String(32)    微信為發(fā)券方商戶分配的公眾賬號ID，接口傳入的所有appid應(yīng)該為公眾號的appid（在mp.weixin.qq.com申請的），不能為APP的appid（在open.weixin.qq.com申請的）。
    // 商戶號    mch_id    是    10000098    String(32)    微信為發(fā)券方商戶分配的商戶號
    // 隨機(jī)字符串    nonce_str    是    1417574675    String(32)    隨機(jī)字符串，不長于32位
    // 簽名    sign    是    841B3002FE2220C87A2D08ABD8A8F791    String(32)    簽名參數(shù)，詳見簽名生成算法

    // 微信調(diào)用接口
    Map resultMap = this.sendCoupon(data);

    WXPayUtil.getLogger().info("wxPay.sendCoupon:" + resultMap);

    return resultMap;
}

以上為發(fā)放代金券相關(guān)代碼，下面是查詢代金券批次和代金券領(lǐng)取記錄接口。
解釋下什么叫做代金券批次和代金券記錄：

代金券批次：商戶平臺創(chuàng)建的一個(gè)批次代金券，包含x張代金券

代金券：代金券批次下的一張代金券，代金券ID在用戶領(lǐng)取代金券后由領(lǐng)取接口獲取

代金券記錄：用戶領(lǐng)券的代金券記錄，與代金券1:1，一個(gè)批次下有多個(gè)領(lǐng)取記錄

代金券批次查詢

官方文檔如下：

https://pay.weixin.qq.com/wiki/doc/api/tools/sp_coupon.php?chapter=12_4&index=5

是否需要證書：否

請求參數(shù)主要為代金券批次idcoupon_stock_id，下面是調(diào)用接口代碼：

/**
 * 作用：商戶平臺-代金券或立減優(yōu)惠-查詢代金券批次

 * 場景：查詢代金券批次信息
 * 接口文檔地址：https://pay.weixin.qq.com/wiki/doc/api/tools/sp_coupon.php?chapter=12_4&index=5
 *
 * @param coupon_stock_id 代金券批次id
 * @return API返回?cái)?shù)據(jù)
 * @throws Exception e
 *
 * @author yclimb
 * @date 2018/9/14
 */
public Map queryCouponStock(String coupon_stock_id) throws Exception {

    /** 構(gòu)造請求參數(shù)數(shù)據(jù) **/
    Map data = new HashMap<>();

    // 代金券批次id    coupon_stock_id    是    1757    String    代金券批次id
    data.put("coupon_stock_id", coupon_stock_id);

    /** 以下參數(shù)為非必填參數(shù) **/
    // 操作員    op_user_id    否    10000098    String(32)    操作員帳號, 默認(rèn)為商戶號 可在商戶平臺配置操作員對應(yīng)的api權(quán)限
    // 設(shè)備號    device_info    否         String(32)    微信支付分配的終端設(shè)備號
    // 協(xié)議版本    version    否    1.0    String(32)    默認(rèn)1.0
    // 協(xié)議類型    type    否    XML    String(32)    XML【目前僅支持默認(rèn)XML】


    /** 以下四個(gè)參數(shù)，在 this.fillRequestData 方法中會自動(dòng)賦值 **/
    // 公眾賬號ID appid    是    wx5edab3bdfba3dc1c    String(32)    微信為發(fā)券方商戶分配的公眾賬號ID，接口傳入的所有appid應(yīng)該為公眾號的appid（在mp.weixin.qq.com申請的），不能為APP的appid（在open.weixin.qq.com申請的）。
    // 商戶號    mch_id    是    10000098    String(32)    微信為發(fā)券方商戶分配的商戶號
    // 隨機(jī)字符串    nonce_str    是    1417574675    String(32)    隨機(jī)字符串，不長于32位
    // 簽名    sign    是    841B3002FE2220C87A2D08ABD8A8F791    String(32)    簽名參數(shù)，詳見簽名生成算法

    // 微信調(diào)用接口
    Map resultMap = this.queryCouponStock(data);

    WXPayUtil.getLogger().info("wxPay.queryCouponStock:" + resultMap);

    return resultMap;
}

此接口主要用于在商家系統(tǒng)主動(dòng)查詢代金券時(shí)使用，如果需要實(shí)時(shí)同步領(lǐng)券數(shù)量等，需要定時(shí)任務(wù)來同步；推薦做法，如果商家自身系統(tǒng)已經(jīng)發(fā)券，就不要使用微信商戶平臺的發(fā)券方式，自身系統(tǒng)發(fā)券即可；或者可以做一個(gè)手動(dòng)同步的口子，某一個(gè)時(shí)間點(diǎn)手動(dòng)觸發(fā)同步機(jī)制。

查詢代金券信息

官方文檔如下：

https://pay.weixin.qq.com/wiki/doc/api/tools/sp_coupon.php?chapter=12_5&index=6

此接口主要作用是查詢某個(gè)用戶的領(lǐng)券狀態(tài)，代金券狀態(tài)。
需要三個(gè)主要參數(shù)：coupon_id 代金券id、stock_id 批次號、openid 用戶openid。

調(diào)用接口代碼如下：

/**
 * 作用：商戶平臺-代金券或立減優(yōu)惠-查詢代金券信息

 * 場景：查詢代金券信息
 * 接口文檔地址：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返回?cái)?shù)據(jù)
 * @throws Exception e
 *
 * @author yclimb
 * @date 2018/9/14
 */
public Map queryCouponsInfo(String coupon_id, String stock_id, String openid) throws Exception {

    /** 構(gòu)造請求參數(shù)數(shù)據(jù) **/
    Map data = new HashMap<>();

    // 代金券id    coupon_id    是    1565    String    代金券id
    data.put("coupon_id", coupon_id);
    // 用戶openid    openid    是    onqOjjrXT-776SpHnfexGm1_P7iE    String    Openid信息，用戶在appid下的唯一標(biāo)識
    data.put("openid", openid);
    // 批次號    stock_id    是    58818    String(32)    代金劵對應(yīng)的批次號
    data.put("stock_id", stock_id);

    /** 以下參數(shù)為非必填參數(shù) **/
    // 操作員    op_user_id    否    10000098    String(32)    操作員帳號, 默認(rèn)為商戶號 可在商戶平臺配置操作員對應(yīng)的api權(quán)限
    // 設(shè)備號    device_info    否         String(32)    微信支付分配的終端設(shè)備號
    // 協(xié)議版本    version    否    1.0    String(32)    默認(rèn)1.0
    // 協(xié)議類型    type    否    XML    String(32)    XML【目前僅支持默認(rèn)XML】


    /** 以下四個(gè)參數(shù)，在 this.fillRequestData 方法中會自動(dòng)賦值 **/
    // 公眾賬號ID appid    是    wx5edab3bdfba3dc1c    String(32)    微信為發(fā)券方商戶分配的公眾賬號ID，接口傳入的所有appid應(yīng)該為公眾號的appid（在mp.weixin.qq.com申請的），不能為APP的appid（在open.weixin.qq.com申請的）。
    // 商戶號    mch_id    是    10000098    String(32)    微信為發(fā)券方商戶分配的商戶號
    // 隨機(jī)字符串    nonce_str    是    1417574675    String(32)    隨機(jī)字符串，不長于32位
    // 簽名    sign    是    841B3002FE2220C87A2D08ABD8A8F791    String(32)    簽名參數(shù)，詳見簽名生成算法

    // 微信調(diào)用接口
    Map resultMap = this.queryCouponsInfo(data);

    WXPayUtil.getLogger().info("wxPay.queryCouponsInfo:" + resultMap);

    return resultMap;
}

立減優(yōu)惠折扣

在商戶平臺 - 產(chǎn)品中心 - 預(yù)充值立減與折扣中開通功能即可，預(yù)充值立減與折扣是微信支付為商戶提供的基礎(chǔ)營銷工具之一，商戶可以在商戶平臺-營銷中心配置預(yù)充值型立減或折扣，開展?fàn)I銷活動(dòng)。

可自定義活動(dòng)標(biāo)題、減價(jià)面額、減價(jià)門檻、可用商戶、預(yù)算、用戶領(lǐng)取次數(shù)限制，也可以配置指定會員可用、指定某些商品享受優(yōu)惠等。

此功能不需要開發(fā)，創(chuàng)建活動(dòng)審核開通即生效，在微信支付時(shí)自動(dòng)扣減。

關(guān)于立減功能的使用，這里就不多說了，很簡單，小伙伴們可以在微信商戶平臺上閱讀一下官方解釋，進(jìn)入產(chǎn)品詳情創(chuàng)建一個(gè)活動(dòng)測試一下即可。

結(jié)語

這一篇講解了如何開通代金券和立減優(yōu)惠折扣，并貼上如何發(fā)送代金券、查詢代金券等接口的源碼，小伙伴需要仔細(xì)閱讀官方文檔，對照本篇文章，應(yīng)該不會有什么問題。

這里主要是使用了預(yù)充值代金券、預(yù)充值立減和折扣，必須先充值足夠的預(yù)算金額才可以使用功能，如果想要免充值即可使用，需要開通免充值代金券、免充值立減和折扣，開通該兩項(xiàng)功能需要走免充值產(chǎn)品功能使用指引，該功能還需要接口升級，下一篇文章為大家介紹如何接口升級及開通免充值產(chǎn)品功能。

如果小伙伴有遇到解決不了的問題，可以關(guān)注作者微信公眾號，加入討論群中發(fā)出疑問，和小伙伴們一起解決哦～

預(yù)告：下一篇文章會講發(fā)放獎(jiǎng)勵(lì)的另一種方式 商戶平臺-現(xiàn)金紅包，敬請期待！??！

?如果想要提前一覽源碼的小伙伴，可以先看看我的 github，地址如下：
?
?`
?https://github.com/YClimb/wxp...
?`

關(guān)注作者微信公眾號，點(diǎn)擊下方討論群，掃碼即可加入微信支付討論群與小伙伴一起探討哦～

到此本文就結(jié)束了，關(guān)注公眾號查看更多推送?。。?/p>

云服務(wù)器 GPU云服務(wù)器代金券團(tuán)代金券代金券查看代金券管理

文章版權(quán)歸作者所有，未經(jīng)允許請勿轉(zhuǎn)載,若此文章存在違規(guī)行為，您可以聯(lián)系管理員刪除。

轉(zhuǎn)載請注明本文地址：http://systransis.cn/yun/72297.html

發(fā)表評論

登陸后可評論

0條評論

neroneroffy

男|高級講師

我要關(guān)注我要私信

TA的文章

“我，24歲，年薪20萬”：選對了行業(yè)究竟多重要？

閱讀 2628·2021-09-28 09:36
零基礎(chǔ) | 入行軟件測試，你想知道的都在這里了

閱讀 2245·2021-09-07 09:58
初探React技術(shù)棧（一）

閱讀 1503·2019-08-26 13:53
React造輪系列：Layout 組件思路

閱讀 1285·2019-08-23 17:53
onclick傳參數(shù)

閱讀 3035·2019-08-23 15:34
js隱式轉(zhuǎn)換

閱讀 1858·2019-08-23 15:34
javascript浮點(diǎn)數(shù)學(xué)習(xí)總結(jié)之0.1+0.2

閱讀 2875·2019-08-23 12:04
JS -- sort()方法實(shí)現(xiàn)對象數(shù)組的排序

閱讀 3727·2019-08-23 10:56

成人国产在线小视频_日韩寡妇人妻调教在线播放_色成人www永久在线观看_2018国产精品久久_亚洲欧美高清在线30p_亚洲少妇综合一区_黄色在线播放国产_亚洲另类技巧小说校园_国产主播xx日韩_a级毛片在线免费

資訊專欄INFORMATION COLUMN

上云采購季！| 2核2G4M爆款云服務(wù)器低至59元/年，更有多臺、長期優(yōu)惠，快來選購！

淺析微信支付：商戶平臺代金券或立減優(yōu)惠開通、指定用戶代金券發(fā)放、查詢等

相關(guān)文章

淺析微信支付：前篇大綱

淺析微信支付：開通免充值產(chǎn)品功能及如何進(jìn)行接口升級指引

淺析微信支付：下載對賬單和資金賬單

淺析微信支付：微信支付簡單介紹（小程序、公眾號、App、H5）

**淺析微信支付：商戶平臺開通現(xiàn)金紅包、指定用戶發(fā)放、紅包記錄查詢**

發(fā)表評論

0條評論

neroneroffy

男|高級講師

TA的文章

“我，24歲，年薪20萬”：選對了行業(yè)究竟多重要？

零基礎(chǔ) | 入行軟件測試，你想知道的都在這里了

初探React技術(shù)棧（一）

React造輪系列：Layout 組件思路

onclick傳參數(shù)

js隱式轉(zhuǎn)換

javascript浮點(diǎn)數(shù)學(xué)習(xí)總結(jié)之0.1+0.2

JS -- sort()方法實(shí)現(xiàn)對象數(shù)組的排序

最新活動(dòng)

資訊專欄INFORMATION COLUMN

上云采購季！| 2核2G4M爆款云服務(wù)器低至59元/年，更有多臺、長期優(yōu)惠，快來選購！

淺析微信支付：商戶平臺代金券或立減優(yōu)惠開通、指定用戶代金券發(fā)放、查詢等

相關(guān)文章

發(fā)表評論

0條評論

男|高級講師

TA的文章

最新活動(dòng)

上云采購季！| 2核2G4M爆款云服務(wù)器低至59元/年，更有多臺、長期優(yōu)惠，快來選購！

淺析微信支付：商戶平臺代金券或立減優(yōu)惠開通、指定用戶代金券發(fā)放、查詢等