发放企业红包 - 文档 - 企业微信开发者中心

link管理

链接快照平台

输入网页链接，自动生成快照
标签化管理网页链接

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

请求示例：

< nonce_str > 5 K8264ILTKCH16CQ2502SI8ZNMTM67VS < / nonce_str > < sign > C380BEC2BFD727A4B6845133519F3AD6 < / sign > < mch_billno > 123456 < / mch_billno > < mch_id > 10000098 < / mch_id > < wxappid > wx8888888888888888 < / wxappid > < sender_name > XX 活动 < / sender_name > < sender_header_media_id > 1 G6nrLmr5EC3MMb_ - zK1dDdzmd0p7cNliYu9V5w7o8K0 < / sender_header_media_id > < re_openid > oxTWIuGaIt6gTKsQRLau2M0yL16E < / re_openid > < total_amount > 1000 < / total_amount > < wishing > 感谢您参加猜灯谜活动，祝您元宵节快乐！ < / wishing > < act_name > 猜灯谜抢红包活动 < / act_name > < remark > 猜越多得越多，快来抢！ < / remark > < workwx_sign > 99 BCDAFF065A4B95628E3DB468A874A8 < / workwx_sign > < / xml >

参数说明：

字段名	字段	必填	示例值	类型	说明
随机字符串	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参见：https://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 > < ! [ CDATA [ SUCCESS ] ] > < / return_code > < return_msg > < ! [ CDATA [ ok ] ] > < / return_msg > < sign > < ! [ CDATA [ C380BEC2BFD727A4B6845133519F3AD6 ] ] > < / sign > < result_code > < ! [ CDATA [ SUCCESS ] ] > < / result_code > < mch_billno > < ! [ CDATA [ 123456 ] ] > < / mch_billno > < mch_id > < ! [ CDATA [ 10000098 ] ] > < / mch_id > < wxappid > < ! [ CDATA [ wx8888888888888888 ] ] > < / wxappid > < re_openid > < ! [ CDATA [ oxTWIuGaIt6gTKsQRLau2M0yL16E ] ] > < / re_openid > < total_amount > < ! [ CDATA [ 1000 ] ] > < / total_amount > < send_listid > < ! [ CDATA [ 235785324578098 ] ] > < / send_listid > < sender_name > < ! [ CDATA [ XX 活动 ] ] > < / sender_name > < sender_header_media_id > < ! [ CDATA [ 1 G6nrLmr5EC3MMb_ - zK1dDdzmd0p7cNliYu9V5w7o8K0 ] ] > < / sender_header_media_id > < / xml >