微信登录以及微信支付流程

序言

微信登录和微信支付在很多互联网开发中，已经成为必不可少的技术特点。今天，稍微做个简短的总结。

微信登录流程

准备工作：在进行微信OAuth2.0授权登录接入之前，在微信开放平台注册开发者帐号，并拥有一个已审核通过的网站应用，并获得相应的AppID和AppSecret，申请微信登录且通过审核后，可开始接入流程。
登录流程：具体对应下图：

具体详说整个流程:
1.用户在前端页面点击微信登录，访问后台登录接口，验证参数合法性后重定向到二维码扫描页面。
2.用户用微信扫一扫，请求微信OAuth2.0授权登录，根据授权获得的code(授权凭证)访问后台微信回调接口，拼接参数，内部通过HttpClient请求accessTokenUrl获取 accsess_token 和 openid(微信对每个用户的唯一标识)
3.若2没出错，根据openid查询数据库中是否已存在当前用户。若存在，查询出当前用户信息，通过JWT将当前用户信息放入token并重定向到应用网站；若不存在，根据accsess_token 和openid远程访问微信的资源服务器，获取用户信息，再将用户信息封装成表对象并入库，并通过JWT将当前用户信息放入token并重定向到应用网站。至此，整个登录流程完成。
核心代码：

/**
 * @author xfnihao
 * 前台系统:用户微信登录
 */
@Controller
@RequestMapping("wx/user")
public class UserWxLoginController {
    @Autowired
    UcenterMemberService ucenterMemberService;

    /**
     * 点击微信登录
     * @return
     */
    @GetMapping("/login")
    public  String wxUserScanQrcode(){

        String baseUrl="https://open.weixin.qq.com/connect/qrconnect"+
                "?appid=%s"+
                "&redirect_uri=%s"+
                "&response_type=code"+
                "&scope=snsapi_login"+
                "&state=%s"+
                "#wechat_redirect";

        //ConstantWxUtils中主要封装在微信平台注册的核心参数
        String redirectUrl= ConstantWxUtils.WX_OPEN_REDIRECT_URL;
        try {
            URLEncoder.encode(redirectUrl,"utf-8");

        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
        }
        String url=String.format(baseUrl, ConstantWxUtils.WX_OPEN_APP_ID,redirectUrl,"xfnihao");
        return "redirect:"+url;
    }
    /**
     * 获取扫描微信用户信息
     * @return
     */
    @GetMapping("/callback")
    public String userInfo(@RequestParam("code")String code,@RequestParam("state")String state){
        try {
            //1 获取code值，临时票据，类似于验证码
            //2 拿着code请求 微信固定的地址，得到两个值 accsess_token 和 openid
            String baseAccessTokenUrl = "https://api.weixin.qq.com/sns/oauth2/access_token" +
                    "?appid=%s" +
                    "&secret=%s" +
                    "&code=%s" +
                    "&grant_type=authorization_code";
            //拼接三个参数 ：id  秘钥 和 code值
            String accessTokenUrl = String.format(
                    baseAccessTokenUrl,
                    ConstantWxUtils.WX_OPEN_APP_ID,
                    ConstantWxUtils.WX_OPEN_APP_SECRET,
                    code
            );
            //请求这个拼接好的地址，得到返回两个值 accsess_token 和 openid
            //使用httpclient发送请求，得到返回结果
            String accessTokenInfo =HttpClientUtils.get(accessTokenUrl);

            //从accessTokenInfo字符串获取出来两个值 accsess_token 和 openid
            //把accessTokenInfo字符串转换map集合，根据map里面key获取对应值
            //使用json转换工具 Gson
            Gson gson = new Gson();
            HashMap<String,String> mapAccessToken = gson.fromJson(accessTokenInfo, HashMap.class);
            String access_token = mapAccessToken.get("access_token");
            String openid = mapAccessToken.get("openid");

            //把扫描人信息添加数据库里面
            //判断数据表里面是否存在相同微信信息，根据openid判断
            UcenterMember member = ucenterMemberService.getOpenIdMember(openid);
            if(member == null) {//memeber是空，表没有相同微信数据，进行添加

                //3 拿着得到accsess_token 和 openid，再去请求微信提供固定的地址，获取到扫描人信息
                //访问微信的资源服务器，获取用户信息
                String baseUserInfoUrl = "https://api.weixin.qq.com/sns/userinfo" +
                        "?access_token=%s" +
                        "&openid=%s";
                //拼接两个参数
                String userInfoUrl = String.format(
                        baseUserInfoUrl,
                        access_token,
                        openid
                );
                //发送请求
                String userInfo = HttpClientUtils.get(userInfoUrl);
                //获取返回userinfo字符串扫描人信息
                HashMap<String,String> userInfoMap = gson.fromJson(userInfo, HashMap.class);
                String nickname = userInfoMap.get("nickname");//昵称
                String headimgurl = userInfoMap.get("headimgurl");//头像

                member = new UcenterMember();
                member.setOpenid(openid);
                member.setNickname(nickname);
                member.setAvatar(headimgurl);
                ucenterMemberService.save(member);
            }

            //使用jwt根据member对象生成token字符串
            String jwtToken = JwtUtils.getJwtToken(member.getId(), member.getNickname());
            //最后：返回首页面，通过路径传递token字符串
            return "redirect:http://localhost:3000?token="+jwtToken;
        }catch(Exception e) {
            throw new XfOnlineException(XfEnum.USER_REGISTER_EXCEPTION.getCode(),XfEnum.USER_REGISTER_EXCEPTION.getMsg());
        }
    }

}

