API接口協議

發放規則：

發送頻率限制———默認1800/min

發送個數上限———默認1800/min

場景金額限制———默認紅包金額為1-200元，如有需要，可前往商戶平臺進行設置和申請

其他限制———商戶單日出資金額上限—100萬元；單用戶單日收款金額上限—1000元；單用戶可領取紅包個數上限—10個

注意事項：

紅包金額大于200或者小于1元時，請求參數scene_id必傳，參數說明見下文。

根據監管要求，新申請商戶號使用現金紅包需要滿足兩個條件：1、入駐時間超過90天 2、連續正常交易30天。

移動應用的appid無法使用紅包接口。

當返回錯誤碼為“SYSTEMERROR”時，請不要更換商戶訂單號，一定要使用原商戶訂單號重試，否則可能造成重復發放紅包等資金風險。

XML具有可擴展性，因此返回參數可能會有新增，而且順序可能不完全遵循此文檔規范，如果在解析回包的時候發生錯誤，請商戶務必不要換單重試，請商戶聯系客服確認紅包發放情況。如果有新回包字段，會更新到此API文檔中。

因為錯誤代碼字段err_code的值后續可能會增加，所以商戶如果遇到回包返回新的錯誤碼，請商戶務必不要換單重試，請商戶聯系客服確認紅包發放情況。如果有新的錯誤碼，會更新到此API文檔中。

錯誤代碼描述字段err_code_des只供人工定位問題時做參考，系統實現時請不要依賴這個字段來做自動化處理。

請商戶在自身的系統中合理設置發放頻次并做好并發控制，防范錯付風險。

因商戶自身系統設置存在問題導致的資金損失，由商戶自行承擔。

請求方式：POST(HTTPS)

請求地址：https://api.mch.weixin.qq.com/mmpaymkttransfers/sendworkwxredpack

是否需要證書：是

數據格式：xml

證書使用詳見：https://pay.weixin.qq.com/wiki/doc/api/tools/mch_pay.php?chapter=4_3

請求示例：

5K8264ILTKCH16CQ2502SI8ZNMTM67VS

C380BEC2BFD727A4B6845133519F3AD6

123456

10000098

wx8888888888888888

XX活動

1G6nrLmr5EC3MMb_-zK1dDdzmd0p7cNliYu9V5w7o8K0

oxTWIuGaIt6gTKsQRLau2M0yL16E

1000

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

猜燈謎搶紅包活動

猜越多得越多，快來搶！

99BCDAFF065A4B95628E3DB468A874A8

參數說明：

字段名

字段

必填

示例值

類型

說明

隨機字符串

nonce_str

是

5K8264ILTKCH16CQ2502SI8ZNMTM67VS

String(32)

隨機字符串，不長于32位

微信支付簽名

sign

是

C380BEC2BFD727A4B6845133519F3AD6

String(32)

參見“簽名算法”

商戶訂單號

mch_billno

是

123456

String(28)

商戶訂單號(每個訂單號必須唯一。取值范圍：0~9，a~z，A~Z).接口根據商戶訂單號支持重入，如出現超時可再調用。組成參考：mch_id+yyyymmdd+10位一天內不能重復的數字

商戶號

mch_id

是

10000098

String(32)

微信支付分配的商戶號

公眾賬號appid

wxappid

是

wx8888888888888888

String(32)

微信分配的公眾賬號ID(企業微信corpid即為此appId)。接口傳入的所有appid應該為公眾號的appid(在mp.weixin.qq.com申請的)，不能為APP的appid(在open.weixin.qq.com申請的)。

發送者名稱

sender_name

否

XX活動

String(128)

以個人名義發紅包，紅包發送者名稱(需要utf-8格式)。與agentid互斥，二者只能填一個。

發送紅包的應用id

agentid

否

1

unsigned int

以企業應用的名義發紅包，企業應用id，整型，可在企業微信管理端應用的設置頁面查看。與sender_name互斥，二者只能填一個。

發送者頭像

sender_header_media_id

否

1G6nrLmr5EC3MMb_-zK1dDdzmd0p7cNliYu9V5w7o8K0

String(128)

發送者頭像素材id，通過企業微信開放上傳素材接口獲取

用戶openid

re_openid

是

oxTWIuGaIt6gTKsQRLau2M0yL16E

String(32)

接受紅包的用戶.用戶在wxappid下的openid。獲取用戶openid參見：http://work.weixin.qq.com/api/doc#11279

金額

total_amount

是

1000

int

金額，單位分，單筆最小金額默認為1元

紅包祝福語

wishing

是

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

String(128)

紅包祝福語

項目名稱

act_name

是

猜燈謎搶紅包活動

String(32)

項目名稱

備注

remark

是

猜越多得越多，快來搶！

String(256)

備注信息

場景

scene_id

否

PRODUCT_1

String(32)

發放紅包使用場景，紅包金額大于200或者小于1元時必傳

PRODUCT_1:商品促銷

PRODUCT_2:抽獎

PRODUCT_3:虛擬物品兌獎

PRODUCT_4:企業內部福利

PRODUCT_5:渠道分潤

PRODUCT_6:保險回饋

PRODUCT_7:彩票派獎

PRODUCT_8:稅務刮獎

企業微信簽名

workwx_sign

是

企業微信簽名

String(32)

參見“簽名算法”

返回結果 ：

返回參數:

字段名

字段

必填

示例值

類型

說明

返回狀態碼

return_code

是

SUCCESS

String(16)

SUCCESS/FAIL 此字段是通信標識，非交易標識，交易是否成功需要查看result_code來判斷

返回信息

return_msg

否

簽名失敗

String(128)

返回信息，如非空，為錯誤原因

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

字段名

字段

必填

示例值

類型

說明

微信支付簽名

sign

是

C380BEC2BFD727A4B6845133519F3AD6

String(32)

微信支付簽名

業務結果

result_code

是

SUCCESS

String(16)

SUCCESS/FAIL

錯誤代碼

err_code

否

SYSTEMERROR

String(32)

錯誤碼信息

錯誤代碼描述

err_code_des

否

系統錯誤

String(128)

結果信息描述

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

字段名

字段

必填

示例值

類型

說明

商戶訂單號

mch_billno

是

1E+25

String(28)

商戶訂單號(每個訂單號必須唯一)組成：mch_id+yyyymmdd+10位一天內不能重復的數字

商戶號

mch_id

是

10000098

String(32)

微信支付分配的商戶號

公眾賬號appid

wxappid

是

wx8888888888888888

String(32)

商戶appid，接口傳入的所有appid應該為公眾號的appid(在mp.weixin.qq.com申請的)，不能為APP的appid(在open.weixin.qq.com申請的)

用戶openid

re_openid

是

oxTWIuGaIt6gTKsQRLau2M0yL16E

String(32)

接受收紅包的用戶在wxappid下的openid

付款金額

total_amount

是

1000

int

付款金額，單位分

微信單號

send_listid

是

1E+29

String(32)

紅包訂單的微信單號

發送者名稱

sender_name

是

XX活動

String(128)

紅包發送者名稱(需要utf-8格式)

發送者頭像

sender_header_media_id

是

1G6nrLmr5EC3MMb_-zK1dDdzmd0p7cNliYu9V5w7o8K0

String(128)

發送者頭像素材id，通過企業微信開放上傳素材接口獲取

錯誤碼:

錯誤碼

錯誤描述

原因

解決方式

NO_AUTH

發放失敗，此請求可能存在風險，已被微信攔截

用戶賬號異常，被攔截

請提醒用戶檢查自身帳號是否異常。使用常用的活躍的微信號可避免這種情況。

SENDNUM_LIMIT

該用戶今日領取紅包個數超過限制

該用戶今日領取紅包個數超過你在微信支付商戶平臺配置的上限

如有需要、請在微信支付商戶平臺-現金紅包-產品設置中重新配置 【每日同一用戶領取本商戶紅包不允許超過的個數】。

SENDAMOUNT_LIMIT

您的商戶號今日發放金額超過限制，如有需要請登錄微信支付商戶平臺更改API安全配置

商戶今日發放的總金額超過您在微信支付商戶平臺配置的上限

