支付宝、微信退款接入

## 0. 概述
在 dtpc-module-pay-biz 模块的 demo 模块，我们提供了一个 退款 接入的示例，它已支持支付宝、微信的所有退款方式。

下面，我们以 demo 模块为例子，讲解如何接入退款。

## 1. 第一步，创建支付订单
① 如果你是看支付宝退款接入，则需要先看完 《支付宝支付接入》 文档
② 如果你是看微信退款接入，则需要先看完 《微信小程序支付接入》 或 《微信公众号支付接入》 文档

③ 然后，我们在 [支付管理 -> 接入示例 -> 支付&退款案例] 菜单，可以看到一个可以“发起退款”的订单。如下图所示：

![](/media/202408/2024-08-28_113058_395797.png)
## 2. 第二步，实现退款调用【重要】
① 【后端】在 demo 模块代码如下：

> <span style="font-family:楷体">    <dependency>
        <groupId>cn.iocoder.cloud</groupId>
        <artifactId>yudao-module-pay-api</artifactId>
        <version>${revision}</version>
    </dependency>
</span>

![](/media/202408/2024-08-28_113351_636559.png)
② 【后端】在 demo 模块的下单逻辑中，需要调用 PayRefundApi 的 #createRefund(...) (opens new window)方法，创建退款单。如下图所示：

![](/media/202408/2024-08-28_113407_612133.png)

## 3. 第三步，实现回调接口【重要】
在 demo 模块所在的 dtpc-module-xx-biz 模块，实现一个支付回调的接口，提供给支付【中心】回调。对应的代码在 PayDemoOrderController 的 #updateDemoOrderRefunded(...) 方法中，如下图所示：

![](/media/202408/2024-08-28_113432_552184.png)
## 4. 第四步，退款功能测试
至此，我们已经完成了退款接入的所有步骤，接下来，我们来测试一下退款功能。
① 点击“发起退款”按钮，发起刚支付订单的退款流程。

![](/media/202408/2024-08-28_113509_057405.png)
此时，在 pay_refund 表中，会新增一条退款订单记录。
② 退款成功后，先是支付【中心】的回调接口被回调，然后是 demo 模块的回调接口被回调。如下图所示：

![](/media/202408/2024-08-28_113522_150146.png)
> <span style="font-family:楷体">注意
支付宝发起退款时，它是直接返回退款成功，所以它没有支付【中心】 PayNotifyController 的异步回调，只有 demo 模块的回调接口被回调。
微信发起退款时，它是可能返回退款成功，也可能返回退款处理中。微信退款是有支付【中心】 PayNotifyController 的异步回调，也有 demo 模块的回调接口被回调。
</span>