微信公众平台开发之现金红包（Java）

目录(?)

本文介绍的是基于Java语言开发微信现金红包的例子。由于个人表达能力和编程能力有限，请多多包涵。本文仅介绍拥有微信支付权限的微信公众号开发。

本文分为以下两部分：

1.开发现金红包SDK

2.构造现金红包并发送

首先看一下现金红包接口文档：http://pay.weixin.qq.com/wiki/doc/api/cash_coupon.php?chapter=13_1

首页

现金红包

功能介绍

春节期间，微信红包以其独特的魅力，优秀的用户体验和安全的支付环境，一经推出即受到了广大用户的热烈欢迎，现微信支付现金红包向微信支付商户开发，具体能力如下：

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

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

微信红包发送规则

发送频率规则

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

　◆　北京时间0：00-8：00不触发红包赠送；（如果以上规则不满足您的需求，请发邮件至wxhongbao@tencent.com获取升级指引）

红包规则

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

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

商户侧调用红包接口流程

登录微信支付商户平台下载证书以及充值

在调用接口前，请商户使用微信支付商户号登录微信支付商户平台完成下述工作：

备注：

微信支付商户平台地址为pay.weixin.qq.com。微信支付商户号会在商户申请微信支付成功后，通过开户邮件发送给您。请不要使用微信公众平台账号或者appid登录。如果您登录时遇到问题，请联系微信支付小助手weixinpay@tencent.com

　◆　下载证书

商户调用微信红包接口时，服务器会进行证书验证，请在商户平台下载证书

　◆　充值

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

微信红包接口调用流程

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

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

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

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

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

用户交互流程

调用现金红包接口，发放成功后，用户领取红包流程如下：

步骤（一）：收到领取红包消息，根据用户微信版本不同，分为：

微信版本在6.1及以上的用户收到企业自身微信号（调用接口时传入appid对应的商户号）下发领取消息；如果用户未关注微信号，那么会收到由"服务通知"下发的消息

微信版本在6.1以下的用户仍按原流程收取消息：由微信红包公众号下发领取消息

步骤（二）：点击领取消息，拆红包

接口列表

|——|——|———————————————————————————————————————————–|
| 业务 | 接口 | 简介 |
| 现金红包 | 发放红包 | 用于企业向微信用户个人发现金红包目前支持向指定微信用户的openid发放指定金额红包。（获取openid参见微信公众平台开发者文档: 网页授权获取用户基本信息） |

接口详细说明

1.红包发放说明

用于企业向微信用户个人发现金红包

目前支持向指定微信用户的openid发放指定金额红包。（获取openid参见微信公众平台开发者文档: 网页授权获取用户基本信息）

接口参数与用户领用实际效果对应关系如下：

如需操作请登录https://pay.weixin.qq.com/

2.接口调用请求说明

3.请求参数

数据示例：

|——————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————————|
| |

4.返回参数

| 字段名 | 变量名 | 必填 | 示例值 | 类型 | 说明 |
|———–|————–|—-|———————————-|————-|————————————————————————————-|
| 返回状态码 | return_code | 是 | SUCCESS | String(16) | SUCCESS/FAIL 此字段是通信标识，非交易标识，交易是否成功需要查看result_code来判断 |
| 返回信息 | return_msg | 否 | 签名失败 | String(128) | 返回信息，如非空，为错误原因签名失败参数格式校验错误 |
| 以下字段在return_code为SUCCESS的时候有返回 ||||||
| 签名 | sign | 是 | C380BEC2BFD727A4B6845133519F3AD6 | String(32) | 生成签名方式详见签名生成算法 |
| 业务结果 | result_code | 是 | SUCCESS | String(16) | SUCCESS/FAIL |
| 错误代码 | err_code | 否 | SYSTEMERROR | String(32) | 错误码信息 |
| 错误代码描述 | err_code_des | 否 | 系统错误 | String(128) | 结果信息描述 |
| 以下字段在return_code 和result_code都为SUCCESS的时候有返回 ||||||
| 商户订单号 | mch_billno | 是 | 10000098201411111234567890 | String(28) | 商户订单号（每个订单号必须唯一）组成： mch_id+yyyymmdd+10位一天内不能重复的数字 |
| 商户号 | mch_id | 是 | 10000098 | String(32) | 微信支付分配的商户号 |
| 公众账号appid | wxappid | 是 | wx8888888888888888 | String(32) | 商户appid |
| 用户openid | re_openid | 是 | oxTWIuGaIt6gTKsQRLau2M0yL16E | String(32) | 接受收红包的用户用户在wxappid下的openid |
| 付款金额 | total_amount | 是 | 1000 | int | 付款金额，单位分 |
| 发放成功时间 | | | | | |
| 微信单号 | | | | | |

成功示例：

失败示例：

5.错误码

现金红包API文档：https://pay.weixin.qq.com/helper/cashredopenapi_V2.pdf这个里面是非常详细的，一定要仔细看哦。

一、开发现金红包SDK

1.创建一个红包，本文介绍的是创建一个固定金额的红包。

2.接口调用说明

证书是必须的，上面的现金红包接口文档里面有介绍。

点击这个链接：http://pay.weixin.qq.com/wiki/doc/api/cash_coupon.php?chapter=13_3

这一节有介绍的。

3.请求参数。注意看下，有的参数是必填的。

二、构造现金红包并发送

构造现金红包实体类

public class SendRedPackPo {

private String nonce_str;
private String sign;
private String mch_billno;
private String mch_id;
private String sub_mch_id;
private String wxappid;
private String nick_name;
private String send_name;
private String re_openid;
private String total_amount;
private String min_value;
private String max_value;
private String total_num;
private String wishing;
private String client_ip;
private String act_name;
private String remark;
private String logo_imgurl;
private String share_content;
private String share_url;
private String share_imgurl;

public String getNonce_str() {

return nonce_str;
}
public void setNonce_str(String nonceStr) {

nonce_str = nonceStr;
}
public String getSign() {

return sign;
}
public void setSign(String sign) {

this.sign = sign;
}
public String getMch_billno() {

return mch_billno;
}
public void setMch_billno(String mchBillno) {

mch_billno = mchBillno;
}
public String getMch_id() {

return mch_id;
}
public void setMch_id(String mchId) {

mch_id = mchId;
}
public String getSub_mch_id() {

return sub_mch_id;
}
public void setSub_mch_id(String subMchId) {

sub_mch_id = subMchId;
}
public String getWxappid() {

return wxappid;
}
public void setWxappid(String wxappid) {

this.wxappid = wxappid;
}
public String getNick_name() {

return nick_name;
}
public void setNick_name(String nickName) {

nick_name = nickName;
}
public String getSend_name() {

return send_name;
}
public void setSend_name(String sendName) {

send_name = sendName;
}
public String getRe_openid() {

return re_openid;
}
public void setRe_openid(String reOpenid) {

re_openid = reOpenid;
}
public String getTotal_amount() {

return total_amount;
}
public void setTotal_amount(String totalAmount) {

total_amount = totalAmount;
}
public String getMin_value() {

return min_value;
}
public void setMin_value(String minValue) {

min_value = minValue;
}
public String getMax_value() {

return max_value;
}
public void setMax_value(String maxValue) {

max_value = maxValue;
}
public String getTotal_num() {

return total_num;
}
public void setTotal_num(String totalNum) {

total_num = totalNum;
}
public String getWishing() {

return wishing;
}
public void setWishing(String wishing) {

this.wishing = wishing;
}
public String getClient_ip() {

return client_ip;
}
public void setClient_ip(String clientIp) {

client_ip = clientIp;
}
public String getAct_name() {

return act_name;
}
public void setAct_name(String actName) {

act_name = actName;
}
public String getRemark() {

return remark;
}
public void setRemark(String remark) {

this.remark = remark;
}
public String getLogo_imgurl() {

return logo_imgurl;
}
public void setLogo_imgurl(String logoImgurl) {

logo_imgurl = logoImgurl;
}
public String getShare_content() {

return share_content;
}
public void setShare_content(String shareContent) {

share_content = shareContent;
}
public String getShare_url() {

return share_url;
}
public void setShare_url(String shareUrl) {

share_url = shareUrl;
}
public String getShare_imgurl() {

return share_imgurl;
}
public void setShare_imgurl(String shareImgurl) {

share_imgurl = shareImgurl;
}

}

