总结一下微信APP支付

微信APP支付

你好 ，博主是一个工作时限未满一年正在努力奋斗中的小白，文章中若有什么错误和不足之处欢迎大家在评论区指出和讨论。我这里的IDE用的是idea,springboot框架,具体开发过程是参照微信支付官方文档来的,链接
,调用的接口是统一下单接口,链接。
我的项目结构是这样的:

这里的appclient_cert.p12是微信证书文件 可以去官方文档看生成教程

pom.xml配置文件

我这里有的依赖是走的我本地的私服maven仓库，涉及到相应业务需要的依赖可自行添加

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.3.1.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.example</groupId>
    <artifactId>wxpay</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>wxpay</name>
    <description>Demo project for Spring Boot</description>

    <!--  指定私服仓库  -->
    <repositories>
        <repository>
            
        </repository>
    </repositories>

    <!--  指定插件仓库  -->
    <pluginRepositories>
        <pluginRepository>
           
        </pluginRepository>
    </pluginRepositories>

    <properties>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>

        <dependency>
            <groupId>com.github.wxpay</groupId>
            <artifactId>wxpay-sdk</artifactId>
            <version>0.0.3</version>
        </dependency>

        <dependency>
            <groupId>httpcomponents-httpcore</groupId>
            <artifactId>httpcore</artifactId>
            <version>4.0-alpha6</version>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-websocket</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>2.1.1</version>
        </dependency>
        
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
            <exclusions>
                <exclusion>
                    <groupId>org.junit.vintage</groupId>
                    <artifactId>junit-vintage-engine</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
        
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.16.16</version>
        </dependency>
        
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>fastjson</artifactId>
            <version>1.2.46</version>
        </dependency>

        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>2.9.2</version>
            <exclusions>
                <exclusion>
                    <groupId>io.swagger</groupId>
                    <artifactId>swagger-annotations</artifactId>
                </exclusion>
                <exclusion>
                    <groupId>io.swagger</groupId>
                    <artifactId>swagger-models</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
        
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version>2.9.2</version>
        </dependency>
        
        <dependency>
            <groupId>io.swagger</groupId>
            <artifactId>swagger-annotations</artifactId>
            <version>1.5.22</version>
        </dependency>
        
        <dependency>
            <groupId>io.swagger</groupId>
            <artifactId>swagger-models</artifactId>
            <version>1.5.22</version>
        </dependency>
        
        <dependency>
            <groupId>com.wlld</groupId>
            <artifactId>easyai</artifactId>
            <version>1.0.0</version>
        </dependency>

        <dependency>
            <groupId>com.shareData</groupId>
            <artifactId>chainmarket</artifactId>
            <version>1.0.0</version>
        </dependency>

        <dependency>
            <groupId>com.wlld</groupId>
            <artifactId>cup</artifactId>
            <version>1.0.0</version>
        </dependency>

        <dependency>
            <groupId>org.apache.commons</groupId>
            <artifactId>commons-pool2</artifactId>
        </dependency>

    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

WXConfig工具类

package com.annaru.upms.payment.config;

import com.github.wxpay.sdk.WXPayConfig;
import org.springframework.core.io.ClassPathResource;
import org.springframework.util.ClassUtils;

import java.io.ByteArrayInputStream;
import java.io.File;
import java.io.FileInputStream;
import java.io.InputStream;
import java.security.KeyStore;

public class WXConfigUtil implements WXPayConfig {
    private byte[] certData;
    public static final String APP_ID = "这里是你的商户应用appid";
    public static final String KEY = "这里是你的商户KEY(32位api秘钥)";
    public static final String MCH_ID = "这里是你的商户id";


    public WXConfigUtil() throws Exception {

        String certPath = "src/main/resources/apiclient_cert.p12";//从微信商户平台下载的安全证书存放的路径
        File file = new File(certPath);
        InputStream certStream = new FileInputStream(file);
        this.certData = new byte[(int) file.length()];
        certStream.read(this.certData);
        certStream.close();
    }

    @Override
    public String getAppID() {
        return APP_ID;
    }

    //mchid，商户号
    @Override
    public String getMchID() {
        return MCH_ID;
    }

    @Override
    public String getKey() {
        return KEY;
    }

    @Override
    public InputStream getCertStream() {
        ByteArrayInputStream certBis = new ByteArrayInputStream(this.certData);
        return certBis;
    }

    @Override
    public int getHttpConnectTimeoutMs() {
        return 8000;
    }

    @Override
    public int getHttpReadTimeoutMs() {
        return 10000;
    }
}

Service接口

package com.annaru.upms.payment.service;


