C#开发微信门户及应用微信现金红包的封装及使用

C#开发微信门户及应用微信现金红包的封装及使用
​在上篇随笔后，经过对整个微信框架的完善和重构，已经完成了对微信支付、企业付款、现金红包、代金券及各种卡劵进行了封装完成，并把其中微信支付及摇一摇红包部分等内容作为公众号和企业号通用的部分，这些支付相关的接口在公众号和企业号里面，都可以进行调用的，在经过一系列的优化整理后，把这些内容逐一进行介绍，希望大家喜欢支持。

在上篇随笔后，经过对整个微信框架的完善和重构，已经完成了对微信支付、企业付款、现金红包、代金券及各种卡劵进行了封装完成，并把其中微信支付及摇一摇红包部分等内容作为公众号和企业号通用的部分，这些支付相关的接口在公众号和企业号里面，都可以进行调用的，在经过一系列的优化整理后，把这些内容逐一进行介绍，希望大家喜欢支持。

1、现金红包的概念及使用

1）使用场景

微信支付现金红包向微信支付商户开发，具体能力如下：

◆ 商户调用接口时，通过指定发送对象以及发送金额的方式发放红包，这样的方式，允许商户灵活的应用于各种各样丰富的活动场景

◆ 领取到红包后，用户的资金直接进入微信零钱，避免繁复的领奖流程，带给用户微信支付原生的流畅体验

 

2）微信红包发送规则

发送频率规则

◆ 每分钟发送红包数量不得超过1800个；

◆ 同一个商户号，每分钟最多给同一个用户发送一个红包；

红包规则

◆ 单个红包金额介于[1.00元，200.00元]之间；

◆ 同一个红包只能发送给一个用户；（如果以上规则不满足您的需求，请发邮件至wxhongbao@tencent.com获取升级指引）

◆ 红包发放后72小时未被领取将进行退款

 

3) 微信红包接口调用流程

◆ 后台API调用：待进入联调过程时与开发进行详细沟通；

◆ 告知服务器：告知服务器接收微信红包的用户openID，告知服务器该用户获得的金额；

◆ 从商务号扣款：服务器获取信息后从对应的商务号扣取对应的金额；

◆ 调用失败：因不符合发送规则，商务号余额不足等原因造成调用失败，反馈至调用方；

◆ 发送成功：以微信红包公众账号发送对应红包至对应用户；

2、 现金红包API接口的说明及C#的封装

用于企业向微信用户个人发现金红包，目前支持向指定微信用户的openid发放指定金额红包。

虽然可以通过微信的商户后台进行现金红包的发放，但我们也可以利用微信提供的接口API进行现金红包的发送。

接口调用请求说明

请求Urlhttps://api.mch.weixin.qq.com/mmpaymkttransfers/sendredpack是否需要证书是（证书及使用说明详见商户证书）请求方式POST

请求参数

字段名字段必填示例值类型说明随机字符串nonce_str是5K8264ILTKCH16CQ2502SI8ZNMTM67VSString(32)随机字符串，不长于32位签名sign是C380BEC2BFD727A4B6845133519F3AD6String(32)详见签名生成算法商户订单号mch_billno是1000009820****67890String(28)

商户订单号（每个订单号必须唯一）

组成：mch_id+yyyymmdd+10位一天内不能重复的数字。

接口根据商户订单号支持重入，如出现超时可再调用。

商户号mch_id是10000098String(32)微信支付分配的商户号公众账号appidwxappid是wx8888888888888888String(32)微信分配的公众账号ID（企业号corpid即为此appId）。接口传入的所有appid应该为公众号的appid（在mp.weixin.qq.com申请的），不能为APP的appid（在open.weixin.qq.com申请的）。商户名称send_name是天虹百货String(32)红包发送者名称用户openidre_openid是oxTWIuGaIt6gTKsQRLau2M0yL16EString(32)

接受红包的用户

用户在wxappid下的openid

付款金额total_amount是1000int付款金额，单位分红包发放总人数total_num是1int

红包发放总人数

total_num=1

红包祝福语wishing是感谢您参加猜灯谜活动，祝您元宵节快乐！String(128)红包祝福语Ip地址client_ip是192.168.0.1String(15)调用接口的机器Ip地址活动名称act_name是猜灯谜抢红包活动String(32)活动名称备注remark是猜越多得越多，快来抢！String(256)备注信息

数据示例：

<xml><xml>   <sign></sign>    <mch_billno></mch_billno>    <mch_id></mch_id>    <wxappid></wxappid>    <send_name></send_name>    <re_openid></re_openid>    <total_amount></total_amount>    <total_num></total_num>    <wishing></wishing>    <client_ip></client_ip>    <act_name></act_name>    <remark></remark>    <nonce_str></nonce_str>   </xml></xml>