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
是
5K8264ILTKCH16CQ250