メッセージを殘して転送することを歓迎します

WeChat スピード開発シリーズの記事: ここをクリックしてください

前回の記事では WeChat 決済について紹介しました。 公式アカウント支払い、WeChat スキャンコード支払い、カード支払い、WeChat 支払い

この記事では、WeChat 加盟店の支払いツール - 現(xiàn)金赤い封筒について説明します

現(xiàn)金赤い封筒.png

準備

[公式ドキュメント]

1. 現(xiàn)金封筒の権限を有効化します

現(xiàn)金封筒を使用する前に、現(xiàn)金封筒機能をアクティブ化してください。操作パス: [WeChat 支払いマーチャント プラットフォームにログイン—>プロダクト センター—>現(xiàn)金赤い封筒—>アクティブ化]。

2. API証明書をダウンロードします

販売者がWeChat red封筒インターフェースを呼び出すと、サーバーは証明書の検証を?qū)g行します

Cash Red Envelope - ダウンロードCertificate.png

Cash Red Packet-File after Download.png

たくさんの証明書でどれを使用すればよいか尋ねたい人はいますか?開発言語と何か関係があるのでしょうか？

どの言語がどの証明書を使用しますか? スクリーンショットの Certificate description.txt を參照してください。 證書說明.txt

內(nèi)容如下：

歡迎使用微信支付！
微信支付API共四份（證書pkcs12格式、證書pem格式、證書密鑰pem格式、CA證書）,為接口中強制要求時需攜帶的證書文件。
證書屬于敏感信息，請妥善保管不要泄露和被他人復(fù)制。
不同開發(fā)語言下的證書格式不同，以下為說明指引：
????證書pkcs12格式（apiclient_cert.p12）
????????包含了私鑰信息的證書文件，為p12(pfx)格式，由微信支付簽發(fā)給您用來標識和界定您的身份
????????部分安全性要求較高的API需要使用該證書來確認您的調(diào)用身份
????????windows上可以直接雙擊導(dǎo)入系統(tǒng)，導(dǎo)入過程中會提示輸入證書密碼，證書密碼默認為您的商戶ID（如：10010000）
????證書pem格式（apiclient_cert.pem）
????????從apiclient_cert.p12中導(dǎo)出證書部分的文件，為pem格式，請妥善保管不要泄漏和被他人復(fù)制
????????部分開發(fā)語言和環(huán)境，不能直接使用p12文件，而需要使用pem，所以為了方便您使用，已為您直接提供
????????您也可以使用openssl命令來自己導(dǎo)出：openssl?pkcs12?-clcerts?-nokeys?-in?apiclient_cert.p12?-out?apiclient_cert.pem
????證書密鑰pem格式（apiclient_key.pem）
????????從apiclient_cert.p12中導(dǎo)出密鑰部分的文件，為pem格式
????????部分開發(fā)語言和環(huán)境，不能直接使用p12文件，而需要使用pem，所以為了方便您使用，已為您直接提供
????????您也可以使用openssl命令來自己導(dǎo)出：openssl?pkcs12?-nocerts?-in?apiclient_cert.p12?-out?apiclient_key.pem
????CA證書（rootca.pem）
????????微信支付api服務(wù)器上也部署了證明微信支付身份的服務(wù)器證書，您在使用api進行調(diào)用時也需要驗證所調(diào)用服務(wù)器及域名的真實性
????????該文件為簽署微信支付證書的權(quán)威機構(gòu)的根證書，可以用來驗證微信支付服務(wù)器證書的真實性
????????某些環(huán)境和工具已經(jīng)內(nèi)置了若干權(quán)威機構(gòu)的根證書，無需引用該證書也可以正常進行驗證，這里提供給您在未內(nèi)置所必須根證書的環(huán)境中載入使用

三、充值

在發(fā)放現(xiàn)金紅包之前，請確保你的資金充足。如若不足，請充值。操作路徑：【登錄商戶平臺——>賬戶中心——>資金管理——>充值】

每個紅包的平均金額必須在1.00元到200.00元之間

現(xiàn)金紅包-充值.png

四、獲取openid

目前支持向指定微信用戶的openid發(fā)放指定金額紅包。（獲取openid參見之前寫的文章：極速開發(fā)微信公眾號之授權(quán)獲取用戶信息

五、相關(guān)參數(shù)設(shè)置

和紅包相關(guān)的參數(shù)【主要是安全方面：綁定IP、防止用戶盜刷】，你可以在頁面上自主設(shè)置和更改。
操作路徑如下：【登錄商戶平臺——>產(chǎn)品中心——>現(xiàn)金紅包——>產(chǎn)品設(shè)置】（注：“產(chǎn)品設(shè)置”操作按鈕僅當你開通現(xiàn)金紅包功能之后才會出現(xiàn)）。
你可以設(shè)置和更改以下參數(shù)：

