mirror of
https://github.com/bufanyun/hotgo.git
synced 2025-02-03 02:54:41 +08:00
102 lines
2.8 KiB
Markdown
102 lines
2.8 KiB
Markdown
## 支付网关
|
||
|
||
目录
|
||
|
||
- 介绍
|
||
- 一个简单的支付流程
|
||
- 支付配置
|
||
- 创建支付订单
|
||
- 注册支付回调
|
||
- 订单退款
|
||
- 单笔转账（待更新）
|
||
- 其他
|
||
|
||
|
||
### 介绍
|
||
> 在web应用开发中，支付功能可以做为不可或缺的一部分，HotGo提供了相对通用的支付网关，目前已支持支付宝、微信支付、QQ支付，包含创建支付订单、支付回调、订单退款等功能，开发者几乎只需关注订单业务处理即可。
|
||
|
||
#### 一个简单的支付流程
|
||
|
||
```mermaid
|
||
|
||
graph TD
|
||
A(用户下单) --> B(创建订单<br> 创建成功后,将订单支付信息提交到支付网关处理)
|
||
B -->|网关返回失败| H(提示错误)
|
||
B -->|网关返回成功| G(拿到支付链接,用户侧跳转支付页面)
|
||
G -->|支付完成| C(支付平台通知支付网关<br> 支付网关进行验签和效验支付处理状态) -->|验证通过,回调订单业务| E(订单更新状态,发放业务产品)
|
||
G -->|支付取消| D(订单支付超时关闭)
|
||
|
||
|
||
```
|
||
|
||
|
||
### 支付配置
|
||
> 请到 系统设置 -> 配置管理 -> 支付配置 -> 找到你需要的支付方式，进行配置即可
|
||
|
||
|
||
|
||
### 创建支付订单
|
||
|
||
```go
|
||
package main
|
||
|
||
func main() {
|
||
// 创建支付网关订单
|
||
create, err := service.Pay().Create(ctx, payin.PayCreateInp{
|
||
Subject: "充值100元",
|
||
OrderSn: "唯一业务订单编号",
|
||
OrderGroup: "admin_order", // 订单分组，用于订单分类和绑定支付成功的回调方法
|
||
PayType: "wxpay", // 微信支付
|
||
TradeType: "scan", // 二维码扫码
|
||
PayAmount: "100", // 100元
|
||
})
|
||
}
|
||
```
|
||
|
||
|
||
### 注册支付回调
|
||
- 在文件`server/internal/global/pay.go` 加入你的业务订单分组回调方法，当订单支付成功验签通过后会自动进行回调，参考以下：
|
||
|
||
```go
|
||
package global
|
||
|
||
import (
|
||
"hotgo/internal/consts"
|
||
"hotgo/internal/library/payment"
|
||
"hotgo/internal/service"
|
||
)
|
||
|
||
// 注册支付成功回调方法
|
||
func payNotifyCall() {
|
||
payment.RegisterNotifyCall(consts.OrderGroupAdminOrder, service.AdminOrder().PayNotify) // 后台充值订单
|
||
// ...
|
||
}
|
||
|
||
```
|
||
|
||
### 订单退款
|
||
|
||
|
||
```go
|
||
package main
|
||
|
||
func main() {
|
||
refund, err := service.PayRefund().Refund(ctx, payin.PayRefundInp{
|
||
OrderSn: "唯一业务订单编号",
|
||
RefundMoney: "退款金额",
|
||
Reason: "买家申请退款原因",
|
||
Remark: "商家同意退款备注",
|
||
})
|
||
}
|
||
```
|
||
|
||
|
||
### 单笔转账（待更新）
|
||
|
||
|
||
|
||
### 其他
|
||
- 由于各个支付平台中交易方式较多，如果目前已有的交易方式不满足你的支付场景需求，请自行参考gopay文档对文件`server/internal/library/payment/payment.go`中的`PayClient`接口实现进行扩展
|
||
- gopay文档地址：https://github.com/go-pay/gopay
|
||
|