企业微信发送企业红包java_发放企业红包
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)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 《看恽家牡丹花戏赠李二十》第四句是什么
- 下一篇: qq企业邮箱 java发送_spring