AI 助理
备案控制台
开发者社区 开发与运维 文章 正文

微信小程序退款流程详解

2022-01-16 2291
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
本文涉及的产品
密钥管理服务KMS，1000个密钥，100个凭据，1个月
简介： 微信小程序退款流程详解

在上一篇中我们介绍了微信小程序的支付流程，这一篇接着讲一下小程序的退款流程，首先看一下官方给出的介绍：

image.png

和付款流程不同，退款流程不再需要在前端页面额外调用微信接口，可由后端独立完成。可分为以下3步：

服务后端发送退款请求

接收微信同步返回结果

接收微信调用回调接口返回异步消息

image.png

生成退款参数及发送请求方法如下，和付款的统一支付接口相同，首先需要对请求中的参数进行签名，之后再发送http请求：

public String refund(String orderNumber, String refundNumber, double totalFee, double refundFee, String notifyUrl) {
    int totalMoney = new Double(Math.ceil(totalFee * 100)).intValue();   //转换为分
    int refundMoney = new Double(Math.ceil(refundFee * 100)).intValue();   //转换为分
    Map<String, String> wxMap = new HashMap<>();
    wxMap.put("appid", mpCommonProperty.getAppid());
    wxMap.put("mch_id", mpCommonProperty.getMuchId());
    wxMap.put("nonce_str", UUID.randomUUID().toString().replaceAll("-", ""));
    wxMap.put("notify_url", mpCommonProperty.getServerDomain() + notifyUrl);
    wxMap.put("out_refund_no", refundNumber);
    wxMap.put("out_trade_no", orderNumber);
    wxMap.put("refund_fee", String.valueOf(refundMoney));
    wxMap.put("total_fee", String.valueOf(totalMoney));
    wxMap.put("sign", mpPayUtil.signCommon(wxMap));
    String refundXml = XmlUtil.generateXmlFromMap(wxMap);
    String url = https://api.mch.weixin.qq.com/secapi/pay/refund";
    String xmlResult = null;
    try {
        xmlResult = mpCertificateUtil.doWxpayRequest(url, refundXml);
    } catch (Exception e) {
        e.printStackTrace();
    }
    log.info("xmlResult:" + xmlResult);
    return xmlResult;
}

参数说明：

orderNumber：需要执行退款的订单号

refundNumber：业务系统生成的退款单号

totalFee：订单总金额，如果业务系统单位为元，需要在发送请求前转化为分

refundFee：本次退款金额，同上

notifyUrl：接收通知的回调接口地址

微信退款支持一笔订单分多次退款，上面的方法可以用于执行部分退款操作，如果是执行一次性全部退款的话，那么可以重载上面的方法，减少传入的参数：

public String refund(String orderNumber,double totalFee,String notifyUrl){
    return refund(orderNumber,orderNumber,totalFee,totalFee,notifyUrl);
}

需要注意，和付款发送请求不同的是这里不能直接发起http请求，需要使用微信商户平台生成的证书。证书的申请流程也不复杂，登录商户平台，在账户中心点击申请API证书，下载证书工具后通过验证商户信息可以自动生成。在生成完pkcs12证书后，在每次发送退款请求时需要携带证书的信息。

下面是证书工具类，提供加载证书及发送携带证书的请求功能：

public class MPCertificateUtil {
    @Autowired
    MPCommonProperty mpCommonProperty;
    /**
     * 加载证书文件流，通过hex解析为16进制存到静态变量里
    */
    public String parseCertificateFile(){
        String haxString=null;
        try {
            ClassPathResource classPathResource=new ClassPathResource(mpCommonProperty.getCertFilePath());
            InputStream inputStream=classPathResource.getStream();
            haxString = Hex.encodeHexString(StreamUtils.copyToByteArray(inputStream));
        } catch (Exception e) {
            log.error("fileError:"+e.getMessage());
            e.printStackTrace();
        }
        return haxString;
    }
    /**
     * 发送微信携带证书请求
    */
    public String doWxpayRequest(String httpurl, String strxml) throws Exception {
        String cert = parseCertificateFile();
        if(StringUtils.isEmpty(cert)){
            throw new RuntimeException("cert is null");
        }
        CloseableHttpClient client = null;
        HttpPost httpPost = null;
        try {
            // 解密出16进制原证书文件内容为字节数组
            byte[] bytes = Hex.decodeHex(cert.toCharArray());
            ByteArrayInputStream input = new ByteArrayInputStream(bytes);
            KeyStore clientTrustKeyStore = KeyStore.getInstance("PKCS12");
            clientTrustKeyStore.load(input, mpCommonProperty.getMuchId().toCharArray());
            KeyManagerFactory kmf = KeyManagerFactory.getInstance(KeyManagerFactory.getDefaultAlgorithm());
            kmf.init(clientTrustKeyStore, mpCommonProperty.getMuchId().toCharArray());
            TrustManager[] tm = {new MyX509TrustManager()};
            SSLContext sslContext = SSLContext.getInstance("TLSv1");
            sslContext.init(kmf.getKeyManagers(), tm, new java.security.SecureRandom());
            SSLConnectionSocketFactory sslsf = new SSLConnectionSocketFactory(sslContext);
            client = HttpClients.custom().setSSLSocketFactory(sslsf).build();
            httpPost = new HttpPost(httpurl);
            httpPost.setEntity(new StringEntity(strxml, "utf-8"));
            CloseableHttpResponse response = client.execute(httpPost);
            StatusLine statusLine = response.getStatusLine();
            HttpEntity entity = response.getEntity();
            if (statusLine.getStatusCode() == 200) {
                return EntityUtils.toString(entity, "utf-8");
            }
        } catch (Exception e) {
            e.printStackTrace();
            throw e;
        } finally {
            if (client != null) {
                client.close();
            }
        }
        return null;
    }
}

