产品概述

API红包接口是一个可以被开发者用来调用的开放接口，聚合了微信现金红包和企业付款到零钱接口。开放接口可以帮助你实现更加定制化的开发需求，通过调用开放红包接口可以赋予小程序、H5、APP等应用发放红包的能力。

准入条件

1.无公众号授权要求，具备开发能力。

2.微信小程序接入须企业资质注册的小程序，个人资质注册的小程序因不能下载校验文件和配置webview业务域名，所以不支持接入API红包接口。

产品特性

两种发放方式

1.通过红包创建接口获取红包ticket，然后使用ticket拼装生成红包链接，用户在微信端与拼装链接交互，获取用户openid，再通过服务器传输的参数进行红包下发。

2.在交互过程中嵌入静默授权或用户手动授权获取openid，然后可以随时在服务器端调用红包直发接口下发红包。

金额设定规则

1.现金红包支持小0.3元，大499元；企业付款到零钱支持小0.3元，大1000元。

2.具体下发金额由应用端传输的参数控制。

3.现金红包与企业付款到零钱单日单用户领取次数均不超过10次。

领取规则设定

1.可限制用户大领取次数（0表示不限制）。

2.可限制用户多领取总金额（0表示不限制）。

3.可限制相同IP地址大领取次数（0表示不限制）。

4.可使用自然日计数规则限定周期内用户可领取次数。

支付触达方式配置规则

1.支持现金红包接口或企业付款到零钱接口两种支付触达方式，type=0为现金红包，type=1为企业付款到零钱。

2.使用现金红包接口发放，若用户24小时内未领取，所发放的红包将原路退回。

系统规则配置

1.可随时开启/关闭接口使用状态。

2.自定义配置签名密钥ApiKey(不超过32字节)和限定对接IP（应用端服务器IP，多个用逗号隔开）。

3.可配置是否禁止桌面端微信。

4.可配置拦截可疑来源，根据IP地址和终端访问频次，拦截疑似刷红包的可疑请求，非准确。

5.可配置是否允许中转IP，电信运营商为节省公网IP地址，经常会使用外省网络代理出口，导致用户在公网上显示的来源IP为外省，打开此开关，会提高判断用户真实IP的准确性，但存在被伪造的可能性（需要较高的技术水平，使用https可大幅提高篡改难度）。

6.可配置限定区域（根据IP地址），IP地址使用阿里云数据库，根据经验，城市误差较大，省份相对准确。

数据查询规则

1.可筛选订单状态，查询未领取、已领取、已过期、已退款、异常状态的订单。

2.可选择开始时间和结束时间精准查询数据。

3.支持数据回调查询，活动数据明细及交易数据明细可查询导出excel表格，便于企业对账审查；

用户微信端触达区别

现金红包触达形式

现金红包以服务通知中的模板消息触达用户，用户需要点击领取，红包才会到达用户的微信零钱包，活动名称（title）、商户名称（sendname）、祝福语（wishing）字段可自定义修改，模板消息中的logo和名称（品牌推广助手）默认显示商户号关联的公众号昵称和头像。

企业付款触达形式

企业付款到零钱以微信支付通知触达用户，资金直接发放到用户的微信零钱包，付款备注（wishing）可自定义，不显示活动名称（title）和商户名称（sendname），付款商家默认显示商户号对应的主体名称。

配置路径

1.摇摇啦SCRM平台–首页–扩展应用–红包接口；

如有疑问，欢迎评论区交流～