/**
* 生成32位字符串
* */
public class UUIDHexGenerator {

private String sep = ““;

private static final int IP;

private static short counter = (short) 0;

private static final int JVM = (int) (System.currentTimeMillis() >>> 8);

private static UUIDHexGenerator uuidgen = new UUIDHexGenerator();

static {

int ipadd;
try {

ipadd = toInt(InetAddress.getLocalHost().getAddress());
} catch (Exception e) {

ipadd = 0;
}
IP = ipadd;
}

public static UUIDHexGenerator getInstance() {

return uuidgen;
}

public static int toInt(byte[] bytes) {

int result = 0;
for (int i = 0; i < 4; i++) {

result = (result << 8) - Byte.MIN_VALUE + (int) bytes[i];
}
return result;
}

protected String format(int intval) {

String formatted = Integer.toHexString(intval);
StringBuffer buf = new StringBuffer(“00000000”);
buf.replace(8 - formatted.length(), 8, formatted);
return buf.toString();
}

protected String format(short shortval) {

String formatted = Integer.toHexString(shortval);
StringBuffer buf = new StringBuffer(“0000”);
buf.replace(4 - formatted.length(), 4, formatted);
return buf.toString();
}

protected int getJVM() {

return JVM;
}

protected synchronized short getCount() {

if (counter < 0) {

counter = 0;
}
return counter++;
}

protected int getIP() {

return IP;
}

protected short getHiTime() {

return (short) (System.currentTimeMillis() >>> 32);
}

protected int getLoTime() {

return (int) System.currentTimeMillis();
}

public String generate() {

return new StringBuffer(36)
.append(format(getIP()))
.append(sep)
.append(format(getJVM()))
.append(sep)
.append(format(getHiTime()))
.append(sep)
.append(format(getLoTime()))
.append(sep)
.append(format(getCount()))
.toString();
}

/**
* @param args
*/
public static void main(String[] args) {

String id;
UUIDHexGenerator uuid = UUIDHexGenerator.getInstance();

for(int i = 0;i<100;i++)
{

id = uuid.generate();

}

}
}

/**
* 功能：MD5签名处理核心文件，不需要修改
* 说明：
* 以下代码只是为了方便商户测试而提供的样例代码，商户可以根据自己网站的需要，按照技术文档编写,并非一定要使用该代码。
* */
public class MD5 {

/**
* 签名字符串
* @param text 需要签名的字符串
* @param key 密钥
* @param input_charset 编码格式
* @return 签名结果
*/
public static String sign(String text, String key, String input_charset) {

text = text + key;
return DigestUtils.md5Hex(getContentBytes(text, input_charset));
}

/**
* 签名字符串
* @param text 需要签名的字符串
* @param sign 签名结果
* @param key 密钥
* @param input_charset 编码格式
* @return 签名结果
*/
public static boolean verify(String text, String sign, String key, String input_charset) {

text = text + key;
String mysign = DigestUtils.md5Hex(getContentBytes(text, input_charset));
if(mysign.equals(sign)) {

return true;
}
else {

return false;
}
}

/**
* @param content
* @param charset
* @return
* @throws SignatureException
* @throws UnsupportedEncodingException
*/
private static byte[] getContentBytes(String content, String charset) {

if (charset == null \|\| ““.equals(charset)) {

return content.getBytes();
}
try {

return content.getBytes(charset);
} catch (UnsupportedEncodingException e) {

throw new RuntimeException(“MD5签名过程中出现错误,指定的编码集不对,您目前指定的编码集是:” + charset);
}
}

}

/**
* 生成6位或10位随机数
* param codeLength(多少位)
* @return
*/

private String createCode(int codeLength) {

String code=““;
for(int i=0; i

code += (int)(Math.random() * 9);
}
return code;
}
private static boolean isValidChar(char ch) {
if ((ch >= '0' \&\& ch <= '9') \|\| (ch >= 'A' \&\& ch <= 'Z')\|\| (ch >= 'a' \&\& ch <= 'z'))
return true;
if ((ch >= 0x4e00 \&\& ch <= 0x7fff) \|\| (ch >= 0x8000 \&\& ch <= 0x952f))
return true;// 简体中文汉字编码
return false;
}