在上面的代码中，读取了项目目录下的pkcs12证书文件，但是微信在官方文档中更加推荐不要将证书放在web服务器的虚拟目录下，通过放在有权限控制的目录中，防止被他人下载。

image.png

在发送完携带证书的http请求后，同步返回结果格式如下所示，接收到下面的信息后可以根据业务需求存入数据库中进行备案：

<xml>
   <return_code><![CDATA[SUCCESS]]></return_code>
   <return_msg><![CDATA[OK]]></return_msg>
   <appid><![CDATA[wx2421b1c4370ec43b]]></appid>
   <mch_id><![CDATA[10000100]]></mch_id>
   <nonce_str><![CDATA[NfsMFbUFpdbEhPXP]]></nonce_str>
   <sign><![CDATA[B7274EB9F8925EB93100DD2085FA56C0]]></sign>
   <result_code><![CDATA[SUCCESS]]></result_code>
   <transaction_id><![CDATA[1008450740201411110005820873]]></transaction_id>
   <out_trade_no><![CDATA[1415757673]]></out_trade_no>
   <out_refund_no><![CDATA[1415701182]]></out_refund_no>
   <refund_id><![CDATA[2008450740201411110000174436]]></refund_id>
   <refund_channel><![CDATA[]]></refund_channel>
   <refund_fee>1</refund_fee>
</xml>

注意返回结果中的return_code为SUCCESS时，只表示退款申请被微信服务器接收成功，并不是退款执行成功，退款的结果会在回调接口中被返回。

image.png

在退款执行成功或因某种原因执行失败后，微信会调用之前在发起请求时我们填写的回调接口地址，会把退款的结果以异步通知的形式发送给我们：

@PostMapping("refundFallBack")
public void refundFallBack(HttpServletRequest request,HttpServletResponse response) throws IOException {
    StringBuilder sb = new StringBuilder();
    BufferedReader reader = null;
    try (InputStream inputStream = request.getInputStream()) {
        reader = new BufferedReader(new InputStreamReader(inputStream, Charset.forName("UTF-8")));
        String line = "";
        while ((line = reader.readLine()) != null) {
            sb.append(line);
        }
    } catch (IOException e) {
        log.error("getBodyString错误！");
    } finally {
        if (reader != null) {
            try {
                reader.close();
            } catch (IOException e) {
                log.error(ExceptionUtils.getMessage(e));
            }
        }
    }
    String resultXml;
    String bodyXml = sb.toString();
    Map<String, String> xmlResult = XmlUtil.parseXmlToMap(bodyXml);
    if ("SUCCESS".equals(xmlResult.get("return_code"))) {
        String reqInfo = xmlResult.get("req_info");
        byte[] decode = Base64.decode(reqInfo);
        String md5Hash = Md5Utils.hash(WechatConstants.muchSecret);
        try {
            //AES解密
            String result = AESUtils.decryptData(decode, md5Hash);
            Map<String, String> resultMap = XmlUtil.parseXmlToMap(result);
            //执行业务逻辑...
            } catch (Exception e) {
              log.error(e.getMessage());
            }
        resultXml=WechatConstants.FALLBACK_SUCCESS_XML;
    }else{
        resultXml= WechatConstants.FALLBACK_FAIL_XML;
    }
    ServletOutputStream outputStream = response.getOutputStream();
    outputStream.println(resultXml);
    outputStream.close();
}

