微信支付商户发放现金红包操作说明

一、 现金红包简介

微信红包，2014年春节一经推出即受到广大用户好评，引发全民抢红包热潮。现将微信红包打造成“现金红包”，成为一款定向资金发放的营销工具，供商户使用.

二、 什么商户有资格申请

只要您开通了微信支付，并使用新支付接口开发（公众号支付、刷卡支付），都可以使用现金红包，无需申请

备注：新支付接口开发使用MCHID、支付密钥，不再使用Paysignkey

三、 发放方式介绍

商户发放现金红包有3种发放方式：

• 接口发放

商户根据文档“【商户平台】现金红包API文档V2”进行开发，一次调用可以给一个指定用户发送一个指定金额的红包，满足多元化的运营需求

• 通过上传openid文件发放

收集要发送红包对象的openid，将openid编辑成txt文件，登录微信支付商户平台，使用上传文件功能发放。一份文件对应一个红包模板，便于管理。

获取openid参见微信公众平台开发者文档: 网页授权获取用户基本信息

• 配置营销规则“满额送”发放

商户可以在商户平台配置自助规则：用户使用微信支付发生交易满足一定条件，立送现金红包

四、 税务和发票问题

商户给用户发红包，资金最终进入用户零钱，微信支付并未从中收取资金作为营收，所以不予开具发票，请您理解。发放现金红包请您遵照国家法律依法纳税，在您充值之前，我们默认您已经合法上税，您使用本功能的行为若涉及纳税或代扣代缴税款的义务，由您自行承担该义务，在您充值之前，微信支付默认您已经合法上税，腾讯公司不会替您缴纳税款，请您知晓

五、 接口发放现金红包详细介绍

1、 接口文档

接口文档详见http://pay.weixin.qq.com/wiki/doc/api/cash_coupon.php?chapter=13_1

备注：

1） 现金红包接口之前已经推出过一版接口，由于接口升级，旧接口不再维护

2） 旧接口需要商户开通财付通的充值功能并签订委托代扣协议，登录财付通商户平台进行充值，新接口完全开放，无需这些手续

2、 接口限制以及调整办法

• 接口有发送频率、金额、发送时间的限制：

普通限制（默认配置无需申请）高级限制（达到标准的商户可发邮件申请）发放频率每分钟上限1800个红包每分钟上限5000个红包金额一个红包金额在1~200元之间一个红包金额在1~4999元之间发放时间北京时间早上0点~8点不发放无限制

• 如果您活动总金额大于100W元/月，可以申请高级限制，请按照下述邮件格式发邮件申请：

收件人：[e-mail]

主题：xx（商户名）申请调高现金红包接口限制

内容：

1、 商户号：

2、 活动形式/规则：

3、 活动时间（过期将回退至普通限制）：

4、 活动总金额：

5、 申请提高何种限制（发送频率、金额、发送时间，可多选）：

6、 预估峰值每分钟发放次数：

7、 预估峰值每日发放次数：

8、 红包金额需要调整至：

3、 具体操作步骤

1） 登录微信支付商户平台

在调用接口前有一些工作需要商户登录微信支付商户平台进行操作，请使用微信支付商户号和密码登录

备注：

微信支付商户平台地址为pay.weixin.qq.com。微信支付商户号会在商户申请微信支付成功后，通过开户邮件发送给您。

请不要使用微信公众平台账号或者appid登录。如果您登录时遇到问题，请联系微信支付小助手[e-mail]

2） 下载证书并设置密钥

调用微信红包接口时，服务器会进行证书验证：验证调用接口的商户号（字段：mch_id）的证书和密钥，请在商户平台下载证书并设置密钥

3） 给商户号进行充值

发放现金红包将扣除商户的可用余额，请注意，可用余额并不是微信支付交易额，需要预先充值，确保可用余额充足。登录微信支付商户平台，进入“资金管理”菜单，可以查看可用余额、充值、或者提现

充值和提现相关帮助请参见     http://kf.qq.com/menu/5699_1.html

4） 根据文档进行开发

请您仔细阅读接口文档，参照文档进行开发，请注意，为了保证商户资金安全，接口强校验商户号与appid之间的绑定关系，以及appid与openid之间的对应关系

