🚀 从 0 构建一个通用加密货币支付系统：XPay 项目实践分享

支持 USDT、ETH、TRX，秒级到账、自动归集、回调通知，专为 Web2 游戏、电商、SaaS 项目设计。

---

👋 背景：为什么我要做这个项目？

作为一个 Web3 领域的独立开发者，我发现很多 Web2 项目（比如小游戏、电商独立站、小工具型 SaaS）有这样的痛点：

• 想支持 USDT / ETH 等加密支付，但没有成熟方案

• 使用第三方平台收款不稳定、限制多、手续高

• Web3 支付方案复杂，动不动就需要合约、钱包、前端集成

于是，我花了几周时间开发了 XPay，一个轻量级的加密货币支付系统。

---

🎯 XPay 是什么？

XPay 是一个针对 Web2 场景设计的加密支付解决方案，主要功能包括：

✅ 支持的支付币种/网络

• TRC20-USDT

• ERC20-USDT

• BEP20-USDT

• 支持任意链上代币拓展（后续支持 BTC）

✅ 商户能力

• 📬 提供唯一地址收款（基于地址池或 HD 钱包）

• ⚙️ 实时监听到账事件（基于 TronGrid、Web3j）

• 🧾 提供 webhook 回调（POST 订单状态）

• 🔄 自动归集到账户地址

• 🖥️ 后台可视化（开发中）

---

🧱 技术架构

本项目采用 Spring Boot + MyBatis Plus 开发，前端为 Vue 3 + Vite，部署在 Cloudflare Pages，监听模块使用多线程支持 ETH/BSC/TRON：

• 监听模块：根据支付地址队列 + RPC/TronGrid 实时扫描

• 地址池系统：支持助记词生成 HD 地址，并批量入库

• 归集机制：通过 SDK 自动签名并广播归集交易

• 回调通知：成功入账后通过 webhook 通知商户系统

技术栈如下：

模块	技术栈
后端	Spring Boot 3.4.6、JDK 17、MyBatis Plus
前端	Vue 3、Element Plus、Vite
钱包	TronJ、Web3j、BTC hdwallet
存储	MySQL
部署	Cloudflare Pages + Docker

---

🔌 如何接入 XPay？

集成流程很简单（以 TRC20 为例）：

1. 创建订单：调用后端接口，系统分配一个地址（绑定订单）

2. 用户付款：用户扫码/复制地址发送 TRC20-USDT

3. 监听到账：监听模块识别该地址入账

4. 状态更新：修改订单状态为成功，并回调商户系统

5. 自动归集：将用户地址上的资金归集至主钱包

你只需要集成 HTTP API，就能完成加密支付接入。

---

💡 为什么说它适合 Web2 开发者？

对大部分 Web2 商户来说，他们不想：

• 跑智能合约

• 管理复杂的钱包体系

• 使用陌生的钱包工具

XPay 的定位就是「Web2 友好」：

• 不依赖钱包前端

• 不需要 MetaMask

• 所有功能都通过 API 调用完成

• 支持私有部署，也可用托管服务

---

🧪 示例场景

• 🎮 小型 HTML5 游戏接入 USDT 支付

• 🛒 跨境电商独立站支持 USDT 结算

• 🧰 工具类 SaaS（如 GPT 助手）支持数字货币订阅

• 👨‍💻 承接代付项目，接入多商户管理后台（企业版）

---

🧭 项目进展和计划

已完成：

• ✅ 商户创建 + 地址分配

• ✅ USDT 到账监听（TRON / ETH）

• ✅ 支持自动归集 + 回调通知

• ✅ 网站 + 接入文档上线（docs.xpaylabs.com）

开发中：

• 📊 商户可视化后台（Vue3）

• 🧩 支持 BTC、SOL 等链接入

• 🛍️ Shopify / WordPress 插件

• 🆓 发布 GitHub 开源版本（计划 MIT 协议）

---

🤝 谁适合用？

• Web2 游戏、电商、SaaS 项目想要接入 USDT 支付

• 不想自建监听和归集系统

• 想提供稳定的收款体验给海外用户

• 想用 Java/Vue 技术栈快速集成

---

---

---