可以看出，异步返回通知并不能够被直接拿来解析使用，在使用过程中还进行了一次解密，这是因为返回的报文格式如下：

<xml>
<return_code>SUCCESS</return_code>
   <appid><![CDATA[wx2421b1c4370ec43b]]></appid>
   <mch_id><![CDATA[10000100]]></mch_id>
   <nonce_str><![CDATA[TeqClE3i0mvn3DrK]]></nonce_str>
   <req_info><![CDATA[T87GAHG17TGAHG1TGHAHAHA1Y1CIOA9UGJH1GAHV871HAGAGQYQQPOOJMXNBCXBVNMNMAJAA]]></req_info>
</xml>

其中req_info为加密信息，需要对其进行解密，解密步骤如下：

对加密串A做base64解码，得到加密串B

对商户key做md5加密，得到32位小写key*

用key*对加密串B做AES-256-ECB解密

AES解密工具类实现如下：

import javax.crypto.Cipher;
import javax.crypto.spec.SecretKeySpec;
import java.security.Security;
public class AESUtils {
    public static String decryptData(byte[] base64Data,String md5Hash) throws Exception {
        Security.addProvider(new org.bouncycastle.jce.provider.BouncyCastleProvider());
        //加解密算法/工作模式/填充方式
        Cipher cipher = Cipher.getInstance("AES/ECB/PKCS7Padding");
        SecretKeySpec key = new SecretKeySpec(md5Hash.toLowerCase().getBytes(), "AES");
        cipher.init(Cipher.DECRYPT_MODE, key);
        return new String(cipher.doFinal(base64Data), "UTF-8");
    }
}

解密完成后，得到真正包含退款信息的xml报文：

<root>
  <out_refund_no><![CDATA[131811191610442717309]]></out_refund_no>
  <out_trade_no><![CDATA[71106718111915575302817]]></out_trade_no>
  <refund_account><![CDATA[REFUND_SOURCE_RECHARGE_FUNDS]]></refund_account>
  <refund_fee><![CDATA[3960]]></refund_fee>
  <refund_id><![CDATA[50000408942018111907145868882]]></refund_id>
  <refund_recv_accout><![CDATA[支付用户零钱]]></refund_recv_accout>
  <refund_request_source><![CDATA[API]]></refund_request_source>
  <refund_status><![CDATA[SUCCESS]]></refund_status>
  <settlement_refund_fee><![CDATA[3960]]></settlement_refund_fee>
  <settlement_total_fee><![CDATA[3960]]></settlement_total_fee>
  <success_time><![CDATA[2018-11-19 16:24:13]]></success_time>
  <total_fee><![CDATA[3960]]></total_fee>
  <transaction_id><![CDATA[4200000215201811190261405420]]></transaction_id>
</root>

再对上面的报文进行解析，执行业务系统中对退款流程的后续处理即可。同样，我们需要按照微信规定的格式返回接收成功的报文，并在每次处理前验证通知消息的幂等性。

在退款中还踩到了一个坑，如果在微信的商户平台中，开启了自动提现功能，那么会自动将基本账户内的资金全提现至结算银行卡中，隔日到账。这样如果被结算过的订单在被退款时商户平台也没有基本余额，就会报错提示“基本余额不足，请充值后重新发起退款”，所以最好先关闭自动提现，待订单超过退款周期后再对其进行结算，避免发起退款不成功的情况。


