支付宝支付接入

0. 概述

在 yudao-module-pay 模块的 demo 模块，我们提供了一个支付接入的示例（PayNotifyController）。

它支持如下支付渠道：

支付宝电脑网站支付
支付宝手机网站支付
支付宝当面付（条码支付）
支付宝扫码支付
微信付款码支付
微信 Native 支付

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

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

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

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

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 网站支付】，进入支付渠道的配置。如下图所示：

支付渠道

友情提示：

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

沙箱环境

最终在沙箱应用可以看到支付渠道的配置。

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

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

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

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

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

图片纠错：最新版本不区分 yudao-module-pay-api 和 yudao-module-pay-biz 子模块，代码直接合并到 yudao-module-pay 模块的 src 目录下，更适合单体项目

调用 PayOrderApi

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

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

收银台

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

前端接入代码

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