SpringCloud(七)

1、开发文档

微信开发文档:https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_1

创新互联建站专注于龙岗网站建设服务及定制,我们拥有丰富的企业做网站经验。 热诚为您提供龙岗营销型网站建设,龙岗网站制作、龙岗网页设计、龙岗网站官网定制、成都小程序开发服务,打造龙岗网络公司原创品牌,更为您提供龙岗网站排名全网营销落地服务。


安全规范:https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=4_3

1、签名算法
(签名校验工具)
签名生成的通用步骤如下:

第一步,设所有发送或者接收到的数据为集合M,将集合M内非空参数值的参数按照参数名ASCII码从小到大排序(字典序),使用URL键值对的格式(即key1=value1&key2=value2…)拼接成字符串stringA。

特别注意以下重要规则:

◆ 参数名ASCII码从小到大排序(字典序);
◆ 如果参数的值为空不参与签名;
◆ 参数名区分大小写;
◆ 验证调用返回或微信主动通知签名时,传送的sign参数不参与签名,将生成的签名与该sign值作校验。
◆ 微信接口可能增加字段,验证签名时必须支持增加的扩展字段
第二步,在stringA最后拼接上key得到stringSignTemp字符串,并对stringSignTemp进行MD5运算,再将得到的字符串所有字符转换为大写,得到sign值signValue。 注意:密钥的长度为32个字节。

2、配置信息 和 工具类

2.1 核心配置文件

application.yml

#端口
server:
  port: 8096

#微信支付自定义配置参数
wechat:
  pay:
    app-id: xxxx # 公众账号ID
    mch-id: xxxx # 商户号ID
    mch-key: xxxxx # 商户密钥
    order-uri: https://api.mch.weixin.qq.com/pay/unifiedorder # 请求微信支付接口统一下单地址
    notify-uri: http://xxxxx.natappfree.cc/wxpay/notifyresult # 微信支付结果回调地址
    view-order-status-uri: https://api.mch.weixin.qq.com/pay/orderquery  #  查询订单状态地址

注意:其中的回调地址,需要内网穿透;

2.2 自定义配置类

/**
 * Created On : 3/11/2022.
 * 

* Author : huayu *

* Description: 自定义配置类 */ @Data @Component @ConfigurationProperties(prefix = "wechat.pay") public class WechatPayConfig { /* 公众账号ID */ private String appId; /* 商户号ID */ private String mchId; /* 商户密钥 */ private String mchKey; /* 请求微信支付接口统一下单地址 */ private String orderUri; /* 微信支付结果回调地址 */ private String notifyUri; /* 主动查询订单状态地址 */ private String viewOrderStatusUri; }

2.3 常量类

