API接口協(xié)議

發(fā)放規(guī)則：

發(fā)送頻率限制———默認(rèn)1800/min

發(fā)送個(gè)數(shù)上限———默認(rèn)1800/min

場(chǎng)景金額限制———默認(rèn)紅包金額為1-200元，如有需要，可前往商戶平臺(tái)進(jìn)行設(shè)置和申請(qǐng)

其他限制———商戶單日出資金額上限—100萬元；單用戶單日收款金額上限—1000元；單用戶可領(lǐng)取紅包個(gè)數(shù)上限—10個(gè)

注意事項(xiàng)：

紅包金額大于200或者小于1元時(shí)，請(qǐng)求參數(shù)scene_id必傳，參數(shù)說明見下文。

根據(jù)監(jiān)管要求，新申請(qǐng)商戶號(hào)使用現(xiàn)金紅包需要滿足兩個(gè)條件：1、入駐時(shí)間超過90天 2、連續(xù)正常交易30天。

移動(dòng)應(yīng)用的appid無法使用紅包接口。

當(dāng)返回錯(cuò)誤碼為“SYSTEMERROR”時(shí)，請(qǐng)不要更換商戶訂單號(hào)，一定要使用原商戶訂單號(hào)重試，否則可能造成重復(fù)發(fā)放紅包等資金風(fēng)險(xiǎn)。

XML具有可擴(kuò)展性，因此返回參數(shù)可能會(huì)有新增，而且順序可能不完全遵循此文檔規(guī)范，如果在解析回包的時(shí)候發(fā)生錯(cuò)誤，請(qǐng)商戶務(wù)必不要換單重試，請(qǐng)商戶聯(lián)系客服確認(rèn)紅包發(fā)放情況。如果有新回包字段，會(huì)更新到此API文檔中。

因?yàn)殄e(cuò)誤代碼字段err_code的值后續(xù)可能會(huì)增加，所以商戶如果遇到回包返回新的錯(cuò)誤碼，請(qǐng)商戶務(wù)必不要換單重試，請(qǐng)商戶聯(lián)系客服確認(rèn)紅包發(fā)放情況。如果有新的錯(cuò)誤碼，會(huì)更新到此API文檔中。

錯(cuò)誤代碼描述字段err_code_des只供人工定位問題時(shí)做參考，系統(tǒng)實(shí)現(xiàn)時(shí)請(qǐng)不要依賴這個(gè)字段來做自動(dòng)化處理。

請(qǐng)商戶在自身的系統(tǒng)中合理設(shè)置發(fā)放頻次并做好并發(fā)控制，防范錯(cuò)付風(fēng)險(xiǎn)。

因商戶自身系統(tǒng)設(shè)置存在問題導(dǎo)致的資金損失，由商戶自行承擔(dān)。

請(qǐng)求方式：POST(HTTPS)

請(qǐng)求地址：https://api.mch.weixin.qq.com/mmpaymkttransfers/sendworkwxredpack

是否需要證書：是

數(shù)據(jù)格式：xml

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

請(qǐng)求示例：

5K8264ILTKCH16CQ2502SI8ZNMTM67VS

C380BEC2BFD727A4B6845133519F3AD6

123456

10000098

wx8888888888888888

XX活動(dòng)

1G6nrLmr5EC3MMb_-zK1dDdzmd0p7cNliYu9V5w7o8K0

oxTWIuGaIt6gTKsQRLau2M0yL16E

1000

感謝您參加猜燈謎活動(dòng)，祝您元宵節(jié)快樂！

猜燈謎搶紅包活動(dòng)

猜越多得越多，快來搶！

99BCDAFF065A4B95628E3DB468A874A8

參數(shù)說明：

字段名

字段

必填

示例值

類型

說明

隨機(jī)字符串

nonce_str

是

5K8264ILTKCH16CQ2502SI8ZNMTM67VS

String(32)

隨機(jī)字符串，不長于32位

微信支付簽名

sign

是

C380BEC2BFD727A4B6845133519F3AD6

String(32)

參見“簽名算法”

商戶訂單號(hào)

mch_billno

是

123456

String(28)

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

商戶號(hào)

mch_id

是

10000098

String(32)

微信支付分配的商戶號(hào)

公眾賬號(hào)appid

wxappid

是

wx8888888888888888

String(32)

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

發(fā)送者名稱

sender_name

否

XX活動(dòng)

String(128)

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

發(fā)送紅包的應(yīng)用id

agentid

否

1

unsigned int

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

發(fā)送者頭像

sender_header_media_id

否

1G6nrLmr5EC3MMb_-zK1dDdzmd0p7cNliYu9V5w7o8K0

String(128)

發(fā)送者頭像素材id，通過企業(yè)微信開放上傳素材接口獲取

用戶openid

re_openid

是

oxTWIuGaIt6gTKsQRLau2M0yL16E

String(32)

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

金額

total_amount

是

1000

