前言
今天闲来无事,分享下微信小程序的支付接口的调用实现
由于之前做的是小程序在这里是说小程序的支付(PS:其他的也都差不多)
首先先认真阅读几遍官方文档
https://pay.weixin.qq.com/wiki/doc/api/wxa/wxa_api.php?chapter=7_3&index=1
关于小程序开通微信支付,,获取微信支付能力 文档都有的,在这里只说后台相关的问题;
注:关于小程序端必须用到https协议至于怎么转换可以去看我之前的文档
https://blog.csdn.net/CodeWu/article/details/91492024
1.通过code获取openId调用后台生成订单后调用支付统一下单后返回预付单信息
2.将预支付信息的数组进行签名加密返回支付参数
3.用户确定支付
4.同步调用(微信的) 鉴权调起支付 返回支付结果 并展现给用户
5.异步调用(后台) 返还支付结果 对订单进行状态的修改**
关于支付无非是这几个重要的参数
body 商品名称
spbill_create_ip 用户ip地址
out_trade_no 订单号
total_fee 总金额 需要转成字符串类型,否则后面的签名会失败
openId 用户openid
/**
* 微信支付
* @param body 商品名称
* @param spbill_create_ip 用户ip地址
* @param nexId 订单号
* @param multiply 总金额
* @param openId 用户openid
* @return
*/
public ResultMsg wxPays(String body, String spbill_create_ip, Long nexId, BigDecimal multiply, String openId) {
try {
//金额(微信端按照_分_来进行运算,金额传入之前*100)
BigDecimal multiply1 = multiply.multiply(new BigDecimal("100"));
String multiply2 = multiply1 + "";
String[] split = multiply2.split("\\.");
//生成的随机字符串
String nonce_str = getRandomStringByLength(32);
//商品名称
//组装参数,用户生成统一下单接口的签名
Map<String, String> packageParams = new HashMap<>();
packageParams.put("appid", WechatConfig.appid);//小程序app_id
packageParams.put("mch_id", WechatConfig.mch_id);//商户号id
packageParams.put("nonce_str", nonce_str);//随机字符串
packageParams.put("body", body);//商品名称
packageParams.put("out_trade_no", nexId + "");//商户订单号,自己的订单ID
packageParams.put("total_fee", split[0]);//支付金额,这边需要转成字符串类型,否则后面的签名会失败
packageParams.put("spbill_create_ip", spbill_create_ip);//用户ip地址
packageParams.put("notify_url", WechatConfig.notify_url);//支付成功后的回调地址
packageParams.put("trade_type", WechatConfig.TRADETYPE);//支付方式
packageParams.put("openid", openId + "");//用户的openID,自己获取
String prestr = PayUtil.createLinkString(packageParams); // 把数组所有元素,按照“参数=参数值”的模式用“&”字符拼接成字符串
//MD5运算生成签名,这里是第一次签名,用于调用统一下单接口
String mysign = PayUtil.sign(prestr, WechatConfig.key, "utf-8").toUpperCase();
//拼接统一下单接口使用的xml数据,要将上一步生成的签名一起拼接进去
String xml = "<xml>" + "<appid>" + WechatConfig.appid + "</appid>"
+ "<body><![CDATA[" + body + "]]></body>"
+ "<mch_id>" + WechatConfig.mch_id + "</mch_id>"
+ "<nonce_str>" + nonce_str + "</nonce_str>"
+ "<notify_url>" + WechatConfig.notify_url + "</notify_url>"
+ "<openid>" + openId + "</openid>"
+ "<out_trade_no>" + nexId + "</out_trade_no>"
+ "<spbill_create_ip>" + spbill_create_ip + "</spbill_create_ip>"
+ "<total_fee>" + split[0] + "</total_fee>"//支付的金额,单位:分
+ "<trade_type>" + WechatConfig.TRADETYPE + "</trade_type>"
+ "<sign>" + mysign + "</sign>"
+ "</xml>";
//调用统一下单接口,并接受返回的结果
String result = PayUtil.httpRequest(WechatConfig.pay_url, "POST", xml);
// 将解析结果存储在HashMap中
Map map = PayUtil.doXMLParse(result);
String return_code = (String) map.get("return_code");//返回状态码
String result_code = (String) map.get("result_code");//返回状态码
Map<String, Object> response = new HashMap<String, Object>();//返回给小程序端需要的参数
if (return_code.equals("SUCCESS") && return_code.equals(result_code)) {
String prepay_id = (String) map.get("prepay_id");//返回的预付单信息
response.put("nonceStr", nonce_str);
response.put("package", "prepay_id=" + prepay_id);
Long timeStamp = System.currentTimeMillis() / 1000;
response.put("timeStamp", timeStamp + "");//这边要将返回的时间戳转化成字符串,不然小程序端调用wx.requestPayment方法会报签名错误
//拼接签名需要的参数
String stringSignTemp = "appId=" + WechatConfig.appid + "&nonceStr=" + nonce_str + "&package=prepay_id=" + prepay_id + "&signType=MD5&timeStamp=" + timeStamp;
//再次签名,这个签名用于小程序端调用wx.requesetPayment方法
String paySign = PayUtil.sign(stringSignTemp, WechatConfig.key, "utf-8").toUpperCase();
response.put("paySign", paySign);
}
response.put("appid", WechatConfig.appid);
System.out.println(response);
return ResultMsg.successResult(response);
} catch (Exception e) {
e.printStackTrace();
}
return null;
}
//获取随机字符串
private String getRandomStringByLength(int length) {
String base = "abcdefghijklmnopqrstuvwxyz0123456789";
Random random = new Random();
StringBuffer sb = new StringBuffer();
for (int i = 0; i < length; i++) {
int number = random.nextInt(base.length());
sb.append(base.charAt(number));
}
return sb.toString();
}
将结果返还给前端 ,前端通过结果调用支付进入微信支付
支付成功或失败,微信都会调用之前预留的支付回调地址
//这里是支付回调接口,微信支付成功后会自动调用
@RequestMapping(value = "/wxNotify", method = RequestMethod.POST)
@ResponseBody
public void wxNotify(HttpServletRequest request, HttpServletResponse response) throws Exception {
String line = null;
String xmlString = null;
BufferedReader reader = request.getReader();
StringBuffer stringBuffer = new StringBuffer();
while ((line = reader.readLine()) != null) {
stringBuffer.append(line);
}
xmlString = stringBuffer.toString();
request.getReader().close();
System.out.println("微信回调的数据" + xmlString);
String resXml = "";
Map map = PayUtil.doXMLParse(xmlString);
String returnCode = (String) map.get("return_code");
if ("SUCCESS".equals(returnCode)) {
//验证签名是否正确
Map<String, String> validParams = PayUtil.paraFilter(map); //回调验签时需要去除sign和空值参数
String prestr = PayUtil.createLinkString(validParams);
//根据微信官网的介绍,此处不仅对回调的参数进行验签,还需要对返回的金额与系统订单的金额进行比对等
if (PayUtil.verify(prestr, (String) map.get("sign"), WechatConfig.key, "utf-8")) {
/**此处添加自己的业务逻辑代码start**/
/**此处添加自己的业务逻辑代码end**/
//通知微信服务器已经支付成功
resXml = "<xml>" + "<return_code><![CDATA[SUCCESS]]></return_code>"
+ "<return_msg><![CDATA[OK]]></return_msg>" + "</xml> ";
}
} else {
resXml = "<xml>" + "<return_code><![CDATA[FAIL]]></return_code>"
+ "<return_msg><![CDATA[报文为空]]></return_msg>" + "</xml> ";
}
BufferedOutputStream out = new BufferedOutputStream(
response.getOutputStream());
out.write(resXml.getBytes());
out.flush();
out.close();
}
再附上获取ip地址的方法
//获取IP
public static String getIpAddr(HttpServletRequest request) {
String ip = request.getHeader("X-Forwarded-For");
if (StringUtils.isNotEmpty(ip) && !"unKnown".equalsIgnoreCase(ip)) {
//多次反向代理后会有多个ip值,第一个ip才是真实ip
int index = ip.indexOf(",");
if (index != -1) {
return ip.substring(0, index);
} else {
return ip;
}
}
ip = request.getHeader("X-Real-IP");
if (StringUtils.isNotEmpty(ip) && !"unKnown".equalsIgnoreCase(ip)) {
return ip;
}
return request.getRemoteAddr();
}
成功会返还 CDATA[SUCCESS] 失败 则 [CDATA[报文为空]] 并且微信会继续回调 这个接口 并将回调8次 每次时间间隔都会增加
下面贴上 支付的工具类
import org.apache.commons.codec.digest.DigestUtils;
import org.jdom2.Document;
import org.jdom2.Element;
import org.jdom2.input.SAXBuilder;
import java.io.*;
import java.net.HttpURLConnection;
import java.net.URL;
import java.util.*;
public class PayUtil {
/**
* 签名字符串
*
* @param text 需要签名的字符串
* @param key 密钥
* @param input_charset 编码格式
* @return 签名结果
*/
public static String sign(String text, String key, String input_charset) {
text = text + "&key=" + 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) {
System.out.println(text);
text = text + "&key=" + key;
System.out.println(text);
byte[] contentBytes = getContentBytes(text, input_charset);
String mysign = DigestUtils.md5Hex(contentBytes);
String s = mysign.toUpperCase();
System.out.println("原" + sign);
System.out.println("新" + s);
if (s.equals(sign)) {
return true;
} else {
return false;
}
}
/**
* @param content
* @param charset
* @return
* @throws java.security.SignatureException
* @throws UnsupportedEncodingException
*/
public 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);
}
}
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<String, String> paraFilter(Map<String, String> sArray) {
Map<String, String> result = new HashMap<String, String>();
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<String, String> params) {
List<String> 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;
}
/**
* @param requestUrl 请求地址
* @param requestMethod 请求方法
* @param outputStr 参数
*/
public static String httpRequest(String requestUrl, String requestMethod, String outputStr) {
// 创建SSLContext
StringBuffer buffer = null;
try {
URL url = new URL(requestUrl);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod(requestMethod);
conn.setDoOutput(true);
conn.setDoInput(true);
conn.connect();
//往服务器端写内容
if (null != outputStr) {
OutputStream os = conn.getOutputStream();
os.write(outputStr.getBytes("utf-8"));
os.close();
}
// 读取服务器端返回的内容
InputStream is = conn.getInputStream();
InputStreamReader isr = new InputStreamReader(is, "utf-8");
BufferedReader br = new BufferedReader(isr);
buffer = new StringBuffer();
String line = null;
while ((line = br.readLine()) != null) {
buffer.append(line);
}
br.close();
} catch (Exception e) {
e.printStackTrace();
}
return buffer.toString();
}
public static String urlEncodeUTF8(String source) {
String result = source;
try {
result = java.net.URLEncoder.encode(source, "UTF-8");
} catch (UnsupportedEncodingException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
return result;
}
/**
* 解析xml,返回第一级元素键值对。如果第一级元素有子节点,则此节点的值是子节点的xml数据。
*
* @param strxml
* @return
* @throws org.jdom2.JDOMException
* @throws IOException
*/
public static Map doXMLParse(String strxml) throws Exception {
if (null == strxml || "".equals(strxml)) {
return null;
}
Map m = new HashMap();
InputStream in = String2Inputstream(strxml);
SAXBuilder builder = new SAXBuilder();
Document doc = builder.build(in);
System.out.println(doc);
Element root = doc.getRootElement();
System.out.println(root);
List list = root.getChildren();
Iterator it = list.iterator();
while (it.hasNext()) {
Element e = (Element) it.next();
String k = e.getName();
String v = "";
List children = e.getChildren();
if (children.isEmpty()) {
v = e.getTextNormalize();
} else {
v = getChildrenText(children);
}
m.put(k, v);
}
//关闭流
in.close();
return m;
}
/**
* 获取子结点的xml
*
* @param children
* @return String
*/
public static String getChildrenText(List children) {
StringBuffer sb = new StringBuffer();
if (!children.isEmpty()) {
Iterator it = children.iterator();
while (it.hasNext()) {
Element e = (Element) it.next();
String name = e.getName();
String value = e.getTextNormalize();
List list = e.getChildren();
sb.append("<" + name + ">");
if (!list.isEmpty()) {
sb.append(getChildrenText(list));
}
sb.append(value);
sb.append("</" + name + ">");
}
}
return sb.toString();
}
public static InputStream String2Inputstream(String str) {
return new ByteArrayInputStream(str.getBytes());
}
}
到这里支付完成
总结
其实在第一次做支付的时候都是懵逼的,建议多看几遍官方文档,当时我做的时候疯狂在网上找教程,代码,最后慢慢的集成了.总体来说在支付这方面遇到的bug并不多,有一个是关于金额的问题,微信是以分的单位进行运算的,而我们传入金额是以 元 的单位进行传参,所以在调用支付的时候将金额*100就可以了,前面的代码我已经做过处理了.
总体来说还是多看文档