文章标签：
密钥管理服务
前端开发
数据安全/隐私保护
API
数据格式
数据库
XML
小程序
关键词：
微信小程序流程
微信流程
码农参上
目录
相关文章
yuanzhengme
|
2月前
|
小程序 前端开发 测试技术
微信小程序的开发完整流程是什么？
微信小程序的开发完整流程是什么？
yuanzhengme
146 7
bruce_xiaowei
|
2月前
|
人工智能 弹性计算 搜索推荐
打造个性化的微信公众号AI小助手：从人设到工作流程
在数字化时代，一个有个性且功能强大的AI小助手能显著提升用户体验。本文档指导如何在微信公众号上设置AI小助手“小智”，涵盖其人设、功能规划及工作流程设计，旨在打造一个既智能又具吸引力的AI伙伴。
bruce_xiaowei
91 0
桃园三章
|
1月前
|
小程序 前端开发 算法
【java】微信小程序登录，后端流程
微信小程序登录
桃园三章
167 1
威哥爱编程
|
1月前
|
Java API 开发者
Java如何实现企业微信审批流程
大家好，我是V哥。本文分享如何在企业微信中实现审批流程，通过调用企业微信的开放API完成。主要内容包括获取Access Token、创建审批模板、发起审批流程和查询审批结果。提供了一个Java示例代码，帮助开发者快速上手。希望对你有帮助，关注V哥爱编程，编码路上同行。
威哥爱编程
94 4
wishCoding
|
6月前
|
JavaScript Java 测试技术
基于springboot+vue.js+uniapp小程序的销售项目流程化管理系统附带文章源码部署视频讲解等
基于springboot+vue.js+uniapp小程序的销售项目流程化管理系统附带文章源码部署视频讲解等
wishCoding
70 3
赣州云智科技的技术铺子
|
2月前
|
机器学习/深度学习 人工智能 小程序
【一步步开发AI运动小程序】三、运动识别处理流程
随着人工智能技术的发展，阿里体育等公司推出的“乐动力”、“天天跳绳”等AI运动APP备受关注。本文将引导您从零开始开发一个AI运动小程序，使用“云智AI运动识别小程序插件”。文章介绍了视频帧、帧率FPS、抽帧和人体识别等基本概念，并详细说明了处理流程，包括抽帧、人体识别检测、骨骼图绘制和运动分析等步骤。下篇将介绍如何在小程序中实现抽帧。
赣州云智科技的技术铺子
53 0
Codelinghu
|
2月前
|
小程序
微信小程序的注册流程
微信小程序的注册流程
Codelinghu
99 0
龙大吉
|
4月前
|
小程序 前端开发 持续交付
小程序全栈开发中的CI/CD流程与自动化部署是一种高效的开发模式。
本文探讨小程序全栈开发中的CI/CD流程与自动化部署，介绍持续集成与部署的概念，包括自动化构建、测试、代码审查及部署实践。通过提高代码质量、迭代速度及团队协作效率，确保小程序稳定运行与良好用户体验。
龙大吉
92 2
如夜了我衣衫太薄便归家靠路灯
|
4月前
|
前端开发 JavaScript API
微信公众号项目，实现微信支付（具体流程和参数）
微信公众号项目，实现微信支付（具体流程和参数）
如夜了我衣衫太薄便归家靠路灯
169 0
开发V|TG_ch3nguang
|
5月前
|
小程序 开发工具 开发者
知识付费教育小程序搭建的流程及技术要点
【知识付费教育小程序】兴起于知识经济时代，旨在提供高质量知识服务。开发涉及定位受众、技术选型（如微信小程序）、功能设计（课程展示、购买、进度跟踪）、内容更新及用户体验优化。推广与运营，包括社交媒体宣传、会员体系构建、积分激励及持续优化，确保用户增长与留存。
开发V|TG_ch3nguang
104 1

热门文章

最新文章

  • 1
    小程序审核常见驳回类型
  • 2
    小程序自定义弹窗禁止底部内容滚动（滚动穿透问题）
  • 3
    小程序云开发联表数据查询以及云函数中的应用
  • 4
    小程序：开发者工具和真机调试能请求后台数据，手机预览请求不到数据，快速解决
  • 5
    【小程序开发框架选型】7大小程序开发框架，哪一个更适合你？
  • 6
    笑联 x mPaaS | 12 个模块，全面小程序化，如何打造真正的一次开发复用多端？
  • 7
    小程序-uniApp：区域滚动、下拉刷新、上拉加载更多
  • 8
    小程序根据返回值是否为空判断标签是否显示
  • 9
    小程序中加载html5地图界面链接
  • 10
    小程序动端组件库Vant Weapp的使用
  • 1
    微信小程序用户登陆和获取用户信息功能实现
    132
  • 2
    uniapp-微信小程序-上拉和下拉触底刷新
    151
  • 3
    微信小程序和springboot实现微信支付
    254
  • 4
    微信小程序-微信支付
    81
  • 5
    微信小程序调试、断点调试
    196
  • 6
    微信小程序-分包
    75
  • 7
    开发uniapp过程中对app、微信小程序与h5的webview调试
    1204
  • 8
    微信小程序echart图片不显示 问题解决
    72
  • 9
    UniApp与微信小程序介绍及区别
    612
  • 10
    微信小程序开发工具的使用，各个配置文件详解，小程序开发快速入门（二）
    589

    • 相关课程

    更多
  • IoT小程序框架课程

    • 相关电子书

    更多
  • 《使用Serverless服务快速开发小程序》
  • 《云市场-小程序》
  • 数字乡村建设方案

    • 相关实验场景

    更多
  • 搭建微信小程序
  • 1分钟SAE部署PHP商城小程序
  • 收银台的场景化界面实践
  • 阿里云IoT小程序应用开发和组件实践
  • 搭建IoT小程序开发环境，创建一个应用
  • EMAS Serverless搭建《私人云相册》小程序
    • 下一篇
    DataWorks