import java.math.BigDecimal;
import java.util.Map;

public interface WxService {


    String doUnifiedOrder(String money) throws Exception;
}

Impl实现类

package com.annaru.upms.payment.service.impl;

import com.annaru.upms.payment.config.WXConfigUtil;
import com.annaru.upms.payment.service.WxService;
import com.annaru.upms.payment.util.AmountUtils;
import com.github.wxpay.sdk.WXPay;
import com.github.wxpay.sdk.WXPayConstants;
import com.github.wxpay.sdk.WXPayUtil;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.math.BigDecimal;
import java.text.SimpleDateFormat;
import java.util.*;

import static com.github.wxpay.sdk.WXPayUtil.MD5;

@Service
@Slf4j
public class WxServiceImpl implements WxService {
    //定义一些业务会用到的常量
    public static final String SPBILL_CREATE_IP = "127.0.0.1";    //终端IP
    public static final String NOTIFY_URL = "https://api.mch.weixin.qq.com/pay/unifiedorder";    //通知地址
    public static final String TRADE_TYPE_APP = "APP";    //交易类型



    @Override
    public String doUnifiedOrder(String money) throws Exception {

        try {

            WXConfigUtil config = new WXConfigUtil();
            WXPay wxpay = new WXPay(config);
            Map<String, String> data = new HashMap<>();
            data.put("appid", config.getAppID());
            data.put("mch_id", config.getMchID());
            data.put("nonce_str", WXPayUtil.generateNonceStr());
            String body = "test";
            data.put("body", body);
            SimpleDateFormat sdf = new SimpleDateFormat("yyyyMMddHHmmss");//获取当前时间
            //商户订单号生成方式: 根据当前系统时间加随机数生成,理论上是唯一的
            Random random = new Random();//定义随机数
            int length = random.nextInt(1000);
            Date date = new Date();
            String dateran = sdf.format(date);
            String outTradeNo = dateran+length;
            data.put("out_trade_no",outTradeNo);
            //终端IP地址
            data.put("spbill_create_ip", SPBILL_CREATE_IP);
            //异步通知地址(请注意必须是外网)
            data.put("notify_url", NOTIFY_URL);
            //交易类型
            data.put("trade_type", TRADE_TYPE_APP);
            //附加数据，在查询API和支付通知中原样返回，该字段主要用于商户携带订单的自定义数据
            data.put("attach", "");
            //价格
            data.put("total_fee", money);
            data.put("sign", WXPayUtil.generateSignature(data, config.getKey(),
                    WXPayConstants.SignType.MD5));

            //使用官方API请求预付订单
            Map<String, String> response = wxpay.unifiedOrder(data);
            if ("SUCCESS".equals(response.get("return_code"))) {
                Map<String, String> param = new HashMap<>();
                //下面参数是用来生成签名的,可自行选择返回给前台
                param.put("appid", config.getAppID());
                param.put("mch_id", response.get("mch_id"));
                //微信生成的预支付会话标识,用于后续接口调用中使用,该值有效期为两小时
                param.put("prepay_id", response.get("prepay_id"));
                param.put("package", "Sign=WXPay");
                param.put("out_trade_no", data.get("out_trade_no"));
                param.put("notify_url", data.get("notify_url"));
                param.put("spbill_create_ip", data.get("spbill_create_ip"));
                param.put("nonce_str", WXPayUtil.generateNonceStr());
                param.put("timestamp", System.currentTimeMillis() / 1000 + "");
                //total_fee为价格  注意:价格的初始单位是分,现在传入的价格单位还是分,返回的结果是元
//                param.put("total_fee", AmountUtils.changeF2Y(money));
                param.put("total_fee",money);
                //上面参数改的话stringA签名规则也要改
               String stringA =  "appid=wx7de2a73268d104f3&device_info=WEB&mch_id=1559130801&nonce_str="+param.get(
                       "nonce_str")+"&notify_url=https://api.mch.weixin.qq.com/pay/unifiedorder&out_trade_no="+data.get("out_trade_no")+
                       "&package=Sign=WXPay&prepay_id="+response.get("prepay_id")+"&result_code=SUCCESS" +
                       "&spbill_create_ip=127.0.0.1&timestamp="+param.get("timestamp")+
                       "&total_fee" +
                       "="+param.get("total_fee")+"";
                String stringSignTemp=stringA+"&key=6466c3c49697436091a2e852cb15033e";//注：key为商户平台设置的密钥key
                String sign =MD5(stringSignTemp).toUpperCase();//注：MD5签名方式  转大写
                param.put("sign", sign);
                param.put("device_info", "WEB");
                param.put("result_code", response.get("result_code"));
                //现在返回信息param是个map  要把它转换成xml格式方便显示
                StringBuffer stringBuffer = new StringBuffer("");
                stringBuffer.append("<xml>");
                Set<String> set = param.keySet();
                for (Iterator<String> it = set.iterator();it.hasNext();){
                String key = it.next();
                Object value = param.get(key);
                stringBuffer.append("<").append(key).append(">");
                stringBuffer.append(value);
                stringBuffer.append("</").append(key).append(">");
                }

                stringBuffer.append("</xml>");
                //这里的stringBuffer为一个xml格式的文本 作为参数传入微信回调
                String resultXml = stringBuffer.toString();
                try {
                    config = new WXConfigUtil();
                } catch (Exception e) {
                    e.printStackTrace();
                }
                String xmlBack = "";
                Map<String, String> notifyMap = null;
                try {
                    notifyMap = WXPayUtil.xmlToMap(resultXml);         //调用官方SDK转换成map类型数据
                    if (wxpay.isPayResultNotifySignatureValid(notifyMap)) {//验证签名是否有效，有效则进一步处理

                String return_code = response.get("return_code");//状态
                        String out_trade_no = notifyMap.get("out_trade_no");//商户订单号
                if (return_code.equals("SUCCESS")) {
                        if (out_trade_no != null) {
                            //注意特殊情况: 订单已经退款,但收到了支付结果成功的通知,不应该把商户的订单状态从退款改成支付成功
                            //注意特殊情况: 微信服务端同样的通知可能会多次发送给商户系统,所以数据持久化之前需要检查是否已经处理过了,处理了直接返回成功标志
                            //下面为返回给前台的xml格式的数据
                            log.info("微信支付回调成功订单号:{}", out_trade_no);
                            xmlBack = "<xml>" + "<return_code><![CDATA["+response.get("return_code")+
                                    "]]></return_code>" +
                                    "<return_msg" +
                                    "><![CDATA" +
                                    "[OK]]></return_msg>" + "<sign" +
                                    "><![CDATA["+notifyMap.get("sign")+"]]></sign>"+"<out_trade_no><![CDATA["+notifyMap.get(
                                    "out_trade_no")+"]]></out_trade_no>"+"<prepay_id><![CDATA["+notifyMap.get("prepay_id")+
                                    "]]></prepay_id>"+ "<total_fee><![CDATA["+notifyMap.get("total_fee")+"]]></total_fee>"+
                                    "</xml> ";
                        } else {
                            log.info("微信支付回调失败订单号:{}", out_trade_no);
                            xmlBack = "<xml>" + "<return_code><![CDATA[FAIL]]></return_code>" + "<return_msg><![CDATA[报文为空]]></return_msg>" + "</xml> ";
                        }
                }
                        return xmlBack;
                    } else {
                        // 签名错误的场景:如果数据中没有sign字段 也认为是签名错误
                        log.error("支付回调通知签名错误");
                        xmlBack = "<xml>" + "<return_code><![CDATA[FAIL]]></return_code>" + "<return_msg><![CDATA[报文为空]]></return_msg>" + "</xml> ";
                        return xmlBack;
                    }
                } catch (Exception e) {
                    log.error("支付回调通知失败", e);
                    xmlBack = "<xml>" + "<return_code><![CDATA[FAIL]]></return_code>" + "<return_msg><![CDATA[报文为空]]></return_msg>" + "</xml> ";

                }
                return xmlBack;
            }
        } catch (Exception e) {
            e.printStackTrace();
            throw new Exception("下单失败");
        }
        throw new Exception("下单失败");
    }

}

实现类这里原本是两个接口,一个是返回xml格式的文本,另一个是回调接口,这里由于我的业务问题我合并成一个了,只需要传入一个金额调用统一下单接口返回一个prepay_id即可。这里踩过一个坑是签名算法,签名算法顺序不能错,具体步骤可以参照官方文档
校验签名有效性的链接

Controller层

package com.annaru.upms.payment.controller;


import com.annaru.upms.payment.service.WxService;
import io.swagger.annotations.ApiOperation;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.context.annotation.RequestScope;
import org.springframework.web.context.annotation.SessionScope;

import javax.servlet.http.HttpServletRequest;
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.util.Map;

@RestController
@RequestMapping("/order")
public class OrderController {

    @Autowired
    private WxService wxService;

    @PostMapping("/wxpay")
    @ApiOperation("调用微信支付")
    public String wxAdd(String money) throws Exception {
        return wxService.doUnifiedOrder(money);
    }

}

这里附上微信支付元分转换的工具类,业务需要的话可以加上,工具类转载于这位大佬的博客