GolangPay 聚合支付系统

系统概述

GolangPay 是一套基于 Go 语言开发的聚合支付系统（四方支付平台），采用 Golang + Beego + Vue 微服务架构，覆盖从支付网关、运营管理、代理分销到商户接入的全链路业务。

系统封装了微信支付、支付宝、云闪付、快捷支付、代付等 60+ 支付通道，支持"一码付"动态路由，并提供实时分账、动态风控、自动对账与结算等金融级能力。编译后单文件可执行，源码完全开放，适合有技术团队的企业直接运营或二次开发。

核心优势

适用场景

技术支持

购买后针对每个客户单独创建群，至少指定一名技术支持人员提供售后服务：

• 系统部署指导
• 二次开发指导
• 反馈 Bug 的修复
• 需求的收集

架构设计

GolangPay 采用微服务模块化设计，各服务独立部署、通过 Dubbo 接口通信。整体分为接入层、业务层、核心层和数据层四个层次。

整体架构图

┌─────────────────────────────────────────────────────┐
│                    负载均衡 (Nginx)                   │
│              SSL 终结 / 域名路由 / 限流               │
├─────────┬──────────┬──────────┬──────────┬───────────┤
│  运营平台  │  商户系统  │  代理系统  │  核销系统  │  支付网关   │
│ (manage) │(merchant)│ (agent)  │          │   (pay)    │
│  :12306  │  :12306  │  :12304  │          │  :12309    │
├─────────┴──────────┴──────────┴──────────┴───────────┤
│              golangpay-service (核心业务)               │
│         订单 / 通道 / 商户 / 风控 / 结算 业务逻辑        │
├───────────────────────────────────────────────────────┤
│        golangpay-core (公共实体 / Dubbo 接口 / 工具)    │
├───────────────────────────────────────────────────────┤
│           golangpay-task (对账 / 结算 / 风控) :12310   │
├───────────────────────────────────────────────────────┤
│   MySQL   │   Redis   │  RabbitMQ / Kafka  │  KMS    │
└───────────────────────────────────────────────────────┘

分层说明

技术栈

设计原则

模块说明

GolangPay 由 8 个模块组成，其中 4 个为公共库（编译时引用），4 个为运行态服务（独立部署），另有 1 个定时任务服务。

模块总览

模块详解

golangpay（公共库）

项目根模块，定义所有公共实体（如 Order、Merchant、Channel）、工具方法（签名、加密、序列化）和 Dubbo 服务接口。其他模块通过 import 引用，一条 import 即可被所有服务复用。

golangpay-core（核心包）

包含 Dubbo 服务接口定义、实体 Bean 以及公共引用和常用工具类。是模块间通信的契约层，接口变更需同步所有消费方。

golangpay-service（业务层）

封装所有核心业务方法：订单处理、通道路由、商户管理、风控评估、结算逻辑等。供 manage、merchant、agent、pay 等模块引用调用，避免业务逻辑散落各处。

golangpay-z-api-base（支付基础包）

支付接口的基础包，封装与第三方通道交互的公共逻辑：HTTP 客户端、签名/验签、证书加载、超时重试等。新增通道时继承此包实现统一接口即可。

golangpay-pay（支付网关）

系统核心模块，提供商户访问的支付接口，并对接所有支付通道实现。封装微信、支付宝、云闪付、快捷、代付等 60+ 通道，支持"一码付"动态路由。

golangpay-manage（运营平台）

前后端分离架构，提供全局数据看板、商户/代理管理、通道配置、费率设置、系统参数等功能。Vue3 前端 + Go 后端 API。

golangpay-merchant（商户系统）

商户自助管理平台，支持订单查询、交易统计、API 密钥管理、通道配置、结算查询等功能。

golangpay-agent（代理商系统）

多级代理体系管理，支持独立登录、下级商户管理、佣金结算、通道分配等功能。

golangpay-task（定时任务）

单节点部署的定时任务服务，负责自动对账（勾兑通道对账单）、结算跑批（T0/T1/D1 打款）、风控评分等。包含 Telegram 机器人告警通知。

支付流程

一次完整的支付请求从用户下单到最终到账，经历以下核心步骤：

详细流程说明