如有需要，請聯系管理員在商戶平臺-現金紅包-產品設置上調整單日發送金額上限。

RCVDAMOUNT_LIMIT

該用戶今日領取金額超過限制，如有需要請登錄微信支付商戶平臺更改API安全配置

該用戶今日領取紅包總金額超過您在微信支付商戶平臺配置的上限

如有需要，請聯系管理員在商戶平臺-現金紅包-產品設置上調整單用戶單日領取金額上限。

ILLEGAL_APPID

非法appid，請確認是否為公眾號的appid，不能為APP的appid

錯誤傳入了app的appid

接口傳入的所有appid應該為公眾號的appid(在mp.weixin.qq.com申請的)，不能為APP的appid(在open.weixin.qq.com申請的)。

MONEY_LIMIT

紅包金額發放限制

發送紅包金額不在限制范圍內

每個紅包金額必須在默認額度內(默認大于1元，小于200元，可在產品設置中自行申請調高額度)

SEND_FAILED

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

該紅包已經發放失敗

如果需要重新發放，請更換單號再發放

FATAL_ERROR

openid和原始單參數不一致

更換了openid，但商戶單號未更新

請商戶檢查代碼實現邏輯

CA_ERROR

CA證書出錯，請登錄微信支付商戶平臺下載證書

請求攜帶的證書出錯

到商戶平臺下載證書，請求帶上證書后重試

SIGN_ERROR

簽名錯誤；企業微信簽名失敗

1. 沒有使用商戶平臺設置的商戶API密鑰進行加密(有可能之前設置過密鑰，后來被修改了，沒有使用新的密鑰進行加密)。

2. 加密前沒有按照文檔進行參數排序(可參考文檔)。

3. 把值為空的參數也進行了簽名。可到(http://mch.weixin.qq.com/wiki/tools/signverify/ )驗證。

4. 如果以上3步都沒有問題，把請求串中(post的數據)里面中文都去掉，換成英文，試下，看看是否是編碼問題。(post的數據要求是utf8)

5. 沒有按照企業微信簽名算法進行簽名

1. 到商戶平臺重新設置新的密鑰后重試；

2. 檢查請求參數把空格去掉重試；

3. 中文不需要進行encode，使用CDATA；

4. 按文檔要求生成簽名后再重試；

5. 檢查企業微信支付應用secret是否和企業微信管理端支付應用的secret保持一致；檢查參與企業微信簽名的字段是否和簽名算法里面的字段保持一直。

SYSTEMERROR

請求已受理，請稍后使用原單號查詢發放結果

系統無返回明確發放結果

使用原單號調用接口，查詢發放結果，如果使用新單號調用接口，視為新發放請求

XML_ERROR

輸入xml參數格式錯誤

請求的xml格式錯誤，或者post的數據為空

檢查請求串，確認無誤后重試

FREQ_LIMIT

超過頻率限制,請稍后再試

受頻率限制

請對請求做頻率控制(可聯系微信支付wxhongbao@tencent.com申請調高)

NOTENOUGH

帳號余額不足，請到商戶平臺充值后再重試

賬戶余額不足

充值后重試

OPENID_ERROR

openid和appid不匹配

openid和appid不匹配

發紅包的openid必須是本appid下的openid

PROCESSING

請求已受理，請稍后使用原單號查詢發放結果

發紅包流程正在處理

二十分鐘后查詢,按照查詢結果成功失敗進行處理

PARAM_ERROR

請求參數錯誤

請求攜帶的字段非法(或者沒填)

請檢查字段后重試;如果是重試請求，請與原單請求的金額保持一致。

NO_COMPETENCE

商戶號錯誤

該商戶號沒有開通企業支付

該商戶號沒有開通企業支付，請登錄企業微信管理端，進入企業支付應用核對商戶號是否正確

API_METHOD_CLOSED

您的商戶號API發放方式已關閉，請聯系管理員在商戶平臺開啟。

商戶API發放方式處于關閉狀態

請聯系管理員在微信支付商戶平臺開啟。

總結

以上是生活随笔為你收集整理的企业微信发送企业红包java_发放企业红包的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。