首先,你得先有微信开发平台账号密码还需要开通应用,然后还有微信服务商平台商户版账号(这些我都是给产品经理拿的)
其次我认为你先去看一看微信开发平台的文档! https://pay.weixin.qq.com/wiki/doc/api/index.html
这里有很多种支付,我就采用APP支付来说了(会了APP支付其实H5支付都差不多的!)
进来后是这样的,随便看看'APP支付那几篇文章'讲的流程!,看完后知道大概了就可以看看'API列表了'
我们后台开发需要关注的就是这三个API了!
那我还是简单介绍一下APP支付的一个业务流程吧(其实文档里简述的了,我就直接贴图了!)
这些圈圈起来的流程步骤,就是我们后台要做的了,其他的都是由移动端来实现的,我们可以不理会,还有步骤6查询订单支付结果,这个可做可不做吧,为了系统更安全些更慎重些也可以去实现,不过我就没有实现了
下面就说一下如何对接这个所谓的第三方接口,其实就是跟前端来调用我们后端接口是一样的,我们在写接口文档时,有请求地址,请求参数,返回数据以及返回数据格式这4样!
只要提供这4种东西,前端就可以来对接我们后台接口啦!所以,同个道理的,这次是由我们后台人员去请求微信提供的接口!
所以文档上都有提供的了,我们只需要用httpclient来想微信接口那边发送同步请求获取返回结果数据即可,这样听起来貌似很简单!不过还真不是很简单,很多坑的,毕竟是腾讯的文档!
然后要注意的首先是请求参数,请求参数是否必填这个如果是否的话我就建议不用填上去了,然后签名参数也要去看文档,如何生成签名,还有,参数是要以xml格式形式发送过去,
而且返回结果也是以xml返回回来,所以和微信对接的交互就是xml,这点有点蛋疼呀!
好了,上面说了该怎么去请求第三方接口,想必大家有点懵吧,不知道该如何下手,其实上面的那个请求方式有点难度,小白可以忽略上面那套方式,直接使用微信支付的一个开源jar!
对 你没看错,就这一个,这个jar包里面已经封装好了我们如何获取签名,如何验签等api方法,而且还不需要我们去将参数转化成xml格式,它已经封装好了一切了,所以非常方便!
这个jar包可以在这个地址去下载http://www.mvnjar.com/com.github.liyiorg/weixin-popular/2.8.14/detail.html
好了,那上面的介绍看完还有微信jar拿到手后,现在就可以开始来实现了! 我就直接亮代码了!
1 /**
2 * @description:微信支付JAVA-SDK: APP支付,退款
3 * @author:小黑
4 */
5 @Service
6 public class WechatPayService {
7 private static final Logger LOGGER = LoggerFactory.getLogger(WechatPayService.class);
8
9 /************ 微信开放平台配置 ***************/
10
11 /** APPID */
12 private static final String APPID = "";
13
14 /** 商户号 */
15 private static final String MCH_ID = "";
16
17 /** 密钥 */
18 private static final String PRIVATE_KEY = "";
19
20 /** 用户订单支付结果异步通知url */
21 private static final String NOTIFY_URL = "";
22
23 /** 商户支付证书路径 */
24 private static final String API_CLIENT_CERT_PATH = "";
25
26 // 加载商户支付证书文件;
27 static {
28 LocalHttpClient.initMchKeyStore(MCH_ID, API_CLIENT_CERT_PATH);
29 }
30
31 /**
32 * @description:使用微信支付-APP支付方式-统一下单;
33 * @return 支付参数,如果支付失败则返回null
34 * @author:Fanhaojian
35 */
36 public MchPayApp orderAppPay(PayLog payLog) {
37
38 Unifiedorder unifiedorder = new Unifiedorder();
39
40 /** APPID */
41 unifiedorder.setAppid(APPID);
42
43 /** 商户号 */
44 unifiedorder.setMch_id(MCH_ID);
45
46 /** 随机字符串 */
47 unifiedorder.setNonce_str(UUID.randomUUID().toString().replaceAll("-", ""));
48
49 /** 商品描述 */
50 unifiedorder.setBody(payLog.getPayCode());
51
52 /** 商户订单号 */
53 unifiedorder.setOut_trade_no(payLog.getPayCode());
54
55 /** 订单总金额 */
56 unifiedorder.setTotal_fee(payLog.getPayPrice().multiply(new BigDecimal(100)).intValue() + ""); // 订单总金额,单位为分;
57
58 /** 用户端请求IP地址 */
59 unifiedorder.setSpbill_create_ip(IpUtils.getClientIp());
60
61 /** 异步通知回调地址 */
62 unifiedorder.setNotify_url(NOTIFY_URL);
63
64 /** 交易类型 */
65 unifiedorder.setTrade_type("APP");
66
67 LOGGER.warn("微信APP支付--(签名前):" + XMLConverUtil.convertToXML(unifiedorder));
68
69 /** 获取签名 */
70 UnifiedorderResult unifiedorderResult = PayMchAPI.payUnifiedorder(unifiedorder, PRIVATE_KEY);
71
72 LOGGER.warn("微信APP支付--支付统一下单接口请求状态(return_code):" + unifiedorderResult.getReturn_code());
73 LOGGER.warn("微信APP支付--支付统一下单接口请求状态(return_msg):" + unifiedorderResult.getReturn_msg());
74 LOGGER.warn("微信APP支付--支付统一下单接口请求状态(result_code):" + unifiedorderResult.getResult_code());
75 LOGGER.warn("微信APP支付--支付请求参数封装(签名后):" + XMLConverUtil.convertToXML(unifiedorder));
76 LOGGER.warn("微信APP支付--支付统一下单接口返回数据:" + FastJSONUtils.getJsonHelper().toJSONString(unifiedorderResult));
77
78 // 下单结果验签;
79 if(unifiedorderResult.getSign_status() != null && unifiedorderResult.getSign_status()) {
80 LOGGER.warn("微信APP支付验签成功");
81 return PayUtil.generateMchAppData(unifiedorderResult.getPrepay_id(), APPID, MCH_ID, PRIVATE_KEY);
82 }
83 return null;
84 }
85
86 /**
87 * @description:微信退款业务封装(支付押金退还);
88 * @param PayLog order:支付订单信息
89 * Double refundAmount:退款金额
90 * @return 微信退款接口返回数据 true 退款成功 false 退款失败
91 * @author:FanHaoJian
92 */
93 public Boolean refundOrder(PayLog order, Double refundAmount) {
94
95 // 调用微信支付退款接口;
96 SecapiPayRefund payRefund = new SecapiPayRefund();
97 payRefund.setAppid(APPID);
98 payRefund.setMch_id(MCH_ID);
99 payRefund.setNonce_str(UUID.randomUUID().toString().replaceAll("-", ""));
100 payRefund.setOut_trade_no(order.getPayCode());//支付订单号
101 payRefund.setOut_refund_no(order.getRefundCode());//退款单号
102 payRefund.setTotal_fee(order.getPayPrice().multiply(new BigDecimal(100)).intValue());//原订单金额,单位:分;
103 payRefund.setRefund_fee(new BigDecimal(refundAmount).multiply(new BigDecimal(100)).intValue());//退款订单金额,单位:分;
104
105 SecapiPayRefundResult refundResult = PayMchAPI.secapiPayRefund(payRefund, PRIVATE_KEY);
106
107 // 微信支付退款接口返回数据验签;
108 if(refundResult.getSign_status() != null && refundResult.getSign_status()) {
109 LOGGER.warn("微信退款接口--接口请求状态(return_code):" + refundResult.getReturn_code());
110 LOGGER.warn("微信退款接口--接口请求状态(return_msg):" + refundResult.getReturn_msg());
111
112 // 退款信息提交成功;
113 if("SUCCESS".equals(refundResult.getReturn_code())) {
114 LOGGER.warn("微信退款接口--接口请求状态(result_code):" + refundResult.getResult_code());
115 LOGGER.warn("微信退款接口--接口请求状态(err_code):" + refundResult.getErr_code());
116 LOGGER.warn("微信退款接口--接口请求状态(err_code_des):" + refundResult.getErr_code_des());
117
118 return Boolean.TRUE;
119 }
120 }
121
122 return Boolean.FALSE;
123 }
124 }
在项目建一个sdk包,然后统一放入sdk,类似这样!
然后创建一个微信支付SDK,将上面代码复制过去,然后看一遍代码里的方法流程,看明白后在改改里面的代码!
然后我简单介绍一下上面的微信支付SDK吧,里面有两个方法,一个是统一下单,一个是退款!
统一下单返回的数据就是要拿给移动端的签名数据,退款返回的数据就是true和false,没什么判断成功还是失败就行了,成功该做什么,失败该做什么!
OK! 现在说完了统一下单和退款后,还有一个支付通知结果的API,也就是异步通知了!如果你看完了那篇流程图,你就会知道,当移动端调起支付并且支付成功后,微信后台那边会向我们这边后台发送一个请求过来!
当然微信那边发送请求过来我们这边的接口,我也直接亮代码了!
1 /**
2 * @description:微信支付异步通知请求URL
3 * @author:小黑
4 */
5 public class WechatOrderNotify extends ActionSupport {
6 private static final Logger LOGGER = LoggerFactory.getLogger(WechatOrderNotify.class);
7 private static final long serialVersionUID = 1L;
8
9 /** 密钥 */
10 private static final String PRIVATE_KEY = "";
11
12 /** 定义应答变量 */
13 private String xml;
14
15 @Override
16 public String wechatOrderNotify() throws Exception {
17
18 // 解析微信支付异步通知请求参数;
19 HttpServletRequest request = ServletActionContext.getRequest();
20 String xml = StreamUtils.copyToString(request.getInputStream(), Charset.forName("utf-8"));
21 Map params = XMLConverUtil.convertToMap(xml);
22 MchPayNotify payNotify = XMLConverUtil.convertToObject(MchPayNotify.class, xml);
23
24 /** 打印日志信息 */
25 LOGGER.warn("$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$---进入微信支付异步通知请求接口---$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$");
26 LOGGER.warn("微信支付用户订单支付结果异步通知请求参数(xml):" + params);
27 LOGGER.warn("微信支付用户订单支付结果异步通知请求参数(map):" + params);
28 LOGGER.warn("return_code:" + payNotify.getReturn_code());
29 LOGGER.warn("return_msg:" + params.get("return_msg"));
30
31 /** 校验支付成功还是失败 */
32 if("SUCCESS".equals(payNotify.getReturn_code())) {
33
34 /** 获取微信后台返回来的异步通知参数 */
35 String outTradeNo = payNotify.getOut_trade_no(); // 用户订单号;
36 String tradeNo = payNotify.getTransaction_id(); // 微信交易号;
37 String tradeStatus = payNotify.getResult_code(); // 微信支付状态;
38 Integer totalFee = payNotify.getTotal_fee(); // 支付金额
39
40 /** 获取验签结果 true说明验签成功 false说明验签失败 */
41 boolean flag = SignatureUtil.validateSign(params, PRIVATE_KEY);
42
43 /** 打印日志信息 */
44 LOGGER.warn("微信支付--APP支付方式支付用户订单异步通知订单号(out_trade_no):" + outTradeNo);
45 LOGGER.warn("微信支付--APP支付方式支付用户订单异步通知交易号(trade_no):" + tradeNo);
46 LOGGER.warn("微信支付--APP支付方式支付用户订单异步通知交易状态(result_code):" + tradeStatus);
47 LOGGER.warn("微信支付--APP支付方式支付用户订单异步通知支付金额(total_fee):" + totalFee);
48 LOGGER.warn("微信支付--APP支付方式支付用户订单异步通知验签状态:" + flag);
49
50 /** 根据订单号获取订单支付信息: 支付状态为 '未支付' */
51 ...此处省略 根据订单号去查订单 我用hibernate的 你们可能用mybatis或者其他,所以自己去查吧!
52
53 /** 支付成功/处理订单业务信息 */
54 if(flag && "SUCCESS".equals(tradeStatus) && order != null) {
55
56 /** 更新订单支付信息: */
57 ...此处省略 根据自己项目的业务去处理逻辑!
58
59 /** 封装通知信息 */
60 MchBaseResult baseResult = new MchBaseResult();
61 baseResult.setReturn_code("SUCCESS");
62 baseResult.setReturn_msg("OK");
63 xml = XMLConverUtil.convertToXML(baseResult);
64
65 /** 支付成功 */
66 }else if(flag && "SUCCESS".equals(tradeStatus)){
67 MchBaseResult baseResult = new MchBaseResult();
68 baseResult.setReturn_code("SUCCESS");
69 baseResult.setReturn_msg("OK");
70 xml = XMLConverUtil.convertToXML(baseResult);
71
72 /** 支付失败 */
73 }else {
74 MchBaseResult baseResult = new MchBaseResult();
75 baseResult.setReturn_code("FAIL");
76 baseResult.setReturn_msg("FAIL");
77 xml = XMLConverUtil.convertToXML(baseResult);
78 }
79
80 /** 支付失败 */
81 }else {
82 MchBaseResult baseResult = new MchBaseResult();
83 baseResult.setReturn_code("FAIL");
84 baseResult.setReturn_msg("FAIL");
85 xml = XMLConverUtil.convertToXML(baseResult);
86 }
87 LOGGER.warn("微信支付--APP支付方式支付用户订单异步通知返回数据:" + xml);
88 return Results.XML;
89 }
90
91 public String getXml() {
92 return xml;
93 }
94
95 public void setXml(String xml) {
96 this.xml = xml;
97 }
98 }
这里也是直接招搬过去,然后改改代码即可!需要注意的就是这个返回数据xml,你可能要自己定义一下,应答是要这种格式的: