开发指南
支付手册

支付宝支付接入

# 0. 概述

在 yudao-module-pay-biz 模块的 demo (opens new window) 模块，我们提供了一个支付接入的示例。

它支持如下支付渠道：

疑问：为什么不支持微信小程序、公众号支付？

因为这 2 种微信支付方式，只能在微信环境中进行，而我们的接入示例使用 PC 浏览器，所以无法进行。

你可以阅读微信小程序支付接入和微信公众号支付接入文档，进行相关的支付接入。

下面，我们以 demo 模块为例子，讲解如何接入支付宝的电脑网站 (opens new window) 支付。

# 1. 第一步，配置支付渠道

① 在 [支付管理 -> 应用信息] 菜单，新建 demo 模块使用的支付应用。如下图所示：

应用信息

支付结果的回调地址：对应「2.4 第四步，实现回调接口」实现的接口。这里因为我们在本地演示，所以使用了 127.0.0.1 IP 地址，如果你部署到服务器上，要设置服务器可调用到的 IP 地址。

因为 demo 模块的支付应用默认已经创建，所以你可以直接使用。注意，这里的应用编号 “7” 稍后会使用到。

疑问：为什么应用上有回调地址，然后 `application.yaml` 配置文件中也有 `yudao.pay.order-notify-url` 回调地址呢？

请详细阅读《支付手册 —— 功能开启》的「3.5 支付回调【重要】」小节。

简单来说：

配置文件的回调地址，是外部的支付渠道（支付宝、微信）回调 pay 支付模块（支付中心）的地址。
应用的回调地址，是 pay 回调内部的各个 biz 模块（支付应用）的地址。例如收：trade 商城的订单、wallet 钱包的充值。

因为内部会有多个业务模块，所以它们每个都有自己的回调地址，就是配置到对应的支付应用上！

② 点击“示例用户”对应的【支付宝 PC 网站支付】，进入支付渠道的配置。如下图所示：

支付渠道

如果你还没有支付宝开放平台的账号，可以先参考《沙箱环境》 (opens new window) 文档，申请一个测试账号，我目前就是这么测试的。只需要阅读该文档的如下小节即可：

支付渠道

友情提示：

沙箱环境

最终在沙箱应用 (opens new window) 可以看到支付渠道的配置。

# 2. 第二步，实现支付调用【重要】

友情提示：由于 demo 模块的支付接入已经实现，这里你只要看懂什么意思即可，不用操作。

① 【后端】在 demo 模块所在的 yudao-module-xx-biz 模块的 pom.xml 文件，引入 yudao-module-pay-api 依赖，这样才可以调用到 PayOrderApi 接口。代码如下：

    <dependency>
        <groupId>cn.iocoder.cloud</groupId>
        <artifactId>yudao-module-pay-api</artifactId>
        <version>${revision}</version>
    </dependency>

② 【后端】在 demo 模块的下单逻辑中，需要调用 PayOrderApi 的 #createOrder(...) (opens new window) 方法，创建支付单。如下图所示：

调用 PayOrderApi

疑问：为什么 demo 模块在下单逻辑中，需要调用 PayOrderApi 接口来创建支付单？

因为跳转公用的【收银台】，需要通过读取支付订单，展示支付信息。这样，才能和 demo 模块进行解耦。收银台如下图所示：

收银台

③ 【前端】在 demo 模块下完单之后，前端需要跳转到【收银台】。前端接入代码在 /views/pay/demo/index.vue (opens new window)，如下图所示：

前端接入代码

this.$router.push({
  name: 'PayCashier',
  query:{
    id: row.payOrderId, // 支付单号
    returnUrl: encodeURIComponent('/pay/demo-order?id=' + row.id) // 支付成功后，跳转的 URL
  }
})

另外，收银台的前端代码，在 /views/pay/cashier/index.vue (opens new window) 里，已经实现，感兴趣可以看看。

# 3. 第三步，实现回调接口【重要】

友情提示：由于 demo 模块的支付接入已经实现，这里你只要看懂什么意思即可，不用操作。

在 demo 模块所在的 yudao-module-xx-biz 模块，实现一个支付回调的接口，提供给支付【中心】回调。对应的代码在 PayDemoOrderController 的 #updateDemoOrderPaid(...) (opens new window) 方法中，如下图所示：

实现回调接口