如果商户号与appid之间没有绑定关系，即appid没有申请微信支付或者申 请微信支付商户号不匹配，或者openid归属appid错误，接口会返回报错

5） 对账

登录商户平台，可下载资金明细表用于对账

“资金管理-资金信息“，将入账类型筛选为现金红包扣款或现金红包退款

1. 现金红包扣款：每发一笔红包，会产生一次扣款记录
2. 现金红包退款：用户三日未领取，已扣款的钱会退回到商户号中

六、 商户平台上传文件发放现金红包功能 详细操作流程

1、 登录微信支付商户平台

在调用接口前有一些工作需要商户登录微信支付商户平台进行操作，请使用微信支付商户号和密码登录

2、 给商户号进行充值

发放现金红包将扣除商户的可用余额，请注意，可用余额并不是微信支付交易额，需要预先充值，确保可用余额充足。登录微信支付商户平台，进入“资金管理”菜单，可以查看可用余额、充值、或者提现

3、 创建红包模板

菜单“现金红包-创建红包”中，创建红包模板，一份openid文件对应一个红包模板

1） 第一步：选择红包类型，支持固定金额红包和随机金额

2） 第二步配置红包消息，自定义红包消息以及红包页面的文案

3） 第三步：配置红包内信息，自定义更多文案

具体各字段对应内容,请见如下图:

4、 （可选步骤）配置审核任务

1） 进入菜单“审核管理-审核配置”中，点击“现金红包发放审核”右侧的修改

2） 进入详情页添加审核步骤，审核时，当配置的所有审核步骤都通过时才算审核通过

3） 提交后，再次进入“审核管理-审核配置”的列表页，点击“现金红包发放审核”右侧的启用

5、 发放红包——上传openid文件以及审核

1) 上传文件：进入菜单“现金红包-管理红包”中，选择配置好的红包模板，点击详情，进入红包详情页，点击发放红包，上传openid文件后点击确定。

如果开启了审核，上传文件后不会立刻进行发放，等待审核通过会立刻开始发放，如果未开启审核，上传文件后立刻进行发放。

2) 校验：为了保证商户资金安全，微信支付强校验商户号与appid之间的绑定关系，以及appid与openid之间的对应关系（如果商户号与appid之间没有绑定关系，即appid没有申请微信支付或者申请微信支付商户号不匹配，或者openid归属appid错误，都会报错）

3) （若开启了审核）通过审核开始发放：审核人登录微信支付商户平台，进入菜单“审核管理-审核任务-待处理”通过审核后立刻开始发放

6、 查看发放记录以及对账

1） 查看发放失败名单列表：进入红包详情页，找到发放记录中对应文件，下载失败名单

2） 下载资金明细用于对账

“资金管理-资金信息“，将入账类型筛选为现金红包扣款或现金红包退款

1. 现金红包扣款：每发一笔红包，会产生一次扣款记录，如上传文件一份2000个openid那么会有2000条记录
2. 现金红包退款：用户三日未领取，已扣款的钱会退回到商户号中

七、 商户平台营销 详细操作流程

支付满足一定金额赠送红包，如满100赠送10元现金红包。可以登录商户平台自助配置

1、 登录微信支付商户平台

在调用接口前有一些工作需要商户登录微信支付商户平台进行操作，请使用微信支付商户号和密码登录

2、 给商户号进行充值

发放现金红包将扣除商户的可用余额，请注意，可用余额并不是微信支付交易额，需要预先充值，确保可用余额充足。登录微信支付商户平台，进入“资金管理”菜单，可以查看可用余额、充值、或者提现

3、 创建红包模板

菜单“现金红包-创建红包”中，创建红包模板

4） 第一步：选择红包类型，支持固定金额红包和随机金额

5） 第二步配置红包消息，自定义红包消息以及红包页面的文案

6） 第三步：配置红包内信息，自定义更多文案

4、 进入“营销规则-配置规则-满额送”按步骤进行配置

5、 下载资金明细用于对账

“资金管理-资金信息“，将入账类型筛选为现金红包扣款或现金红包退款

1. 现金红包扣款：每发一笔红包，会产生一次扣款记录
2. 现金红包退款：用户三日未领取，已扣款的钱会退回到商户号中

长按图片识别图中二维码(或搜索微信公众号FrontEndStory)关注“前端那些事儿”，带你了解最新的前端技术。