微信裂變紅包

微信裂變紅包是指微信使用者在收到企業發送的組合紅包之後， 可以再次将紅包中的剩餘金額分享給好友領取的一種現金紅包形式。

春節期間，微信紅包以其獨特的魅力，優秀的使用者體驗和安全的支付環境，一經推出即受到了廣大使用者的熱烈歡迎，現微信支付現金紅包向微信支付商戶開發，具體能力如下： 

1、商戶調用接口時，通過指定發送對象以及發送金額的方式發放紅包，這樣的方式，允許商戶靈活的應用于各種各樣豐富的活動場景

2、領取到紅包後，使用者的資金直接進入微信零錢，避免繁複的領獎流程，帶給使用者微信支付原生的流暢體驗

發送頻率規則

　◆　每分鐘發送紅包數量不得超過1800個；

　◆　中原標準時間0：00-8：00不觸發紅包贈送；（如果以上規則不滿足您的需求，請發郵件至[email protected]擷取更新指引）

紅包規則

　◆　單個紅包金額介于[1.00元，1000.00元]之間；

　◆　裂變組合中的每個紅包平均金額介于[1.00元，200.00元]之間；

　◆　同一組裂變紅包隻能發送給一個使用者；（如果以上規則不滿足您的需求，請發郵件至[email protected]擷取更新指引）

1.紅包發放說明

用于企業向微信使用者個人發裂變紅包

　◆　商戶調用接口時，通過指定發送金額以及指定一位發送對象的方式發放一組紅包

　◆　指定發送對象領取到紅包後，資金直接進入微信零錢，帶給使用者微信支付原生的流暢體驗

　◆　指定發送對象能夠将組合中的剩餘紅包分享給好友，好友可繼續領取，形成傳播效應，放大企業品牌價值

2.接口調用請求說明

請求Url

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

是否需要證書

請求方式

POST

3.請求參數

字段名

字段

必填

示例值

類型

說明

随機字元串

nonce_str

是

5K8264ILTKCH16CQ2502SI8ZNMTM67VS

String(32)

随機字元串，不長于32位

簽名

sign

C380BEC2BFD727A4B6845133519F3AD6

商戶訂單号

mch_billno

10000098201411111234567890

String(28)

商戶訂單号（每個訂單号必須唯一）

組成： mch_id+yyyymmdd+10位一天内不能重複的數字。

接口根據商戶訂單号支援重入， 如出現逾時可再調用。

商戶号

mch_id

10000098

微信支付配置設定的商戶号

子商戶号

sub_mch_id

否

10000090

微信支付配置設定的子商戶号，受理模式下必填

公衆賬号appid

wxappid

wx8888888888888888

商戶appid

商戶名稱

send_name

天虹百貨

紅包發送者名稱

使用者openid

re_openid

oxTWIuGaIt6gTKsQRLau2M0yL16E

接收紅包的種子使用者（首個使用者）

使用者在wxappid下的openid

總金額

total_amount

1000

int

紅包發放總金額，即一組紅包金額總和，包括分享者的紅包和裂變的紅包，機關分

紅包發放總人數

total_num

3

紅包發放總人數，即總共有多少人可以領到該組紅包（包括分享者）

紅包金額設定

amt_type

ALL_RAND

紅包金額設定方式

ALL_RAND—全部随機,商戶指定總金額和紅包發放總人數，由微信支付随機計算出各紅包金額

ALL_SPECIFIED—全部自定義

SEED_SPECIFIED—種子紅包自定義，其他随機

各紅包金額

amt_list

200|100|100

String(256)

各紅包具體金額，自定義金額時必須設定，機關分

紅包祝福語

wishing

感謝您參加猜燈謎活動，祝您元宵節快樂！

String(128)

活動名稱

act_name

猜燈謎搶紅包活動

備注

remark

猜越多得越多，快來搶！

備注資訊

商戶logo的url

logo_imgurl

https://wx.gtimg.com/mch/img/ico-logo.png

商戶logo的url（暫未開放）

背景水印圖檔

watermark_imgurl

背景水印圖檔url

詳情頁banner圖

banner_imgurl

紅包詳情頁面的banner圖檔url

資料示例：