微信支付

商户系统和微信支付系统主要交互说明：
步骤1：用户在商户APP中选择商品，提交订单，选择微信支付。
步骤2：商户后台收到用户支付单，调用微信支付统一下单接口
步骤3：统一下单接口返回正常的prepay_id，再按签名规范重新生成签名后，将数据传输给APP。参与签名的字段名为appid，partnerid，prepayid，noncestr，timestamp。
步骤4：商户APP调起微信支付，支付完成，会异步通知商户后台
步骤5：商户后台接收支付通知，也就是在程序配置中的notify_url
步骤6：商户后台查询支付结果，最终根据支付结果，进行下一步操作，如增加支付记录等。
核心代码:

//根据订单号，调用微信支付接口
public Map<String, Object> createQrCode(String orderNo) {

        try {
            //1 根据订单号查询订单信息
            QueryWrapper<Order> wrapper = new QueryWrapper<>();
            wrapper.eq("order_no",orderNo);
            Order order = orderService.getOne(wrapper);

            //2 使用map设置生成二维码需要参数
            Map<String,String> m = new HashMap<>();
            m.put("appid","appid");
            m.put("mch_id", "mch_id");
            m.put("nonce_str", WXPayUtil.generateNonceStr());
            m.put("body", order.getDesc()); //body信息
            m.put("out_trade_no", orderNo); //订单号
            m.put("total_fee", order.getTotalFee().multiply(new BigDecimal("100")).longValue()+"");
            m.put("spbill_create_ip", "xxxxx");
            m.put("notify_url", "后台商户接收支付通知的url");
            m.put("trade_type", "NATIVE");

            //3 发送httpclient请求，传递参数xml格式，微信支付提供的固定的地址
            HttpClient client = new HttpClient("https://api.mch.weixin.qq.com/pay/unifiedorder");
            //设置xml格式的参数
            client.setXmlParam(WXPayUtil.generateSignedXml(m,"T6m9iK73b0kn9g5v426MKfHQH7X8rKwb"));
            client.setHttps(true);
            //执行post请求发送
            client.post();

            //4 得到发送请求返回结果
            //返回内容，是使用xml格式返回
            String xml = client.getContent();

            //把xml格式转换map集合，把map集合返回
            Map<String,String> resultMap = WXPayUtil.xmlToMap(xml);

            //最终返回数据 的封装
            Map map = new HashMap();
            map.put("out_trade_no", orderNo);
            map.put("course_id", order.getCourseId());
            map.put("total_fee", order.getTotalFee());
            map.put("result_code", resultMap.get("result_code"));  //返回二维码操作状态码
            map.put("code_url", resultMap.get("code_url"));        //二维码地址
            return map;
        }catch(Exception e) {
            throw new XfOnlineException(XfEnum.INTERNAL_EXCEPTION.getCode(),XfEnum.INTERNAL_EXCEPTION.getMsg());
        }
    }

再将返回的数据在前端页面展示，包括订单号，二维码，支付金额，商家名称等信息。接下来，就用微信进行扫码支付。支付结果可以通过前端轮询去获取订单的支付状态，根据支付状态，再进行支付流水的入库，最终支付成功，再跳转到商品详情页。
核心代码:

public Map<String, String> getPayState(String orderNo) {
        try {
            //1、封装参数
            Map m = new HashMap<>();
            m.put("appid", "appid");
            m.put("mch_id", "mch_id");
            m.put("out_trade_no", orderNo);
            m.put("nonce_str", WXPayUtil.generateNonceStr());

            //2 发送httpclient
            HttpClient client = new HttpClient("https://api.mch.weixin.qq.com/pay/orderquery");
            client.setXmlParam(WXPayUtil.generateSignedXml(m,"T6m9iK73b0kn9g5v426MKfHQH7X8rKwb"));
            client.setHttps(true);
            client.post();

            //3 得到请求返回内容
            String xml = client.getContent();
            Map<String, String> resultMap = WXPayUtil.xmlToMap(xml);
            //6、转成Map再返回
            return resultMap; //支付结果通过map封装返回
        }catch(Exception e) {
            return null;
        }
    }

总结

微信支付和微信登录在很多开发场景都会用到，重要的不是去死记其中的API，每个开放平台都会提供对应的接入文档，代码就是一顿CV大法。而是要理解整个业务流程，这点很重要，通过理解其中的业务流程，当下次遇到其他类似场景如QQ登录，支付宝支付，其实套路也大致相似。