# 客易到JAVA聚合支付

**Repository Path**: dalielie/java-aggregation-payment

## Basic Information

- **Project Name**: 客易到JAVA聚合支付
- **Description**: 此java聚合集成微信支付和支付宝支付，支持所有端支付
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: https://www.keyidao.com
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2024-11-24
- **Last Updated**: 2026-04-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

# 💳 Java聚合支付集成

> **一行代码接入微信支付 + 支付宝 | 全端覆盖 · 开箱即用**

[![Gitee Stars](https://gitee.com/dalielie/java-aggregation-payment/badge/star.svg?theme=dark)](https://gitee.com/dalielie/java-aggregation-payment)
[![Gitee Fork](https://gitee.com/dalielie/java-aggregation-payment/badge/fork.svg?theme=dark)](https://gitee.com/dalielie/java-aggregation-payment)
[![JDK](https://img.shields.io/badge/JDK-8%2B-orange)](https://www.oracle.com/java/)
[![Spring Boot](https://img.shields.io/badge/Spring%20Boot-2.x-brightgreen)](https://spring.io/projects/spring-boot)
[![License](https://img.shields.io/badge/License-Apache%202.0-blue)](https://opensource.org/licenses/Apache-2.0)

**✨ 开源不易，如果对您有帮助请点 Star ⭐ 支持一下！**

</div>

---

## 📋 目录

- [项目简介](#-项目简介)
- [适用场景](#-适用场景)
- [技术栈](#-技术栈)
- [支持能力一览](#-支持能力一览)
- [快速接入](#-快速接入)
- [配置说明](#-配置说明)
- [开源 vs 商业服务](#-开源-vs-商业服务)
- [常见问题](#-常见问题)
- [联系方式](#-联系方式)

---

## 🎯 项目简介

**Java聚合支付** 是一个基于 Spring Boot 的轻量级支付集成组件，**同时封装了微信支付和支付宝**，覆盖 **PC网页、H5、小程序、APP** 全部主流支付场景。

开发者只需引入一个依赖、配置一次密钥，即可在项目中快速接入完整的支付能力，无需重复对接两个支付平台的各端接口。

### 📦 核心原则

```
一个项目  →  双渠道(微信+支付宝)  →  8种支付场景  →  统一调用
```

---

## 🏪 适用场景

| 场景 | 说明 | 推荐接入方式 |
|------|------|------------|
| 🖥 **PC网站** | 用户在浏览器下单 | 扫码支付 |
| 📱 **H5网页** | 手机浏览器/公众号内支付 | JSAPI/H5调起 |
| 📲 **小程序** | 微信/支付宝小程序内支付 | 小程序调起支付 |
| 📍 **门店自助** | 线下扫码枪/自助机 | 展示二维码，客户扫码 |
| 📱 **iOS APP** | 苹果手机应用内支付 | APP调起支付 |
| 🤖 **Android APP** | 安卓应用内支付 | APP调起支付 |

---

## 🛠 技术栈

```
Java 8+ · Spring Boot 2.x · MyBatis · Maven
├─ 微信支付 V3 官方API
├─ 支付宝 官方API
└─ MySQL (用于存储支付记录)
```

---

## ✅ 支持能力一览

### 💳 微信支付

| 序号 | 能力 | 场景 | 状态 |
|------|------|------|------|
| 1 | PC扫码支付 | PC网站 | ✅ 支持 |
| 2 | 小程序调起支付 | 微信小程序 | ✅ 支持 |
| 3 | H5调起支付 | 手机浏览器 | ✅ 支持 |
| 4 | H5展示二维码扫码支付 | 门店自助收款 | ✅ 支持 |
| 5 | iOS APP调起支付 | 苹果APP | ✅ 支持 |
| 6 | iOS APP展示二维码 | 门店自助收款(iOS) | ✅ 支持 |
| 7 | Android APP调起支付 | 安卓APP | ✅ 支持 |
| 8 | Android APP展示二维码 | 门店自助收款(安卓) | ✅ 支持 |

### 💳 支付宝支付

| 序号 | 能力 | 场景 | 状态 |
|------|------|------|------|
| 1 | PC扫码支付 | PC网站 | ✅ 支持 |
| 2 | 小程序调起支付 | 支付宝小程序 | ✅ 支持 |
| 3 | H5调起支付 | 手机浏览器 | ✅ 支持 |
| 4 | H5展示二维码扫码支付 | 门店自助收款 | ✅ 支持 |
| 5 | iOS APP调起支付 | 苹果APP | ✅ 支持 |
| 6 | iOS APP展示二维码 | 门店自助收款(iOS) | ✅ 支持 |
| 7 | Android APP调起支付 | 安卓APP | ✅ 支持 |
| 8 | Android APP展示二维码 | 门店自助收款(安卓) | ✅ 支持 |

> 📌 **覆盖能力**：2个支付渠道 × 8种场景 × 2种模式(调起+扫码) = **32种支付组合**，满足几乎所有的国内支付需求。

---

## 🚀 快速接入

### 环境要求

```
- JDK 8+
- Maven 3.6+
- MySQL 5.7+
- 已申请微信支付商户号
- 已申请支付宝商户号
```

### 集成步骤

```bash
# 1. 克隆项目
git clone https://gitee.com/dalielie/java-aggregation-payment.git

# 2. 导入数据库
mysql -u root -p < sql/init.sql

# 3. 修改配置
# 编辑 src/main/resources/application.yml
```

### 配置示例

```yaml
# application.yml
wx:
  pay:
    app-id: your_app_id
    mch-id: your_mch_id
    api-key: your_api_key
    cert-path: /path/to/cert.p12

alipay:
  app-id: your_alipay_app_id
  private-key: your_private_key
  alipay-public-key: alipay_public_key
```

### 核心调用

```java
// 微信支付 - 一行代码发起支付
PaymentResult result = wxPayService.createOrder(
    OrderPayRequest.builder()
        .orderNo("ORDER20260425001")
        .amount(0.01)      // 金额(元)
        .openId("用户OpenID")
        .tradeType("JSAPI") // JSAPI/APP/H5/NATIVE
        .build()
);

// 支付宝支付 - 一行代码发起支付
AlipayResult aliResult = aliPayService.createOrder(
    AlipayOrderRequest.builder()
        .orderNo("ORDER20260425001")
        .amount(0.01)
        .subject("商品名称")
        .build()
);
```

---

## 🔧 配置说明

### 微信支付需要配置

- ✅ 微信商户号（mch_id）
- ✅ 小程序/公众号 AppID
- ✅ API V3 密钥
- ✅ 商户证书（p12 或 pem）
- ✅ 回调通知URL配置

### 支付宝需要配置

- ✅ 支付宝 AppID
- ✅ 应用私钥
- ✅ 支付宝公钥
- ✅ 回调通知URL配置

---

## 💎 开源 vs 商业服务

> ⚡ **开源版可直接集成使用。但如果您的项目有上线时间要求、或者不想在生产调试上花时间，商业服务帮您1天搞定。**

| 对比项 | 🆓 开源版 | 💼 商业基础服务 | 👑 企业级服务 |
|--------|:---------:|:--------------:|:------------:|
| **适合谁？** | 个人开发者、学习研究 | 创业团队、中小企业 | 大型项目、系统集成商 |
| **核心源码** | ✅ 完整可用 | ✅ 完整 + 使用建议 | ✅ 完整 + 代码评审 |
| **微信/支付宝支付** | ✅ 8种支付场景全支持 | ✅ 全支持 | ✅ 全支持 + 其他渠道 |
| **生产验证** | ⚠️ 需自行测试 | ✅ 已在生产环境验证 | ✅ 高并发压测验证 |
| **接入指导** | ❌ 自行看代码 | ✅ 一对一远程指导（1小时上线） | ✅ 全程陪跑至上线 |
| **问题排查** | ❌ 自行调试 | ✅ 7×12小时技术支持 | ✅ 电话+即时通讯+紧急通道 |
| **回调异常处理** | ❌ 自行处理 | ✅ 经验方案+协助排查 | ✅ 代排查+调优 |
| **对账/退款** | ⚠️ 基础对账 | ✅ 完整对账+退款方案 | ✅ 自动对账+风控建议 |
| **其他渠道扩展** | ❌ 不提供 | ✅ 银联/境外支付定制 | ✅ 全部渠道定制+维护 |
| **供应链系统集成** | ❌ 自行集成 | ✅ 无缝对接客易到供应链 | ✅ 对接任何第三方系统 |
| **安全加固** | ❌ 自行加固 | ✅ 提供安全检查清单 | ✅ 渗透测试+加固实施 |

### 📦 服务定价

| 服务项 | 价格 | 适合场景 |
|--------|:---:|----------|
| 🚀 **1对1接入指导**（远程） | ¥200/次 | 配置/调试遇到困难，快速解决 |
| 🔧 **技术支持年费** | ¥2,000/年 | 长期维护保障+优先响应 |
| 💻 **二次开发** | ¥5,000起 | 扩展新支付渠道/定制功能 |
| 🏢 **企业集成服务** | 面议 | 对接现有系统/全栈方案 |

> 📞 **备注「聚合支付」加微信/QQ → 获取接入指导和报价**

> 💡 **引流策略提示**：先免费提供基础接入指导，建立信任后转化到高客单价服务

---

## ❓ 常见问题

**Q: 这个项目稳定吗？适合生产使用吗？**
A: 已在客易到供应链系统中生产运行，支持日处理数千笔交易。开源版可直接使用，建议生产前充分测试。

**Q: 如何获取微信支付的商户证书？**
A: 登录 [微信支付商户平台](https://pay.weixin.qq.com/) → 账户中心 → API安全 → 下载证书。

**Q: 支持对账/退款吗？**
A: 开源版支持基础对账和退款能力，高级对账报表和风控能力在商业服务中提供。

**Q: 能接入银联/境外支付吗？**
A: 开源版仅支持微信和支付宝。商业服务可定制接入其他支付渠道。

---

## 📞 联系方式

| 方式 | 信息 |
|------|------|
| 💬 **QQ** | 58624951 |
| 📧 **邮箱** | 58624951@qq.com |
| 🐞 **Issue** | [提交Bug或建议](https://gitee.com/dalielie/java-aggregation-payment/issues) |

> 💡 加QQ/发邮件时请备注 **"聚合支付"**，优先处理

---

<div align="center">

**⭐ 如果这个项目对您有帮助，请点个 Star ⭐**

**让支付接入不再重复造轮子！**

</div>