int

金額，單位分，單筆最小金額默認(rèn)為1元

紅包祝福語

wishing

是

感謝您參加猜燈謎活動(dòng)，祝您元宵節(jié)快樂！

String(128)

紅包祝福語

項(xiàng)目名稱

act_name

是

猜燈謎搶紅包活動(dòng)

String(32)

項(xiàng)目名稱

備注

remark

是

猜越多得越多，快來搶！

String(256)

備注信息

場(chǎng)景

scene_id

否

PRODUCT_1

String(32)

發(fā)放紅包使用場(chǎng)景，紅包金額大于200或者小于1元時(shí)必傳

PRODUCT_1:商品促銷

PRODUCT_2:抽獎(jiǎng)

PRODUCT_3:虛擬物品兌獎(jiǎng)

PRODUCT_4:企業(yè)內(nèi)部福利

PRODUCT_5:渠道分潤

PRODUCT_6:保險(xiǎn)回饋

PRODUCT_7:彩票派獎(jiǎng)

PRODUCT_8:稅務(wù)刮獎(jiǎng)

企業(yè)微信簽名

workwx_sign

是

企業(yè)微信簽名

String(32)

參見“簽名算法”

返回結(jié)果 ：

返回參數(shù):

字段名

字段

必填

示例值

類型

說明

返回狀態(tài)碼

return_code

是

SUCCESS

String(16)

SUCCESS/FAIL 此字段是通信標(biāo)識(shí)，非交易標(biāo)識(shí)，交易是否成功需要查看result_code來判斷

返回信息

return_msg

否

簽名失敗

String(128)

返回信息，如非空，為錯(cuò)誤原因

以下字段在return_code為SUCCESS的時(shí)候有返回:

字段名

字段

必填

示例值

類型

說明

微信支付簽名

sign

是

C380BEC2BFD727A4B6845133519F3AD6

String(32)

微信支付簽名

業(yè)務(wù)結(jié)果

result_code

是

SUCCESS

String(16)

SUCCESS/FAIL

錯(cuò)誤代碼

err_code

否

SYSTEMERROR

String(32)

錯(cuò)誤碼信息

錯(cuò)誤代碼描述

err_code_des

否

系統(tǒng)錯(cuò)誤

String(128)

結(jié)果信息描述

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

字段名

字段

必填

示例值

類型

說明

商戶訂單號(hào)

mch_billno

是

1E+25

String(28)

商戶訂單號(hào)(每個(gè)訂單號(hào)必須唯一)組成：mch_id+yyyymmdd+10位一天內(nèi)不能重復(fù)的數(shù)字

商戶號(hào)

mch_id

是

10000098

String(32)

微信支付分配的商戶號(hào)

公眾賬號(hào)appid

wxappid

是

wx8888888888888888

String(32)

商戶appid，接口傳入的所有appid應(yīng)該為公眾號(hào)的appid(在mp.weixin.qq.com申請(qǐng)的)，不能為APP的appid(在open.weixin.qq.com申請(qǐng)的)

用戶openid

re_openid

是

oxTWIuGaIt6gTKsQRLau2M0yL16E

String(32)

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

付款金額

total_amount

是

1000

int

付款金額，單位分

微信單號(hào)

send_listid

是

1E+29

String(32)

紅包訂單的微信單號(hào)

發(fā)送者名稱

sender_name

是

XX活動(dòng)

String(128)

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

發(fā)送者頭像

sender_header_media_id

是

1G6nrLmr5EC3MMb_-zK1dDdzmd0p7cNliYu9V5w7o8K0

String(128)

發(fā)送者頭像素材id，通過企業(yè)微信開放上傳素材接口獲取

錯(cuò)誤碼:

錯(cuò)誤碼

錯(cuò)誤描述

原因

解決方式

NO_AUTH

發(fā)放失敗，此請(qǐng)求可能存在風(fēng)險(xiǎn)，已被微信攔截

用戶賬號(hào)異常，被攔截

請(qǐng)?zhí)嵝延脩魴z查自身帳號(hào)是否異常。使用常用的活躍的微信號(hào)可避免這種情況。

SENDNUM_LIMIT

該用戶今日領(lǐng)取紅包個(gè)數(shù)超過限制

該用戶今日領(lǐng)取紅包個(gè)數(shù)超過你在微信支付商戶平臺(tái)配置的上限

如有需要、請(qǐng)?jiān)谖⑿胖Ц渡虘羝脚_(tái)-現(xiàn)金紅包-產(chǎn)品設(shè)置中重新配置 【每日同一用戶領(lǐng)取本商戶紅包不允許超過的個(gè)數(shù)】。

SENDAMOUNT_LIMIT

您的商戶號(hào)今日發(fā)放金額超過限制，如有需要請(qǐng)登錄微信支付商戶平臺(tái)更改API安全配置

商戶今日發(fā)放的總金額超過您在微信支付商戶平臺(tái)配置的上限

