团队研发文档

开发规范、技术文档等


微信红包

<h3>微信红包</h3> <ol> <li> <p>简介</p> <pre><code>2014年春节一推出即受到广大用户好评,引发全民抢红包热潮。现将微信红包打造成“现金红包”,作为一款定向资金发放的营销工具,供商户使用。用户在客户端领取到红包之后,所得金额进入微信钱包,可用于转账、支付或提取到银行卡。</code></pre> </li> <li> <p>发放形式:</p> <pre><code>方式一:接口发放,商户根据开发文档进行开发,一次调用可以给一个指定用户发送一个指定金额的红包,满足多元化的运营需求; 方式二:通过上传openid文件发放,商户可以在商户平台配置自助规则:用户使用微信支付发生交易满足一定条件,立送现金红包; 方式三:配置营销规则“满额送”发放,商户可以在商户平台配置自助规则:用户使用微信支付发生交易满足一定条件,立送现金红包。</code></pre> </li> <li> <p>开通条件及相关设置</p> <pre><code>1.入账方式为即时入账至商户号、结算周期为T+1的商户需满足以下两个条件: 1. 入驻满90天; 2. 连续正常交易30天。 其余结算周期的商户无限制; 2.相关参数设置,和红包相关的参数,你可以在页面上自主设置和更改。操作路径如下:【登录商户平台——&gt;产品中心——&gt;现金红包——&gt;产品设置】(注:“产品设置”操作按钮仅当你开通现金红包功能之后才会出现) 说明: 1.调用IP地址:设置之后,仅有已设置的IP地址可以调用,其余的IP调用会报错; 2.用户领取上限:限制同一openid同一日领取的个数; 3.防刷等级:防刷是指微信风控针对微信小号、僵尸号、机器号等的拦截,你可以通过更改防刷等级控制防刷的强度; 4.同时,你也可以申请更改红包额度。但是需要经过微信支付的审核,审核通过之后才会生效</code></pre> <p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/3611a680ae9657a2e018ffac7f841c15?showdoc=.jpg" alt="" /></p> <p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/cfc5e50d6693509ad36a1cff8ee55dd4?showdoc=.jpg" alt="" /></p> <p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/d4249c37a5f81b187734428ebfef23f4?showdoc=.jpg" alt="" /></p> </li> <li> <p>代发红包形式:</p> <pre><code>1.由第三方生成相应的H5页面,引导用户通过H5页面中的按钮来领取红包(第三方账户资金发放): 第一步:绑定了第三方平台的公众号,第三方可以配置相关关键词默认回复,比如“新年快乐”,公众号自动回复带有第三方预先设置好的H5页面让用户点击; 第二步:用户点击后,H5页面自动触发服务通知(模板可以自定义); 第三步:用户点击消息模板再次进入第三方平台的H5页面,通过按钮来触发第三方平台下拥有支付、现金红包分发能力的公众号发红包(静默授权)。 特殊说明: 1.此完整流程中用户不用关注第三方代发平台的公众号; 2.通过静默授权的方式获取其openId即可调用发红包接口; 3.客户公众平台都不用开通微信支付和现金红包功能。 静默授权: 1.以snsapi_base为scope发起的网页授权,是用来获取进入页面的用户的openid的,并且是静默授权并自动跳转到回调页的。用户感知的就是直接进入了回调页(往往是业务页面); 2.对于已关注公众号的用户,如果用户从公众号的会话或者自定义菜单进入本公众号的网页授权页,即使是scope为snsapi_userinfo,也是静默授权,用户无感知。 3.静默授权具体流程: 1.引导用户进入授权页面同意授权,获取code; 2.通过code换取网页授权access_token(与基础支持中的access_token不同); 3.如果需要,开发者可以刷新网页授权access_token,避免过期; 4.通过网页授权access_token和openid获取用户基本信息(支持UnionID机制)。 2.通过调用企业付款的形式发放给用户(注意这里就不是以红包的形式了,第三方账户资金发放): 3.客户将自身的相关敏感信息(密钥、商户证书)给第三方,第三方直接通过调用其接口发放红包(客户的商户资金发放,企业付款相关:https://pay.weixin.qq.com/wiki/doc/api/tools/mch_pay.php?chapter=14_1)</code></pre> <pre><code>前两种方案说明: 1.不用关注第三方的公众号; 2.只是通过静默授权的方式; 3.甚至客户公众平台都不用开通微信支付和现金红包功能。</code></pre> <pre><code>最后一种解决方案说明; 客户给第三方提供相关的证书文件、密钥第三方通过调用他们的接口代为发送(客户敏感数据可能不太好拿)</code></pre> <pre><code>// 接口调用 https://api.mch.weixin.qq.com/mmpaymkttransfers/sendredpack // 请求方式:POST // 需要商户证书</code></pre> <pre><code>红包代发(针对未开通现金红包接口的公众号),用户通过微信“服务通知”领取红包,其优势在于24小时内用户未领取红包,发放的红包将会原路退回的平台账户余额,节省营销成本。</code></pre> <p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/2eb097fd55da8244ba5ce32f54d93f55?showdoc=.jpg" alt="" /></p> <p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/32111c2c0a6131d7027d4f6605a0fc9b?showdoc=.jpg" alt="" /></p> <pre><code>代发企业付款的形式,用户点击超链接“点此领取”后,所发放的钱直接进入用户微信零钱,不会有过期退款,其优势在于极大的减少了用户操作步骤,优化了用户的体验,企业付款相关:https://pay.weixin.qq.com/wiki/doc/api/tools/mch_pay.php?chapter=14_1</code></pre> <p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/fde32b2ea1cfa0b319d42e1ad78cda1f?showdoc=.jpg" alt="" /></p> <pre><code>非平台代发(针对开通现金红包接口的公众号),公众号直接推送现金红包,这种方式的体验最佳</code></pre> <p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/b6f941f82c77de1948fc87c706ef7bd7?showdoc=.jpg" alt="" /></p> <pre><code>微信支付官方公告现金红包触达规则 - 用户关注公众号未达50小时,红包以“模板消息”通知,关注超过50个小时,红包以“防伪消息”样式通知</code></pre> <p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/c2afb924fdb52b83f940ec5e25cde679?showdoc=.jpg" alt="" /></p> <p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/6f96302086fc7ad61b94e50890050500?showdoc=.jpg" alt="" /></p> <pre><code>发放规则 1.发送频率限制------默认1800/min; 2.发送个数上限------按照默认1800/min算; 3.金额限制------默认红包金额为1-200元,如有需要,可前往商户平台进行设置和申请; 4.其他其他限制吗?------单个用户可领取红包上线为10个/天,如有需要,可前往商户平台进行设置和申请; 5.如果量上满足不了第三方的需求,如何提高各个上限?------金额上限和用户当天领取次数上限可以在商户平台进行设置; 6.红包金额大于200或者小于1元时,请求参数scene_id必传,参数说明见下文; 7.根据监管要求,新申请商户号使用现金红包需要满足两个条件:1、入驻时间超过90天 2、连续正常交易30天; 8.移动应用的appid无法使用红包接口;</code></pre> <p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/837cd59467c4a15703edc6271af774f6?showdoc=.jpg" alt="" /></p> </li> <li> <p>红包分类 1.普通红包 1.口令红包; 2.关键词红包; 3.关注红包(较特殊)。 2.裂变红包</p> </li> <li> <p>裂变红包(<a href="https://pay.weixin.qq.com/wiki/doc/api/tools/cash_coupon_sl.php?chapter=13_5&index=4">https://pay.weixin.qq.com/wiki/doc/api/tools/cash_coupon_sl.php?chapter=13_5&index=4</a>)</p> <pre><code>一次可以发放一组红包。首先领取的用户为种子用户,种子用户领取一组红包当中的一 个,并可以通过社交分享将剩下的红包给其他用户。裂变红包充分利用了人际传播的优势。</code></pre> <pre><code>// 接口调用 https://api.mch.weixin.qq.com/mmpaymkttransfers/sendgroupredpack // 请求方式:POST // 需要商户证书</code></pre> <pre><code>触达规则与普通现金红包的规则一致</code></pre> <pre><code>裂变红包的接口参数</code></pre> <p><a href="http://lc-zkmoosmi.cn-n1.lcfile.com/6920a1e2b4f5bff1167c.png"><img src="http://lc-zkmoosmi.cn-n1.lcfile.com/6920a1e2b4f5bff1167c.png" alt="" /></a> <a href="http://lc-zkmoosmi.cn-n1.lcfile.com/aced6a05d3c85274fe48.png"><img src="http://lc-zkmoosmi.cn-n1.lcfile.com/aced6a05d3c85274fe48.png" alt="" /></a> <a href="http://lc-zkmoosmi.cn-n1.lcfile.com/5242a8f0ca8996943e30.png"><img src="http://lc-zkmoosmi.cn-n1.lcfile.com/5242a8f0ca8996943e30.png" alt="" /></a></p> </li> <li> <p>服务商模式发放红包</p> <pre><code>服务商模式下,若服务商需要替特约商户发红包,需要服务商开通服务商现金红包功能。操作路径:【登录微信支付商户平台——&gt;产品中心——&gt;特约商户授权产品——&gt;服务商现金红包——&gt;开通】,服务商模式下只能通过接口调用发放普通红包。 1.服务商开通“服务商现金红包”产品权限; 2.服务商发起授权邀请; 3.特约商户收到站内信; 4.特约商户线上授权。</code></pre> <p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/06788f774f5af39bcef24ecd935d8a0f?showdoc=.jpg" alt="" /> <img src="https://www.showdoc.cc/server/api/common/visitfile/sign/4e046c8b12b6baced38767648f5e5e65?showdoc=.jpg" alt="" /> <img src="https://www.showdoc.cc/server/api/common/visitfile/sign/8bcf1393f3cea7790f695892a78bb8ed?showdoc=.jpg" alt="" /> <img src="https://www.showdoc.cc/server/api/common/visitfile/sign/e027453242fea3f20d27455a1c4b2c0b?showdoc=.jpg" alt="" /></p> </li> <li>查询红包记录 <pre><code>用于商户对已发放的红包进行查询红包的具体信息,可支持普通红包和裂变包。</code></pre> <pre><code>// 接口调用 https://api.mch.weixin.qq.com/mmpaymkttransfers/gethbinfo // 请求方式:POST // 需要商户证书</code></pre> <pre><code>红包查询接口参数</code></pre> <p><a href="http://lc-zkmoosmi.cn-n1.lcfile.com/ca2b4d8ae234d594c925.png"><img src="http://lc-zkmoosmi.cn-n1.lcfile.com/ca2b4d8ae234d594c925.png" alt="" /></a></p></li> </ol>

页面列表

ITEM_HTML