1. 用户下单 — 用户在商户侧选择商品并发起支付请求。
2. 商户系统请求网关 — 商户后端调用 GolangPay 支付网关 API（/api/pay/unified_order），传入订单号、金额、支付方式等参数。
3. 支付网关接收 — golangpay-pay 统一接收请求，进行参数校验和签名验证。
4. 风控校验 — 下单即触发 200+ 条风控规则（IP、设备指纹、频次、黑名单），3ms 内返回决策；异常订单自动冻结并推送告警。
5. 通道路由 — 根据支付方式、通道权重、费率、可用性动态选择最优支付通道。
6. 第三方通道扣款 — 请求微信/支付宝/云闪付等第三方支付通道完成扣款。
7. 异步回调通知 — 第三方通道通过 notify_url 回调支付结果，网关验签后更新订单状态。
8. 订单完成 — 商户通过回调或主动查询确认支付结果，完成业务闭环。

时序图

用户        商户后端       支付网关       风控引擎      第三方通道
 │            │              │             │             │
 │──下单──→   │              │             │             │
 │            │──统一下单──→ │             │             │
 │            │              │──风控评估──→│             │
 │            │              │←──通过/拒绝─│             │
 │            │              │──通道请求──────────────→│
 │            │              │             │             │
 │←──支付页面──────────────────────────────────────────│
 │──完成支付──────────────────────────────────────→│
 │            │              │←──异步回调──────────────│
 │            │              │──验签+更新订单           │
 │            │←──回调通知── │             │             │
 │            │──返回success─│             │             │
 │←──业务结果─│              │             │             │

回调通知机制

支付完成后，网关向商户 notify_url 发送 POST 请求，包含签名信息。商户需：

1. 验证签名有效性（防篡改）
2. 校验订单金额一致性
3. 处理业务逻辑（发货、充值等）
4. 返回字符串 success 确认接收

退款流程

支持部分退款和全额退款，退款资金原路返回至用户支付账户。

代付流程

支持手动/自动打款、批量代付、失败自动重试。结算周期 T0/T1/D1 自由配置。

功能清单

5.1 支付能力

5.2 资金与结算

5.3 运营管理

5.4 风控系统

5.5 系统运维

部署指南

6.1 环境要求

6.2 编译与打包

# 克隆项目
git clone https://github.com/bellonigloria513-hub/gaolangpay
cd golangpay

# 下载依赖
go mod download

# 编译各模块（Linux 环境）
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o golangpay-manage  ./golangpay-manage/
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o golangpay-merchant ./golangpay-merchant/
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o golangpay-agent   ./golangpay-agent/
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o golangpay-pay     ./golangpay-pay/
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o golangpay-task    ./golangpay-task/

# 验证编译结果
ls -la golangpay-*

6.3 配置文件

各模块通过 app.conf（Beego 默认配置文件）管理数据库连接、Redis 地址、服务端口等。

# app.conf 示例 (golangpay-pay)
appname = golangpay-pay
httpport = 12309
runmode = prod

# MySQL 配置
db.host = 127.0.0.1
db.port = 3306
db.user = root
db.password = your_password
db.name = golangpay

# Redis 配置
redis.host = 127.0.0.1:6379
redis.password =
redis.db = 0

# Dubbo 配置
dubbo.registry = zookeeper://127.0.0.1:2181

# 日志
log.level = info
log.path = /var/log/golangpay/pay.log

6.4 数据库初始化

# 创建数据库
mysql -u root -p -e "CREATE DATABASE golangpay DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_unicode_ci;"

# 导入初始化脚本（项目提供）
mysql -u root -p golangpay < sql/golangpay_init.sql

# 验证表结构
mysql -u root -p golangpay -e "SHOW TABLES;"

6.5 启动服务

# 按顺序启动各服务（后台运行）
nohup ./golangpay-pay > /var/log/golangpay/pay.log 2>&1 &
nohup ./golangpay-manage > /var/log/golangpay/manage.log 2>&1 &
nohup ./golangpay-merchant > /var/log/golangpay/merchant.log 2>&1 &
nohup ./golangpay-agent > /var/log/golangpay/agent.log 2>&1 &
nohup ./golangpay-task > /var/log/golangpay/task.log 2>&1 &

# 检查服务状态
ps aux | grep golangpay
netstat -tlnp | grep -E "1230[4-9]|12310"

6.6 Nginx 反向代理配置

# /etc/nginx/conf.d/golangpay.conf
upstream pay_gateway {
    server 127.0.0.1:12309;
    # 多实例扩容
    # server 127.0.0.1:12319;
}
upstream manage {
    server 127.0.0.1:12306;
}
upstream merchant {
    server 127.0.0.1:12306;
}
upstream agent {
    server 127.0.0.1:12304;
}