/**
* 除去数组中的空值和签名参数
* @param sArray 签名参数组
* @return 去掉空值与签名参数后的新签名参数组
*/
public static Map paraFilter(Map sArray) {

Map result = new HashMap();

if (sArray == null \|\| sArray.size() <= 0) {

return result;
}

for (String key : sArray.keySet()) {

String value = sArray.get(key);
if (value == null \|\| value.equals(““) \|\| key.equalsIgnoreCase(“sign”)
\|\| key.equalsIgnoreCase(“sign_type”)) {

continue;
}
result.put(key, value);
}

return result;
}

/**
* 把数组所有元素排序，并按照"参数=参数值"的模式用”\&“字符拼接成字符串
* @param params 需要排序并参与字符拼接的参数组
* @return 拼接后字符串
*/
public static String createLinkString(Map params) {

List keys = new ArrayList(params.keySet());
Collections.sort(keys);

String prestr = ““;

for (int i = 0; i < keys.size(); i++) {

String key = keys.get(i);
String value = params.get(key);

if (i == keys.size() - 1) {//拼接时，不包括最后一个\&字符
prestr = prestr + key + “=” + value;
} else {

prestr = prestr + key + “=” + value + “\&“;
}
}

return prestr;
}

/**
* 发送现金红包
* @throws KeyStoreException
* @throws IOException
* @throws CertificateException
* @throws NoSuchAlgorithmException
* @throws UnrecoverableKeyException
* @throws KeyManagementException
* @throws DocumentException
*/
public void sendRedPack() throws KeyStoreException, NoSuchAlgorithmException, CertificateException, IOException, KeyManagementException, UnrecoverableKeyException, DocumentException {

// 获取uuid作为随机字符串
String nonceStr = uuidGenerator.generate();
String today = new SimpleDateFormat(“yyyyMMdd”).format(new Date());
String code = createCode(10);
String mch_id = “10000100”;//商户号
String appid = “wxd930ea5d5a258f4f”;
String opendid = “xxxxxxxxxxxxxxxxx”; //发送给指定微信用户的openid
SendRedPackPo sendRedPackPo = new SendRedPackPo();
String totalAmount = “1”;

sendRedPackPo.setNonce_str(nonceStr);
sendRedPackPo.setMch_billno(mch_id + today + code);
sendRedPackPo.setMch_id(mch_id);
sendRedPackPo.setWxappid(appid);
sendRedPackPo.setNick_name(“xxx”);
sendRedPackPo.setSend_name(“xxx”);
sendRedPackPo.setRe_openid(opendid);
sendRedPackPo.setTotal_amount(totalAmount);
sendRedPackPo.setMin_value(totalAmount);
sendRedPackPo.setMax_value(totalAmount);
sendRedPackPo.setTotal_num(“1”);
sendRedPackPo.setWishing(“祝您新年快乐！“);
sendRedPackPo.setClient_ip(“192.168.1.1”); //IP
sendRedPackPo.setAct_name(“小游戏”);
sendRedPackPo.setRemark(“快来抢红包！“);

//把请求参数打包成数组
Map sParaTemp = new HashMap();
sParaTemp.put(“nonce_str”, sendRedPackPo.getNonce_str());
sParaTemp.put(“mch_billno”, sendRedPackPo.getMch_billno());
sParaTemp.put(“mch_id”, sendRedPackPo.getMch_id());
sParaTemp.put(“wxappid”, sendRedPackPo.getWxappid());
sParaTemp.put(“nick_name”, sendRedPackPo.getNick_name());
sParaTemp.put(“send_name”, sendRedPackPo.getSend_name());
sParaTemp.put(“re_openid”, sendRedPackPo.getRe_openid());
sParaTemp.put(“total_amount”, sendRedPackPo.getTotal_amount());
sParaTemp.put(“min_value”, sendRedPackPo.getMin_value());
sParaTemp.put(“max_value”, sendRedPackPo.getMax_value());
sParaTemp.put(“total_num”, sendRedPackPo.getTotal_num());
sParaTemp.put(“wishing”, sendRedPackPo.getWishing());
sParaTemp.put(“client_ip”, sendRedPackPo.getClient_ip());
sParaTemp.put(“act_name”, sendRedPackPo.getAct_name());
sParaTemp.put(“remark”, sendRedPackPo.getRemark());

//除去数组中的空值和签名参数
Map sPara = paraFilter(sParaTemp);
String prestr = createLinkString(sPara); //把数组所有元素，按照"参数=参数值"的模式用”\&“字符拼接成字符串
String key = “\&key=192006250b4c09247ec02edce69f6a2d”; //商户支付密钥
String mysign = MD5.sign(prestr, key, “utf-8”).toUpperCase();

sendRedPackPo.setSign(mysign);

String respXml = MessageUtil.messageToXml(sendRedPackPo);

//打印respXml发现，得到的xml中有”_“不对，应该替换成””
respXml = respXml.replace(“_“, ““);

// 将解析结果存储在HashMap中
Map map = new HashMap();

KeyStore keyStore = KeyStore.getInstance(“PKCS12”);
FileInputStream instream = new FileInputStream(new File(“/home/apiclient_cert.p12”)); //此处为证书所放的绝对路径

try {

keyStore.load(instream, mch_id.toCharArray());
} finally {

instream.close();
}

// Trust own CA and all self-signed certs
SSLContext sslcontext = SSLContexts.custom()
.loadKeyMaterial(keyStore, mch_id.toCharArray())
.build();
// Allow TLSv1 protocol only
SSLConnectionSocketFactory sslsf = new SSLConnectionSocketFactory(
sslcontext,
new String[] { “TLSv1” },
null,
SSLConnectionSocketFactory.BROWSER_COMPATIBLE_HOSTNAME_VERIFIER);
CloseableHttpClient httpclient = HttpClients.custom()
.setSSLSocketFactory(sslsf)
.build();

try {

HttpPost httpPost = new HttpPost(“https://api.mch.weixin.qq.com/mmpaymkttransfers/sendredpack”);

StringEntity reqEntity = new StringEntity(respXml, “utf-8”);

// 设置类型
reqEntity.setContentType(“application/x-www-form-urlencoded”);

httpPost.setEntity(reqEntity);

System.out.println(“executing request” + httpPost.getRequestLine());

CloseableHttpResponse response = httpclient.execute(httpPost);
try {

HttpEntity entity = response.getEntity();
System.out.println(response.getStatusLine());
if (entity != null) {

// 从request中取得输入流
InputStream inputStream = entity.getContent();
// 读取输入流
SAXReader reader = new SAXReader();
Document document = reader.read(inputStream);
// 得到xml根元素
Element root = document.getRootElement();
// 得到根元素的所有子节点
List elementList = root.elements();

// 遍历所有子节点
for (Element e : elementList)
map.put(e.getName(), e.getText());

// 释放资源
inputStream.close();
inputStream = null;

}
EntityUtils.consume(entity);
} finally {

response.close();
}
} finally {

httpclient.close();
}

// 返回状态码
String return_code = map.get(“return_code”);
// 返回信息
String return_msg = map.get(“return_msg”);
// 业务结果
String result_code = map.get(“result_code”);
// 错误代码
String err_code = map.get(“err_code”);
// 错误代码描述
String err_code_des = map.get(“err_code_des”);

/**
* 根据以上返回码进行业务逻辑处理
*/
.
.
.

}

MessageUtil工具类，在柳峰老师的博客里有的。

代码中httpclient-4.3.4.jar没有放上去，麻烦小伙伴们自己找下吧。

实现效果：

如果小伙伴们觉得有什么问题，可以联系讨论。

转载请标明出处。

原文链接: https://onlyou.blog.csdn.net//article/details/80938581

微信公众平台开发之现金红包（Java）

功能介绍

微信红包发送规则

商户侧调用红包接口流程

用户交互流程

接口详细说明

一、开发现金红包SDK

二、构造现金红包并发送

Spring 实现 3 种异步接口 2024-10-18 09:07

重学SpringBoot3-集成Redis（五）之布隆过滤器 2024-10-08 11:24

SpringBoot整合异步任务执行 2024-10-08 11:24

springboot kafka多数据源，通过配置动态加载发送者和消费者 2024-10-08 11:24

SpringBoot 集成 Redis 2024-10-08 11:24

SpringBoot整合QQ邮箱 2024-10-08 11:24

目录