現(xiàn)金紅包-設(shè)置參數(shù).png

說明：
1、 調(diào)用IP地址：設(shè)置之后，僅有已設(shè)置的IP地址可以調(diào)用，其余的IP調(diào)用會報錯；
2、用戶領(lǐng)取上限：限制同一openid同一日領(lǐng)取的個數(shù)
3、防刷等級：防刷是指微信風(fēng)控針對微信小號、僵尸號、機器號等的攔截，你可以通過更改防刷等級控制防刷的強度。
4、 同時，你也可以申請更改紅包額度。但是需要經(jīng)過微信支付的審核，審核通過之后才會生效。

現(xiàn)金紅包類別

現(xiàn)金紅包分為兩類：
1、普通紅包 【官方文檔】
2、裂變紅包 【官方文檔】

兩者部分參數(shù)不同

發(fā)送現(xiàn)金紅包

1、發(fā)送普通紅包接口 com.javen.weixin.api.RedPackApi.java

private static String sendRedPackUrl = "https://api.mch.weixin.qq.com/mmpaymkttransfers/sendredpack";

    /**
     * 發(fā)送紅包
     * @param params 請求參數(shù)
     * @param certPath 證書文件目錄
     * @param partner 證書密碼
     * @return {String}
     */
    public static String sendRedPack(Map<String, String> params, String certPath, String partner) {
        return HttpUtils.postSSL(sendRedPackUrl, PaymentKit.toXml(params), certPath, partner);
    }

2、發(fā)送裂變紅包接口 com.javen.weixin.api.RedPackApi.java

private static String sendGroupRedPackUrl = "api.mch.weixin.qq.com/mmpaymkttransfers/sendgroupredpack";

    /**
     * 發(fā)送裂變紅包
     * @param params 請求參數(shù)
     * @param certPath 證書文件目錄
     * @param partner 證書密碼
     * @return {String}
     */
    public static String sendGroupRedPack(Map<String, String> params, String certPath, String partner) {
        return HttpUtils.postSSL(sendGroupRedPackUrl, PaymentKit.toXml(params), certPath, partner);
    }

具體實現(xiàn)封裝 com.javen.utils.ReadPackUtils.java
1、普通紅包

/**
     * 發(fā)送普通紅包
     * @param request 獲取IP
     * @param total_amount  付款現(xiàn)金(單位分)
     * @param total_num 紅包發(fā)放總?cè)藬?shù)
     * @param wishing 紅包祝福語
     * @param act_name 活動名稱
     * @param remark 備注
     * @param reOpenid 用戶openid
     * @param partner 商戶號
     * @param wxappid 公眾賬號appid
     * @param sendName 商戶名稱
     * @param paternerKey 商戶簽名key
     * @param certPath 證書路徑
     * @return
     */
    public static boolean sendredpack(HttpServletRequest request,String total_amount,String total_num,String wishing,String act_name,String remark,String reOpenid,String partner,String wxappid,String sendName,String paternerKey,String certPath) {
        // 商戶訂單號
        String mchBillno = System.currentTimeMillis() + "";
        String ip = IpKit.getRealIp(request);

        Map<String, String> params = new HashMap<String, String>();
        // 隨機字符串
        params.put("nonce_str", System.currentTimeMillis() / 1000 + "");
        // 商戶訂單號
        params.put("mch_billno", mchBillno);
        // 商戶號
        params.put("mch_id", partner);
        // 公眾賬號ID
        params.put("wxappid", wxappid);
        // 商戶名稱
        params.put("send_name", sendName);
        // 用戶OPENID
        params.put("re_openid", reOpenid);
        // 付款現(xiàn)金(單位分)
        params.put("total_amount", total_amount);
        // 紅包發(fā)放總?cè)藬?shù)
        params.put("total_num", total_num);
        // 紅包祝福語
        params.put("wishing", wishing);
        // 終端IP
        params.put("client_ip", ip);
        // 活動名稱
        params.put("act_name", act_name    );
        // 備注
        params.put("remark", remark);
        //創(chuàng)建簽名
        String sign = PaymentKit.createSign(params, paternerKey);
        params.put("sign", sign);

        String xmlResult = RedPackApi.sendRedPack(params, certPath, partner);
        Map<String, String> result = PaymentKit.xmlToMap(xmlResult);
        log.warn(JsonKit.toJson(result));
        //此字段是通信標識，非交易標識，交易是否成功需要查看result_code來判斷
        String return_code = result.get("return_code");
        //業(yè)務(wù)結(jié)果
        String result_code = result.get("result_code");

        if (StrKit.isBlank(return_code) || !"SUCCESS".equals(return_code)) {
            return false;
        }
        if (StrKit.notBlank(result_code) && "SUCCESS".equals(result_code)) {

            return true;
        }
        return false;
    }

