功能
- 商戶調(diào)用接口時(shí)，通過指定發(fā)送對(duì)象以及發(fā)送金額的方式發(fā)放紅包。
- 領(lǐng)取到紅包后，用戶的資金直接進(jìn)入微信零錢。
- 調(diào)用現(xiàn)金紅包接口需要使用到證書，請(qǐng)前往商戶平臺(tái)下載證書。
- 因?yàn)榘l(fā)送現(xiàn)金紅包是從商戶平臺(tái)余額扣款，所以商戶平臺(tái)的賬戶余額必須有充足的余額
接口
請(qǐng)求Url： https://api.mch.weixin.qq.com/mmpaymkttransfers/sendredpack
請(qǐng)求方式： POST
是否需要證書： 是
請(qǐng)求參數(shù)
nonce_str 隨機(jī)字符串，長(zhǎng)度不超32位（必選字段）
sign 簽名（必選字段）
mch_billno 商戶訂單號(hào)，每個(gè)訂單號(hào)必須唯一。接口根據(jù)商戶訂單號(hào)支持重入，如出現(xiàn)超時(shí)可再調(diào)用（必選字段）
mch_id 商戶號(hào)，微信支付分配的商戶號(hào)（必選字段）
wxappid 公眾賬號(hào)appid，微信分配的公眾賬號(hào)ID，接口傳入的所有appid應(yīng)該為公眾號(hào)的appid （必選字段）
send_name 商戶名稱，紅包發(fā)送者名稱（必選字段）
re_openid 用戶openid，接受紅包的用戶。用戶在wxappid下的openid （必選字段）
total_amount 付款金額（必選字段）
total_num 紅包發(fā)放總?cè)藬?shù)（必選字段）
wishing 紅包祝福語(yǔ)（必選字段）
client_ip 調(diào)用接口的機(jī)器ip地址（必選字段）
act_name 活動(dòng)名稱（必選字段）
remark 備注信息（必選字段）
scene_id 發(fā)放紅包使用場(chǎng)景，紅包金額大于200時(shí)必傳（非必選字段）
PRODUCT_1:商品促銷
PRODUCT_2:抽獎(jiǎng)
PRODUCT_3:虛擬物品兌獎(jiǎng)
PRODUCT_4:企業(yè)內(nèi)部福利
PRODUCT_5:渠道分潤(rùn)
PRODUCT_6:保險(xiǎn)回饋
PRODUCT_7:彩票派獎(jiǎng)
PRODUCT_8:稅務(wù)刮獎(jiǎng)
risk_info 活動(dòng)信息（非必選字段）
consume_mch_id 資金授權(quán)商戶號(hào)，服務(wù)商替特約商戶發(fā)放時(shí)使用（非必選字段）
數(shù)據(jù)示例
<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>
<total_num><![CDATA[1]]></total_num>
<wishing><![CDATA[恭喜發(fā)財(cái)]]></wishing>
<client_ip><![CDATA[127.0.0.1]]></client_ip>
<act_name><![CDATA[新年紅包]]></act_name>
<remark><![CDATA[新年紅包]]></remark>
<scene_id><![CDATA[PRODUCT_2]]></scene_id>
<consume_mch_id><![CDATA[10000097]]></consume_mch_id>
<nonce_str><![CDATA[50780e0cca98c8c8e814883e5caa672e]]></nonce_str>
<risk_info>posttime%3d123123412%26clientversion%3d234134%26mobile%3d122344545%26deviceid%3dIOS</risk_info>
</xml>
返回參數(shù)
return_code 返回狀態(tài)碼，此字段是通信標(biāo)識(shí)，非交易標(biāo)識(shí)，交易是否成功需要查看result_code來(lái)判斷（必選字段）
return_msg 返回信息，為錯(cuò)誤原因（非必選字段）
簽名失敗
參數(shù)格式校驗(yàn)錯(cuò)誤
return_code為SUCCESS的時(shí)候返回
sign 簽名（必選字段）
result_code 業(yè)務(wù)結(jié)果（必選字段）
err_code 錯(cuò)誤代碼（非必選字段）
err_code_des 錯(cuò)誤代碼描述（非必選字段）
在return_code和result_code都為SUCCESS的時(shí)候有返回
mch_billno 商戶訂單號(hào)，每個(gè)訂單號(hào)必須唯一。
組成：mch_id+yyyymmdd+10位一天內(nèi)不能重復(fù)的數(shù)字。（必選字段）
mch_id 商戶號(hào)，微信支付分配的商戶號(hào)（必選字段）
wxappid 公眾賬號(hào)，接口傳入的所有appid應(yīng)該為公眾號(hào)的appid （必選字段）
re_openid 用戶openid，接受收紅包的用戶（必選字段）
total_amount 付款金額（必選字段）
send_listid 微信單號(hào)，紅包訂單的微信單號(hào)（必選字段）
成功示例
<xml>
<return_code><![CDATA[SUCCESS]]></return_code>
<return_msg><![CDATA[發(fā)放成功.]]></return_msg>
<result_code><![CDATA[SUCCESS]]></result_code>
<err_code><![CDATA[0]]></err_code>
<err_code_des><![CDATA[發(fā)放成功.]]></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>1</total_amount>
</xml>
失敗示例
<xml>
<return_code><![CDATA[FAIL]]></return_code>
<return_msg><![CDATA[系統(tǒng)繁忙,請(qǐng)稍后再試.]]></return_msg>
<result_code><![CDATA[FAIL]]></result_code>
<err_code><![CDATA[268458547]]></err_code>
<err_code_des><![CDATA[系統(tǒng)繁忙,請(qǐng)稍后再試.]]></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>1</total_amount>
</xml>
附注
簽名算法
假設(shè)傳送的參數(shù)如下：
appid： wxd930ea5d5a258f4f
mch_id： 10000100
device_info： 1000
body： test
nonce_str： ibuaiVcKdpRxkhJA
第一步，設(shè)所有發(fā)送或者接收到的數(shù)據(jù)為集合M，將集合M內(nèi)非空參數(shù)值的參數(shù)按照參數(shù)名ASCII碼從小到大排序（字典序），使用URL鍵值對(duì)的格式（即key1=value1&key2=value2…）拼接成字符串stringA。
stringA="appid=wxd930ea5d5a258f4f&body=test&device_info=1000&mch_id=10000100&nonce_str=ibuaiVcKdpRxkhJA";
特別注意以下重要規(guī)則：
· 參數(shù)名ASCII碼從小到大排序（字典序）；
· 如果參數(shù)的值為空不參與簽名；
· 參數(shù)名區(qū)分大小寫；
· 驗(yàn)證調(diào)用返回或微信主動(dòng)通知簽名時(shí)，傳送的sign參數(shù)不參與簽名，將生成的簽名與該sign值作校驗(yàn)。
· 微信接口可能增加字段，驗(yàn)證簽名時(shí)必須支持增加的擴(kuò)展字段
第二步，在stringA最后拼接上key得到stringSignTemp字符串，并對(duì)stringSignTemp進(jìn)行MD5運(yùn)算，再將得到的字符串所有字符轉(zhuǎn)換為大寫，得到sign值signValue。
key設(shè)置路徑：微信商戶平臺(tái)(pay.weixin.qq.com)-->賬戶設(shè)置-->API安全-->密鑰設(shè)置
stringSignTemp=stringA+"&key=192006250b4c09247ec02edce69f6a2d" //注：key為商戶平臺(tái)設(shè)置的密鑰key
sign=MD5(stringSignTemp).toUpperCase()="9A0A8659F005D6984697E2CA0A9CF3B7" //注：MD5簽名方式
sign=hash_hmac("sha256",stringSignTemp,key).toUpperCase()="6A9AE1657590FD6257D693A078E1C3E4BB6BA4DC30B23E0EE2496E54170DACD6" //注：HMAC-SHA256簽名方式
第三步，轉(zhuǎn)化為xml格式發(fā)送到微信服務(wù)器。
<xml>
<appid>wxd930ea5d5a258f4f</appid>
<mch_id>10000100</mch_id>
<device_info>1000<device_info>
<body>test</body>
<nonce_str>ibuaiVcKdpRxkhJA</nonce_str>
<sign>9A0A8659F005D6984697E2CA0A9CF3B7</sign>
<xml>