server {
    listen 80;
    server_name pay.yourdomain.com;

    # 支付网关
    location /api/pay/ {
        proxy_pass http://pay_gateway/;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }

    # 运营平台
    location /manage/ {
        proxy_pass http://manage/;
    }

    # 商户系统
    location /merchant/ {
        proxy_pass http://merchant/;
    }

    # 代理商系统
    location /agent/ {
        proxy_pass http://agent/;
    }
}

6.7 Docker 部署（推荐）

# 各模块 Dockerfile 示例
FROM golang:1.21-alpine AS builder
WORKDIR /app
COPY . .
RUN go mod download
RUN CGO_ENABLED=0 go build -o golangpay-pay ./golangpay-pay/

FROM alpine:latest
RUN apk add --no-cache ca-certificates tzdata
ENV TZ=Asia/Shanghai
COPY --from=builder /app/golangpay-pay /app/
COPY --from=builder /app/golangpay-pay/conf /app/conf
EXPOSE 12309
CMD ["/app/golangpay-pay"]

# docker-compose.yml 示例
version: '3.8'
services:
  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: your_password
      MYSQL_DATABASE: golangpay
    volumes:
      - mysql_data:/var/lib/mysql

  redis:
    image: redis:7-alpine
    volumes:
      - redis_data:/data

  pay:
    build: .
    ports:
      - "12309:12309"
    depends_on:
      - mysql
      - redis

  task:
    build: .
    ports:
      - "12310:12310"
    depends_on:
      - mysql
      - redis

volumes:
  mysql_data:
  redis_data:

6.8 部署检查清单

接口接入教程

7.1 接入前准备

1. 在运营平台创建商户，获取 merchant_id 和 api_key
2. 配置支付通道（微信/支付宝等）的商户参数
3. 设置异步回调地址 notify_url（必须公网可访问）
4. 根据业务需求选择支付方式（扫码/H5/JSAPI/APP 等）
5. 准备签名工具（MD5 或 RSA2）

7.2 签名规则

所有 API 请求均需签名验证，确保数据传输安全：

1. 将所有非空请求参数按参数名 ASCII 升序排列
2. 拼接为 key1=value1&key2=value2&key=api_key 格式
3. 对拼接字符串做 MD5 或 RSA2 签名
4. 将签名结果放入 sign 参数

MD5 签名示例（Go）

package main

import (
    "crypto/md5"
    "encoding/hex"
    "fmt"
    "sort"
    "strings"
)

func SignMD5(params map[string]string, apiKey string) string {
    // 1. 按 key 升序排列
    keys := make([]string, 0, len(params))
    for k := range params {
        if params[k] != "" && k != "sign" {
            keys = append(keys, k)
        }
    }
    sort.Strings(keys)

    // 2. 拼接键值对
    pairs := make([]string, 0, len(keys))
    for _, k := range keys {
        pairs = append(pairs, fmt.Sprintf("%s=%s", k, params[k]))
    }
    signStr := strings.Join(pairs, "&") + "&key=" + apiKey

    // 3. MD5 签名
    h := md5.Sum([]byte(signStr))
    return hex.EncodeToString(h[:])
}

7.3 统一下单接口

# POST /api/pay/unified_order
{
    "merchant_id": "M100001",
    "out_trade_no": "ORDER20260612001",
    "total_fee": 100,
    "body": "商品描述",
    "pay_type": "wechat_scan",
    "notify_url": "https://yourdomain.com/callback",
    "spbill_create_ip": "127.0.0.1",
    "nonce_str": "a1b2c3d4e5f6",
    "sign": "MD5签名结果"
}

请求参数说明

响应示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "order_id": "GP2026061200001",
        "pay_url": "https://pay.example.com/qrcode/xxx",
        "qr_code": "weixin://wxpay/bizpayurl?pr=xxx"
    }
}

7.4 订单查询接口

# POST /api/pay/query_order
{
    "merchant_id": "M100001",
    "out_trade_no": "ORDER20260612001",
    "nonce_str": "a1b2c3d4e5f6",
    "sign": "MD5签名结果"
}

响应示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "order_id": "GP2026061200001",
        "out_trade_no": "ORDER20260612001",
        "trade_no": "第三方流水号",
        "total_fee": 100,
        "status": 1,
        "pay_time": "2026-06-12 15:30:00"
    }
}

7.5 退款接口