/**
 * Created On : 3/11/2022.
 * 

* Author : huayu *

* Description: 微信支付常量类 */ public class WechatPayConstant { //系统交易订单号的浅醉标识符 public static final String WECHAT_PAY_TRADE_ORDER_PREFIX ="kh"; //系统格式化日期字符串,到秒 public static final String WECHAT_PAY_TIME_PATTERN_ALL = "yyyyMMddHHmmss"; //系统格式化日期字符串,到天 public static final String WECHAT_PAY_TIME_PATTERN_DAY = "yyyyMMdd"; //微信支付的交易类型:naive public static final String WECHAT_PAY_TRADE_NATIVE = "NATIVE"; //微信支付的签名方式MD5 public static final String WECHAT_PAY_SIGN_TYPE_MD5= "MD5"; //微信支付的签名参数名 public static final String WECHAT_PAY_FIELD_SIGN = "sign"; //微信支付下单请求的字符集编码 public static final String WECHAT_PAY_ENCODING_UTF8="UTF-8"; //微信支付下单结果的成功状态码 public static final String WECHAT_PAY_RESULT_SUCCESS = "SUCCESS"; //微信支付结果异步回调的同步响应,成功 public static final String WECHAT_PAY_NOTIFY_SUCCESS=""; //微信支付结果异步回调的同步响应,失败 public static final String WECHAT_PAY_NOTIFY_FALL=""; //订单查询 结果成功的状态码 public static final String WECHAT_PAY_VIEW_ORDER_STATUS_SUCCESS = "SUCCESS"; }

2.4 工具类

WechatPayUtil 和 WechatPayXmlUtil :https://www.cnblogs.com/xiaoqigui/p/16855921.html

HttpClient4Util http请求工具类:https://www.cnblogs.com/xiaoqigui/p/16839536.html

3、请求微信统一下单接口,下单支付订单,返回支付链接

  1. 获取参数,放进map集合中并按key值,字典排序。
  2. 通过参数生成签名(生成的签名也放进map集合)。
  3. 将map集合转成xml字符串。
  4. 获取微信支付统一下单地址,xml参数字符串作为参数发送请求。
  5. 返回支付的链接(可以生成二维码给用户扫码支付)。

3.0 参数列表

3.1 接口

/**
 * Created On : 3/11/2022.
 * 

* Author : huayu *

* Description: 微信支付业务接口 */ public interface WechatPayService { /** * @author : huayu * @date : 3/11/2022 * @param : [] * @return : java.lang.String * @description : 生成请求微信支付接口的统一下单接口参数 ,返回xml格式字符串 */ String generateWxUnifyOrderXmlParams(String productBody,int totalFee) throws Exception; /** * @author : huayu * @date : 3/11/2022 * @param : [unifyOrderXmlParams] * @return : java.util.Map * @description : 请求微信支付统一下单 */ Map getWchatPayUnifyOrderResult(String unifyOrderXmlParams) throws Exception; }

3.2 实现类

/**
 * Created On : 3/11/2022.
 * 

* Author : huayu *

* Description: 微信支付业务接口实现类 */ @Service @Slf4j public class WechatPayServiceImpl implements WechatPayService { @Autowired private WechatPayConfig wechatPayConfig; @Override public String generateWxUnifyOrderXmlParams(String productBody,int totalFee) throws Exception { //微信支付接口签名参数要求 //特别注意一下要求规则:参数名ASCII码从小到大排序(字典排序);如果参数值为空不参与签名;参数区分大小写; //定义微信支付解析参数集合:TreeMap(自动横距集合中key按照字典排序) TreeMap paramsMap = new TreeMap<>(); //公众账号ID appid 必传参数 微信支付分配的公众账号ID(企业号corpid即为此appid) paramsMap.put("appid",wechatPayConfig.getAppId()); //商户号 mch_id 微信支付分配的商户号 paramsMap.put("mch_id",wechatPayConfig.getMchId()); //设备号 device_info 自定义参数,可以为终端设备号(门店号或收银设备ID),PC网页或公众号内支付可以传"WEB" paramsMap.put("device_info","WEB"); //随机字符串 nonce_str 随机字符串,长度要求在32位以内。推荐随机数生成算法 paramsMap.put("nonce_str",WechatPayUtil.generateNonceStr()); //商品描述 body 商品简单描述,该字段请按照规范传递,具体请见参数规定 paramsMap.put("body",productBody); //附件数据 attach paramsMap.put("attach","课工场KH96"); //商户订单号 out_trade_no 商户系统内部订单号,要求32个字符内(最少6个字符),只能是数字、大小写字母_-|*且在同一个商户号下唯一。详见商户订单号 paramsMap.put("out_trade_no",WechatPayUtil.generateTradeOrderNo()); //标价金额 total_fee 订单总金额,单位为分,详见支付金额 paramsMap.put("total_fee",String.valueOf(totalFee)); //终端IP spbill_create_ip 支持IPV4和IPV6两种格式的IP地址。用户的客户端IP paramsMap.put("spbill_create_ip","121.225.201.22"); //通知地址 notify_url body 异步接收微信支付结果通知的回调地址,通知url必须为外网可访问的url,不能携带参数。 公网域名必须为https,如果是走专线接入,使用专线NAT IP或者私有回调域名可使用http paramsMap.put("notify_url",wechatPayConfig.getNotifyUri()); //交易类型 trade_type NATIVE -Native 支付 JSAPI -JSAPI支付 NATIVE -Native支付 APP -APP支付 paramsMap.put("trade_type", WechatPayConstant.WECHAT_PAY_TRADE_NATIVE); //商品ID trade_type=NATIVE时,此参数必传。此参数为二维码中包含的商品ID,商户自行定义。 paramsMap.put("product_id","互联网架构师"); //签名,传送的sign参数不参与签名,会将生成的签名与该sign值作校验。如果不一致,签名失败 //切记:签名都是再确定好接口参数后,指定签名操作,并将签名的结果加入参数集合 paramsMap.put("sign",WechatPayUtil.generateSignature(paramsMap,wechatPayConfig.getMchKey())); return WechatPayUtil.generateMapToXml(paramsMap); } @Override public Map getWchatPayUnifyOrderResult(String unifyOrderXmlParams) throws Exception { //发送post请求,请求微信支付统一下单接口,下预支付订单,并获取下单结果 String unifyOrderXmlResult = HttpClient4Util.getResponse4PostByString(wechatPayConfig.getOrderUri() , unifyOrderXmlParams , WechatPayConstant.WECHAT_PAY_ENCODING_UTF8); return WechatPayUtil.generateXmlToMap(unifyOrderXmlResult); } }

3.3 请求方法

/**
 * Created On : 3/11/2022.
 * 

* Author : huayu *

* Description: 微信支付接口对接测试入口 */ @Slf4j @RestController public class WechatPagController { @Autowired private WechatPayService wechatPayService; /** * @author : huayu * @date : 3/11/2022 * @param : [] * @return : com.kgc.scd.uitl.RequestResult> * @description : 请求微信统一下单接口,下单支付订单,返回支付链接 */ @PostMapping("/wxpay/unifyOrder") public RequestResult> wechatPagUnifyOrder(@RequestParam String productBody, @RequestParam int totalFree) throws Exception { //调用业务接口,生成微信支付接口,统一下单的完整参数,xml格式(微信支付的接口要求,交互参数必须是xml) String unifyOrderXmlParams = wechatPayService.generateWxUnifyOrderXmlParams(productBody, totalFree); log.info("------ 1.请求微信支付统一下单参数:{} -------",unifyOrderXmlParams); //调用业务接口,请求微信支付统一下单接口,获取下单结果 Map unifyOrderMapResult = wechatPayService.getWchatPayUnifyOrderResult(unifyOrderXmlParams); log.info("------ 2.请求微信支付统一下订单接口返回:{} --------",unifyOrderMapResult); //定义当前接口返回的map集合 Map resultMap = new HashMap<>(); //解析微信支付下单结果,如果下单成功,获取用户进行扫码支付的连接,返回给前端,生成二维码, if(WechatPayConstant.WECHAT_PAY_RESULT_SUCCESS.equals(unifyOrderMapResult.get("return_code")) && WechatPayConstant.WECHAT_PAY_RESULT_SUCCESS.equals(unifyOrderMapResult.get("result_code"))){ // 微信支付统一下单成功,省略签名校验 // 获取成功的结果 // 交易类型 resultMap.put("trade_type", unifyOrderMapResult.get("trade_type")); // 预支付交易会话标识 resultMap.put("prepay_id", unifyOrderMapResult.get("prepay_id")); // 二维码链接 resultMap.put("code_url", unifyOrderMapResult.get("code_url")); // 返回统一下预支付单成功 return ResultBuildUtil.success(resultMap); } // 统一下预支付单失败 return ResultBuildUtil.fail(unifyOrderMapResult.get("return_code"), unifyOrderMapResult.get("return_msg")); } }

3.4 请求测试

3.4.1 发送请求

3.4.2 生成二维码

4、接收用户支付成功后,微信异步回调支付结果

  1. 支付后,微信官方,通过回调地址,返回用户信息通过数据流。
  2. 解析回调数据流。
  3. 解析异步回调的支付结果。
  4. 同步给微信官方响应结果。

4.1接口

/**
* @author : huayu
* @date   : 3/11/2022
* @param  : [wxpayNotifyXmlResult]
* @return : java.lang.String
* @description : 调用业务接口,解析异步回调的支付结果,并获取通知微信官方的结果
*/
String getNotifyWechatXmlResult(String wxpayNotifyXmlResult) throws Exception;

4.2 实现类

@Override
public String getNotifyWechatXmlResult(String wxpayNotifyXmlResult) throws Exception {

    //将微信支付结果通知的xml格式字符串,转换位map集合,方便处理
    Map wxpayNotifyXmlForMapResult = WechatPayUtil.generateXmlToMap(wxpayNotifyXmlResult);

    //解析回调结果
    if(WechatPayConstant.WECHAT_PAY_RESULT_SUCCESS.equals(wxpayNotifyXmlForMapResult.get("return_code"))){
        //官方提醒:商户系统对于支付结果通知的内容一定要做签名验证,并校验返回的订单金额是否与商户侧的订单金额一致,防止数据泄露导致出现“假通知”,造成资金损失。
        if(WechatPayUtil.isSignatureValid(wxpayNotifyXmlForMapResult,wechatPayConfig.getMchKey())){
            // 签名校验成功,说明回调结果是可信的,就可以进行业务处理,如果签名失败,说明回调来源不可信,不能进行业务处理
            // TODO 真实业务中,收到正确回调,就要进行对应的业务处理,比如修改订单状态,发送主题消息,给定用户加积分,给物流生成物流单等等
            // 业务处理成功后,需要同步给微信响应结果-成功

            //成功
            return WechatPayConstant.WECHAT_PAY_NOTIFY_SUCCESS;

        }

    }

    // 同步给微信响应结果-失败
    return  WechatPayConstant.WECHAT_PAY_NOTIFY_FALL;
}

4.3 请求方法

/**
* @author : huayu
* @date   : 3/11/2022
* @param  : [request, response]
* @return : void
* @description : 接收用户支付成功后,微信异步回调支付结果
*/
@RequestMapping("/wxpay/notifyresult")
public void receiveWechatPayNotifyResult(HttpServletRequest request, HttpServletResponse response){

    //支付完成后,微信会把相关支付结果及用户信息通过数据流的形式发送给商户,商户需要接收处理,并按文档规范返回应答。

    try(InputStream inputStream = request.getInputStream()){

        //解析回调数据流
        BufferedReader brf = new BufferedReader(new InputStreamReader(inputStream, StandardCharsets.UTF_8));

        //定义可变字符对象,保存返回的xml格式支付结果
        StringBuilder wxpayNotifyXmlResult = new StringBuilder();

        //逐行解析
        String readline = null;
        while ((readline = brf.readLine()) != null){
            wxpayNotifyXmlResult.append(readline);
        }

        log.info("------ 3.微信支付结果异步回调内容:{} ------",wxpayNotifyXmlResult);


        //调用业务接口,解析异步回调的支付结果,并获取通知微信官方的结果
        String respWechatXmlResult = wechatPayService.getNotifyWechatXmlResult(wxpayNotifyXmlResult.toString());

        //同步给微信官方响应结果
        PrintWriter out = response.getWriter();
        out.write(respWechatXmlResult);
        out.flush();
        out.close();

        log.info("------ 4、微信支付异步回调处理后,响应结果:{} ------",respWechatXmlResult);

    }catch (Exception e){

        log.info("------ 微信支付结果异步回调处理异常,异常信息:{} ------", e.getMessage());

    }


}

4.4 请求测试(微信官方回调)

5、查看用户订单状态

  1. 获取参数,放进map集合中并按key值,字典排序。
  2. 通过参数生成签名(生成的签名也放进map集合)。
  3. 将map集合转成xml字符串。
  4. 获取订单状态查询地址,xml参数字符串作为参数发送请求。
  5. 返回订单状态信息。

5.0 参数列表

5.1 接口

/**
* @author : huayu
* @date   : 3/11/2022
* @param  : [orderNo]
* @return : java.lang.String
* @description : 通过订单好查询订单状态
*/
Map getOrderStatus(String orderNo) throws Exception;

5.2 实现类

@Override
public Map getOrderStatus(String orderNo) throws Exception {

    log.info("++++++  获取查询订单状态的参数 ++++++");

    //参数集合
    TreeMap paramsMap = new TreeMap<>();

    //公众账号ID  appid
    paramsMap.put("appid",wechatPayConfig.getAppId());

    //商户号 mch_id
    paramsMap.put("mch_id",wechatPayConfig.getMchId());

    //商户订单号 out_trade_no
    paramsMap.put("out_trade_no",orderNo);

    //随机字符串 nonce_str
    paramsMap.put("nonce_str",WechatPayUtil.generateNonceStr());

    //签名	sign
    paramsMap.put("sign",WechatPayUtil.generateSignature(paramsMap,wechatPayConfig.getMchKey()));


    //将map集合的参数转换成xml格式的字符串
    String paramsMapToXml = WechatPayUtil.generateMapToXml(paramsMap);

    log.info("++++++  查询订单状态的参数:{} ++++++",paramsMapToXml);

    //发送post请求,获取订单状态 xml格式字符串
    String orderStatusXmlResult = HttpClient4Util.getResponse4PostByString(wechatPayConfig.getViewOrderStatusUri()
                                                                           , paramsMapToXml
                                                                           , WechatPayConstant.WECHAT_PAY_ENCODING_UTF8);

    log.info("++++++发送post请求,获取订单状态 xml格式字符串 orderStatusXmlResult:  ++++++\n{}",orderStatusXmlResult);

    //将xml格式结果字符串转化成 map 集合
    Map orderStatusXmlResultToMap = WechatPayUtil.generateXmlToMap(orderStatusXmlResult);

    //判断返回结果
    //交易成功判断条件: return_code、result_code和trade_state都为SUCCESS
    if(WechatPayConstant.WECHAT_PAY_VIEW_ORDER_STATUS_SUCCESS.equals(orderStatusXmlResultToMap.get("return_code"))
       && WechatPayConstant.WECHAT_PAY_VIEW_ORDER_STATUS_SUCCESS.equals(orderStatusXmlResultToMap.get("result_code"))
       && WechatPayConstant.WECHAT_PAY_VIEW_ORDER_STATUS_SUCCESS.equals(orderStatusXmlResultToMap.get("trade_state"))
      ){
        
        //返回订单信息
        return orderStatusXmlResultToMap;

    }

    return null;
}

5.3 请求方法

/**
* @author : huayu
* @date   : 3/11/2022
* @param  : [orderNo]
* @return : void
* @description : 查看用户订单状态
*/
@RequestMapping("/wxpay/viewOrderStatus")
public RequestResult viewOrderStatus(@RequestParam String orderNo) throws Exception {

    //调用业务层 查询订单状态
    String orderStatus = wechatPayService.getOrderStatus(orderNo);

		if(orderStatusInfoMap != null){
            return ResultBuildUtil.success(orderStatusInfoMap);
        }

        return ResultBuildUtil.fail(null);

}

5.4 请求测试

5.4.1 发起请求


5.4.2 请求结果





网页题目:SpringCloud(七)
本文网址:http://lszwz.com/article/dsoioeg.html

其他资讯

售后响应及时

7×24小时客服热线

数据备份

更安全、更高效、更稳定

价格公道精准

项目经理精准报价不弄虚作假

合作无风险

重合同讲信誉,无效全额退款