如有需要，請(qǐng)聯(lián)系管理員在商戶平臺(tái)-現(xiàn)金紅包-產(chǎn)品設(shè)置上調(diào)整單日發(fā)送金額上限。

RCVDAMOUNT_LIMIT

該用戶今日領(lǐng)取金額超過限制，如有需要請(qǐng)登錄微信支付商戶平臺(tái)更改API安全配置

該用戶今日領(lǐng)取紅包總金額超過您在微信支付商戶平臺(tái)配置的上限

如有需要，請(qǐng)聯(lián)系管理員在商戶平臺(tái)-現(xiàn)金紅包-產(chǎn)品設(shè)置上調(diào)整單用戶單日領(lǐng)取金額上限。

ILLEGAL_APPID

非法appid，請(qǐng)確認(rèn)是否為公眾號(hào)的appid，不能為APP的appid

錯(cuò)誤傳入了app的appid

接口傳入的所有appid應(yīng)該為公眾號(hào)的appid(在mp.weixin.qq.com申請(qǐng)的)，不能為APP的appid(在open.weixin.qq.com申請(qǐng)的)。

MONEY_LIMIT

紅包金額發(fā)放限制

發(fā)送紅包金額不在限制范圍內(nèi)

每個(gè)紅包金額必須在默認(rèn)額度內(nèi)(默認(rèn)大于1元，小于200元，可在產(chǎn)品設(shè)置中自行申請(qǐng)調(diào)高額度)

SEND_FAILED

紅包發(fā)放失敗,請(qǐng)更換單號(hào)再重試

該紅包已經(jīng)發(fā)放失敗

如果需要重新發(fā)放，請(qǐng)更換單號(hào)再發(fā)放

FATAL_ERROR

openid和原始單參數(shù)不一致

更換了openid，但商戶單號(hào)未更新

請(qǐng)商戶檢查代碼實(shí)現(xiàn)邏輯

CA_ERROR

CA證書出錯(cuò)，請(qǐng)登錄微信支付商戶平臺(tái)下載證書

請(qǐng)求攜帶的證書出錯(cuò)

到商戶平臺(tái)下載證書，請(qǐng)求帶上證書后重試

SIGN_ERROR

簽名錯(cuò)誤；企業(yè)微信簽名失敗

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

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

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

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

5. 沒有按照企業(yè)微信簽名算法進(jìn)行簽名

1. 到商戶平臺(tái)重新設(shè)置新的密鑰后重試；

2. 檢查請(qǐng)求參數(shù)把空格去掉重試；

3. 中文不需要進(jìn)行encode，使用CDATA；

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

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

SYSTEMERROR

請(qǐng)求已受理，請(qǐng)稍后使用原單號(hào)查詢發(fā)放結(jié)果

系統(tǒng)無返回明確發(fā)放結(jié)果

使用原單號(hào)調(diào)用接口，查詢發(fā)放結(jié)果，如果使用新單號(hào)調(diào)用接口，視為新發(fā)放請(qǐng)求

XML_ERROR

輸入xml參數(shù)格式錯(cuò)誤

請(qǐng)求的xml格式錯(cuò)誤，或者post的數(shù)據(jù)為空

檢查請(qǐng)求串，確認(rèn)無誤后重試

FREQ_LIMIT

超過頻率限制,請(qǐng)稍后再試

受頻率限制

請(qǐng)對(duì)請(qǐng)求做頻率控制(可聯(lián)系微信支付wxhongbao@tencent.com申請(qǐng)調(diào)高)

NOTENOUGH

帳號(hào)余額不足，請(qǐng)到商戶平臺(tái)充值后再重試

賬戶余額不足

充值后重試

OPENID_ERROR

openid和appid不匹配

openid和appid不匹配

發(fā)紅包的openid必須是本appid下的openid

PROCESSING

請(qǐng)求已受理，請(qǐng)稍后使用原單號(hào)查詢發(fā)放結(jié)果

發(fā)紅包流程正在處理

二十分鐘后查詢,按照查詢結(jié)果成功失敗進(jìn)行處理

PARAM_ERROR

請(qǐng)求參數(shù)錯(cuò)誤

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

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

NO_COMPETENCE

商戶號(hào)錯(cuò)誤

該商戶號(hào)沒有開通企業(yè)支付

該商戶號(hào)沒有開通企業(yè)支付，請(qǐng)登錄企業(yè)微信管理端，進(jìn)入企業(yè)支付應(yīng)用核對(duì)商戶號(hào)是否正確

API_METHOD_CLOSED

您的商戶號(hào)API發(fā)放方式已關(guān)閉，請(qǐng)聯(lián)系管理員在商戶平臺(tái)開啟。

商戶API發(fā)放方式處于關(guān)閉狀態(tài)

請(qǐng)聯(lián)系管理員在微信支付商戶平臺(tái)開啟。

總結(jié)

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

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。