# POST /api/pay/refund
{
    "merchant_id": "M100001",
    "out_trade_no": "ORDER20260612001",
    "out_refund_no": "REFUND20260612001",
    "total_fee": 100,
    "refund_fee": 50,
    "refund_reason": "用户申请退款",
    "notify_url": "https://yourdomain.com/refund_callback",
    "nonce_str": "a1b2c3d4e5f6",
    "sign": "MD5签名结果"
}

7.6 异步回调通知

支付完成后，网关向商户 notify_url 发送 POST 请求：

{
    "merchant_id": "M100001",
    "out_trade_no": "ORDER20260612001",
    "order_id": "GP2026061200001",
    "trade_no": "第三方流水号",
    "total_fee": 100,
    "status": 1,
    "pay_time": "2026-06-12 15:30:00",
    "sign": "MD5签名结果"
}

回调处理要点

1. 验签：对除 sign 外所有参数按签名规则重新计算，比对 sign 是否一致
2. 金额校验：核对回调金额与原订单金额是否一致
3. 幂等处理：同一订单可能收到多次回调，需做幂等判断
4. 响应确认：处理完成后返回字符串 success

7.7 Go SDK 快速接入（go-pay/gopay）

如果只需 SDK 级别的支付通道集成（无需完整四方平台），可使用开源的 go-pay/gopay 库：

// 安装
go get github.com/go-pay/gopay

// 微信支付 V3 初始化
import (
    "github.com/go-pay/gopay"
    "github.com/go-pay/gopay/wechat/v3"
    "github.com/go-pay/xlog"
)

func main() {
    // 查看版本
    xlog.Info("GoPay Version: ", gopay.Version)

    // 初始化微信 V3 客户端
    client, err := wechat.NewClientV3("apiKey")
    if err != nil {
        panic(err)
    }
    client.SetPlatformCert()

    // 初始化支付宝 V3 客户端
    // aliClient, err := alipay.NewClientV3("appId", "privateKey", false)
}

7.8 新增支付通道

基于 GolangPay 的统一接口设计，新增通道只需 4 步：

1. 在 golangpay-pay 下创建新通道实现文件
2. 实现统一支付接口（下单、查询、退款、回调验签）
3. 在通道路由表中注册新通道
4. 在运营平台配置通道参数和费率

据官方文档，熟练开发者约 30 分钟可完成一个新通道的对接。

安全与风控

支付系统的安全是底线。GolangPay 从传输安全、代码安全、风控引擎和合规四个维度构建金融级安全体系。

8.1 传输安全

8.2 代码安全

Go 编译型语言天然具备安全优势，对比 PHP 解释型语言：

并发安全原语

8.3 实时风控引擎

GolangPay 内置 200+ 风控规则引擎，下单即触发评估，3ms 内返回决策：

风控维度

风控响应

• 通过 — 正常放行，进入通道路由
• 告警 — 放行但标记，推送 Telegram 群通知
• 冻结 — 订单自动冻结，需人工审核
• 拒绝 — 直接拒绝交易，返回失败

8.4 安全案例复盘

8.5 合规保障

性能与并发

GolangPay 充分发挥 Go 语言的并发优势，在同等硬件条件下性能碾压 PHP 同类系统。

9.1 性能基准数据

以下数据来自 2025 年压力测试报告（8C16G 容器环境）：

9.2 并发模型：goroutine + channel（CSP）

GolangPay 采用 Go 语言原生的 CSP 并发模型，以 goroutine 为轻量级执行单元，channel 为通信管道，三大核心 channel 解耦业务流：

┌──────────────┐
│  HTTP 请求    │
└──────┬───────┘
       ▼
┌──────────────┐    // epoll + 自定义时间轮
│  网关层接收    │──→ 1ms 级超时熔断
└──────┬───────┘    30s 内通道自动降级
       ▼
┌──────────────┐
│  goroutine   │──→ 单机 50 万协程轻松拉起
└──────┬───────┘    内存占用仅为 Java 线程 1/20
       ▼
┌──────────────────────────────────────┐
│  三大 channel 解耦（CSP 模型）         │
│                                       │
│  ┌─────────────┐                     │
│  │ 订单队列 ch  │──→ 下单/查询/退款    │
│  └─────────────┘                     │
│  ┌─────────────┐                     │
│  │ 通知队列 ch  │──→ 回调/告警/推送    │
│  └─────────────┘                     │
│  ┌─────────────┐                     │
│  │ 风控事件 ch  │──→ 规则评估/冻结     │
│  └─────────────┘                     │
└──────────────────────────────────────┘