<xml>

            <sign><![CDATA[E1EE61A91C8E90F299DE6AE075D60A2D]]></sign>

            <mch_billno><![CDATA[0010010404201411170000046545]]></mch_billno>

            <mch_id><![CDATA[888]]></mch_id>

            <wxappid><![CDATA[wxcbda96de0b165486]]></wxappid>

            <send_name><![CDATA[send_name]]></send_name>

            <re_openid><![CDATA[onqOjjmM1tad-3ROpncN-yUfa6uI]]></re_openid>

            <total_amount><![CDATA[200]]></total_amount>

            <amt_type><![CDATA[ALL_RAND]]></amt_type>

            <amt_list><![CDATA[200|100|100]]></amt_list>

            <total_num><![CDATA[3]]></total_num>

            <wishing><![CDATA[恭喜發财]]></wishing>

            <act_name><![CDATA[新年紅包]]></act_name>

            <remark><![CDATA[新年紅包]]></remark>

            <logo_imgurl><![CDATA[https://xx/img/wxpaylogo.png]]></logo_imgurl>

            <share_content><![CDATA[share_content]]></share_content>

            <share_url><![CDATA[https://xx/img/wxpaylogo.png]]></share_url>

            <share_imgurl><![CDATA[https:/xx/img/wxpaylogo.png]]></share_imgurl>

            <watermark_imgurl><![CDATA[https:/xx/img/wxpaylogo.png]]></watermark_imgurl>

            <banner_imgurl><![CDATA[https:/xx/img/wxpaylogo.png]]></banner_imgurl>

            <nonce_str><![CDATA[50780e0cca98c8c8e814883e5caa672e]]></nonce_str>

</xml>

4.傳回參數

變量名

傳回狀态碼

return_code

SUCCESS

String(16)

SUCCESS/FAIL

此字段是通信辨別，非交易辨別，交易是否成功需要檢視result_code來判斷

傳回資訊

return_msg

簽名失敗

傳回資訊，如非空，為錯誤原因

參數格式校驗錯誤

以下字段在return_code為SUCCESS的時候有傳回

業務結果

result_code

錯誤代碼

err_code

SYSTEMERROR

錯誤碼資訊

錯誤代碼描述

err_code_des

系統錯誤

結果資訊描述

以下字段在return_code 和result_code都為SUCCESS的時候有傳回

組成： mch_id+yyyymmdd+10位一天内不能重複的數字

總付款金額

總付款金額，機關分

發放成功時間

send_time

20150227091010

String(14)

紅包發放成功時間，格式為yyyyMMddHHmmss，如2015年02月27日9點10分10秒表示為20150227091010

微信單号

send_listid

1000000000201502270093647546

微信紅包訂單号

成功示例：

<xml> 

            <return_code><![CDATA[SUCCESS]]></return_code> 

            <return_msg><![CDATA[發放成功.]]></return_msg> 

            <result_code><![CDATA[SUCCESS]]></result_code> 

            <err_code><![CDATA[0]]></err_code> 

            <err_code_des><![CDATA[發放成功.]]></err_code_des> 

            <mch_billno><![CDATA[0010010404201411170000046545]]></mch_billno> 

            <mch_id>10010404</mch_id> 

            <wxappid><![CDATA[wx6fa7e3bab7e15415]]></wxappid> 

            <re_openid><![CDATA[onqOjjmM1tad-3ROpncN-yUfa6uI]]></re_openid> 

            <total_amount>3</total_amount> 

            <send_time>20150227091010</send_time>

            <send_listid>1000000000201502270093647546</send_listid>

            </xml> 

失敗示例：

            <return_code><![CDATA[FAIL]]></return_code>

             <return_msg><![CDATA[系統繁忙,請稍後再試.]]></return_msg>

             <result_code><![CDATA[FAIL]]></result_code>

             <err_code><![CDATA[268458547]]></err_code>

             <err_code_des><![CDATA[系統繁忙,請稍後再試.]]></err_code_des>

             <mch_billno><![CDATA[0010010404201411170000046542]]></mch_billno>

             <mch_id>10010404</mch_id>

             <wxappid><![CDATA[wx6fa7e3bab7e15415]]></wxappid>

             <re_openid><![CDATA[onqOjjmM1tad-3ROpncN-yUfa6uI]]></re_openid>

             <total_amount>3</total_amount>

5.錯誤碼

錯誤碼

描述

解決方案

CA_ERROR

請求未攜帶證書，或請求攜帶的證書出錯

到商戶平台下載下傳證書，請求帶上證書後重試。

SIGN_ERROR

商戶簽名錯誤

按文檔要求重新生成簽名後再重試。

FREQ_LIMIT

受頻率限制

請對請求做頻率控制

XML_ERROR

請求的xml格式錯誤，或者post的資料為空

檢查請求串，确認無誤後重試

PARAM_ERROR

參數錯誤

請檢視err_code_des，修改設定錯誤的參數

OPENID_ERROR

Openid錯誤

根據使用者在商家公衆賬号上的openid，擷取使用者在紅包公衆賬号上的openid 錯誤。請核對商戶自身公衆号appid和使用者在此公衆号下的openid。

NOTENOUGH

餘額不足

商戶賬号餘額不足，請登入微信支付商戶平台充值

FATAL_ERROR

重複請求時，參數與原單不一緻

使用相同商戶單号進行重複請求時，參數與第一次請求時不一緻，請檢查并修改參數後再重試。

TIME_LIMITED

企業紅包的發送時間受限

請中原標準時間0：00-8：00時間之外觸發紅包贈送

SECOND_OVER_LIMITED

企業紅包的按分鐘發放受限

每分鐘發送紅包數量不得超過1800個；（可聯系微信支付[email protected]調高額度）

DAY_ OVER_LIMITED

企業紅包的按天日發放受限

單個商戶日發送紅包數量不大于10000個；（可聯系微信支付[email protected]調高額度）

MONEY_LIMIT

紅包金額發放限制

每個紅包金額必須大于1元，小于1000元（可聯系微信支付[email protected]調高額度至4999元）

SEND_FAILED

紅包發放失敗,請更換單号再重試

原商戶單号已經失敗，如果還要對同一個使用者發放紅包， 需要更換新的商戶單号再試。

系統繁忙，請再試。

可用同一商戶單号再次調用，隻會發放一個紅包