2、裂變紅包

/**
     * 發(fā)送裂變紅包
     * @param partner
     * @param wxappid
     * @param sendName
     * @param reOpenid
     * @param total_amount
     * @param total_num
     * @param wishing
     * @param act_name
     * @param remark
     * @param paternerKey
     * @param certPath
     * @return
     */
    public static boolean sendGroupRedPack(String partner, String wxappid, String sendName, String reOpenid, String total_amount, String total_num, String wishing, String act_name, String remark, String paternerKey, String certPath){
        // 商戶訂單號
        String mchBillno = System.currentTimeMillis() + "";

        Map<String, String> params = new HashMap<String, String>();
        // 隨機字符串
        params.put("nonce_str", System.currentTimeMillis() / 1000 + "");
        // 商戶訂單號
        params.put("mch_billno", mchBillno);
        // 商戶號
        params.put("mch_id", partner);
        // 公眾賬號ID
        params.put("wxappid", wxappid);
        // 商戶名稱
        params.put("send_name", sendName);
        // 用戶OPENID
        params.put("re_openid", reOpenid);
        // 付款現(xiàn)金(單位分)
        params.put("total_amount", total_amount);
        // 紅包發(fā)放總?cè)藬?shù)
        params.put("total_num", total_num);
        //紅包金額設(shè)置方式
        params.put("amt_type", "ALL_RAND");
        // 紅包祝福語
        params.put("wishing", wishing);
        // 活動名稱
        params.put("act_name", act_name    );
        // 備注
        params.put("remark", remark);

        //創(chuàng)建簽名
        String sign = PaymentKit.createSign(params, paternerKey);
        params.put("sign", sign);

        String xmlResult = RedPackApi.sendGroupRedPack(params, certPath, partner);
        Map<String, String> result = PaymentKit.xmlToMap(xmlResult);
        log.warn(JsonKit.toJson(result));
        //此字段是通信標識，非交易標識，交易是否成功需要查看result_code來判斷
        String return_code = result.get("return_code");
        //業(yè)務(wù)結(jié)果
        String result_code = result.get("result_code");

        if (StrKit.isBlank(return_code) || !"SUCCESS".equals(return_code)) {
            return false;
        }
        if (StrKit.notBlank(result_code) && "SUCCESS".equals(result_code)) {

            return true;
        }
        return false;

    }

發(fā)送紅包Demo

/**
 * 微信紅包demo
 * @author Javen
 * 2016年5月28日
 */
public class RedPackApiController extends Controller {
    private static String sendName = "Javen205";
    //微信證書路徑
    private static String certPath = "/Users/Javen/Downloads/cert/apiclient_cert.p12";
    //商戶相關(guān)資料
    String wxappid = PropKit.get("appId");
    // 微信支付分配的商戶號
    String partner = PropKit.get("mch_id");
    //API密鑰
    String paternerKey = PropKit.get("paternerKey");

    /**
     * 發(fā)送普通紅包
     */
    public void sendredpack() {

        boolean isSend = ReadPackUtils.sendredpack(getRequest(), "100", "1", "感謝您參加猜燈謎活動，祝您元宵節(jié)快樂！",
                "猜燈謎搶紅包活動", "猜越多得越多，快來搶！", "o_pncsidC-pRRfCP4zj98h6slREw",
                partner, wxappid, sendName, paternerKey, certPath);

        renderJson(isSend);
    }
    /**
     * 發(fā)送裂變紅包
     */
    public void sendGroupRedPack() {

        boolean isSend = ReadPackUtils.sendGroupRedPack(partner, wxappid, "天虹百貨", "o_pncsidC-pRRfCP4zj98h6slREw", 
                "100", "10", "感謝您參加猜燈謎活動，祝您元宵節(jié)快樂！", "猜燈謎搶紅包活動",
                "猜越多得越多，快來搶", paternerKey, certPath);


        renderJson(isSend);
    }


    public void query() {
        String query = ReadPackUtils.query("10000098201411111234567890", partner, wxappid, paternerKey, certPath);
        renderJson(query);
    }

}

查詢紅包記錄

【查詢紅包記錄官方文檔】

接口封裝com.javen.weixin.api.RedPackApi.java

private static String getHBInfo = "api.mch.weixin.qq.com/mmpaymkttransfers/gethbinfo ";

    /**
     * 根據(jù)商戶訂單號查詢信息
     * @param params 請求參數(shù)
     * @param certPath 證書文件目錄
     * @param partner 證書密碼
     * @return {String}
     */
    public static String getHbInfo(Map<String, String> params, String certPath, String partner) {
        return HttpUtils.postSSL(getHBInfo, PaymentKit.toXml(params), certPath, partner);
    }

具體實現(xiàn)封裝 com.javen.utils.ReadPackUtils.java