CSP vs 共享内存

9.3 网络层优化

9.4 云原生优势

9.5 性能调优建议

常见问题

💬 系统相关

Q: GolangPay 支持哪些支付通道？

支持微信支付、支付宝、云闪付、快捷支付、代付等 60+ 通道，支持"一码付"动态路由。具体通道列表可在运营平台通道管理页面查看。

Q: 如何获取源码？

GolangPay 为商业版系统，需通过官方购买获取完整源码。购买后获得所有 Go 服务端源码和 Layui 前端源码，可二次开发。详见 官方购买页面。

Q: 开源版 go-pay/gopay 和 GolangPay 是什么关系？

两者是独立项目。go-pay/gopay 是开源的 Go 语言支付 SDK（Apache-2.0 协议），提供微信/支付宝等支付通道的 API 封装；GolangPay 是商业版聚合支付系统（四方平台），提供完整的运营、商户、代理、风控、结算等业务能力。

Q: 系统支持多级代理吗？

支持。代理商系统独立部署，支持多级代理体系和佣金结算，权限粒度到按钮级。

💬 部署相关

Q: golangpay-task 为什么必须单节点部署？

task 模块负责对账和结算等定时任务，多实例会重复执行导致数据错误（如重复打款）。建议通过分布式锁或指定单节点调度保证唯一执行。

Q: 部署最低硬件要求是多少？

最低配置：4C8G 云主机即可运行全部服务。生产环境建议支付网关 8C16G 并部署多实例，其他服务 4C8G 即可。task 服务 2C4G 足够。

Q: 能否只用 Docker Compose 一键部署？

可以。项目提供 docker-compose.yml 模板，包含 MySQL、Redis 和各微服务容器的编排。适合开发和小规模生产环境。

💬 接入相关

Q: 回调通知没收到怎么办？

1. 检查 notify_url 是否可从公网访问（用手机 4G 网络测试）
2. 确认商户端处理完成后返回了字符串 success
3. 检查防火墙/安全组是否放行网关 IP
4. 确认 notify_url 使用 HTTP POST 接收，非 GET
5. 可在商户系统手动触发重发通知

Q: 签名验证失败怎么排查？

1. 确认参与签名的参数不包含 sign 字段本身
2. 检查空值参数是否被排除（空值不参与签名）
3. 确认参数按 ASCII 升序排列
4. 检查 API Key 是否正确（正式/沙箱环境区分）
5. 确认编码为 UTF-8

Q: 如何新增一个支付通道？

在 golangpay-pay 模块下创建新通道实现文件，实现统一接口（下单、查询、退款、回调验签），然后在通道路由表中注册，在运营平台配置参数和费率即可。约 30 分钟完成对接。

Q: JSAPI 支付需要什么额外参数？

JSAPI（微信公众号/小程序）支付必须传 openid 参数。获取方式：

1. 通过微信 OAuth2 授权接口获取用户 openid
2. 小程序端通过 wx.login() 获取 code，后端换取 openid

💬 风控相关

Q: 订单被风控冻结了怎么办？

被冻结的订单会自动推送 Telegram 群告警，运营人员可在运营平台查看冻结原因，审核后可手动解冻或拒绝。

Q: 如何调整风控规则？

在运营平台 → 风控管理中可配置规则阈值、黑白名单、频次限制等。支持按商户、通道、支付方式单独配置。

Q: 如何防止重复出款？

GolangPay 内置三重保障：

1. singleflight — 同一订单号并发请求自动合并
2. 分布式锁 — 跨实例互斥，防止多节点重复处理
3. 数据库唯一约束 — 订单号唯一索引，最终兜底

💬 结算相关

Q: 对账出现差错单怎么处理？

系统自动对账会标记差错单（长款/短款），运营人员可在运营平台查看并手动处理：

• 长款（平台多收）— 可发起退款
• 短款（平台少收）— 需核实后补收或核销

Q: T0 结算如何保证资金安全？

T0 结算需配置二级审核流程：系统自动初审 → 运营人工复核 → 自动打款。大额打款需二次确认。

💬 其他

Q: 技术支持包含哪些内容？

• 系统部署指导
• 二次开发指导
• 反馈 Bug 的修复
• 需求的收集

Q: 遇到问题如何联系官方？

购买后会分配专属技术支持群。也可通过以下渠道：

• 官方文档：http://1.tangguopay.com
• GitHub：https://github.com/bellonigloria513-hub/gaolangpay