內(nèi)容は次のとおりです:

/**
     * 根據(jù)商戶訂單號查詢紅包
     * @param mch_billno 商戶訂單號
     * @param partner 商戶號
     * @param wxappid 公眾賬號ID
     * @param paternerKey 商戶簽名Key
     * @param certPath 證書路徑
     * @return
     */
    public static String  query(String mch_billno,String partner,String wxappid,String paternerKey,String certPath) {
        Map<String, String> params = new HashMap<String, String>();
        // 隨機字符串
        params.put("nonce_str", System.currentTimeMillis() / 1000 + "");
        // 商戶訂單號
        params.put("mch_billno", mch_billno);
        // 商戶號
        params.put("mch_id", partner);
        // 公眾賬號ID
        params.put("appid", wxappid);
        params.put("bill_type", "MCHT");
        //創(chuàng)建簽名
        String sign = PaymentKit.createSign(params, paternerKey);
        params.put("sign", sign);

        String xmlResult = RedPackApi.getHbInfo(params, certPath, partner);
        Map<String, String> result = PaymentKit.xmlToMap(xmlResult);
        System.out.println(result);
        return JsonKit.toJson(result);
    }

3. リチャージする前に赤い封筒を発行する場合は、十分な資金があることを確認してください。不足の場合は補充してください。操作パス: [販売者プラットフォームへのログイン——>アカウントセンター——>資金管理——>チャージ]

各赤い封筒の平均金額は1.00元から200.00元の間である必要があります

現(xiàn)金赤封筒-recharge.png4. 現(xiàn)在、openid の取得をサポートしています。 WeChat ユーザーの openid は、指定された金額の赤い封筒を発行します。 (openid の取得については、以前に書いた記事を參照してください: ユーザー情報を取得するための WeChat パブリック アカウント認証を迅速に開発する

?? 5. 関連パラメータ設(shè)定 ???? と赤い封筒に関連するパラメータ [主にセキュリティ面: IP のバインド、ユーザーの盜用の防止] ] を選択すると、ページ上で個別に設(shè)定および変更できます。 ??操作パスは次のとおりです: [マーチャント プラットフォームにログイン—>プロダクト センター—>キャッシュ レッド パケット—>商品設(shè)定] (注) : 「製品設(shè)定」操作 ボタン ?? は、現(xiàn)金封入機能 ?? を有効にした後にのみ表示されます。次のパラメータを設(shè)定および変更できます: ??????????Cash Red Packet- Set Parameters.png????手順: ??1. IP アドレスを呼び出す: 設(shè)定後は、設(shè)定された IP アドレスのみを呼び出すことができ、他の IP 呼び出しはエラーを報告します。 ??2. 受信した同じ openid の數(shù)を制限します。 3. アンチブラッシングレベル: アンチブラッシングとは、WeChat アカウント、ゾンビアカウント、マシンアカウントなどの傍受を?qū)澫螭趣筏骏辚攻偿螗去愆`ルを指します。アンチスワイプの強度を変更することで、アンチスワイプの強度を制御できます。 ??4. 同時に赤い封筒の金額の変更を申請することもできますが、WeChat監(jiān)査??、承認されるまで有効になりません。 ????現(xiàn)金赤い封筒カテゴリ??????現(xiàn)金赤い封筒は 2 つに分かれています。 カテゴリ: ??1. 通常の赤い封筒 [公式文書] ] ??2. Fission Red Envelope [公式ドキュメント] ???? 2 つのパラメータは一部異なります ?????? 現(xiàn)金の赤い封筒を送信します???? 1. 通常の赤い封筒のインターフェイス com.javen.RedPackApi.java を送信します。 ??rrreee??2. フィッションレッドエンベロープインターフェイスを送信しますcom.javen.weixin.api.RedPackApi.java??rrreee??特定の実裝パッケージcom.javen.utils .ReadPackUtils.java ??1. 普通の赤い封筒??rrreee??2. 分裂の赤い封筒??rrreee??赤い封筒のデモ??rrreee??赤い封筒の記録をクエリ????【赤い封筒の記録公式ドキュメントをクエリ】????インターフェースパッケージcom .javen.weixin.api.RedPackApi.java??rrreee??特定の実裝パッケージ com.javen.utils.ReadPackUtils.java??rrreee??[関連する推奨事項]????1.アカウント プラットフォームのソース コードのダウンロード??????2. ??WeChat 投票のソース コード??????3. ??WeChat People King v3.4.5 Advanced Business Edition WeChat ルービック キューブのソース コード????

以上がWeChat 公開アカウントで現(xiàn)金封筒を開発する方法に関するサンプル チュートリアルを共有するの詳細內(nèi)容です。詳細については、PHP 中國語 Web サイトの他の関連記事を參照してください。