Question 1

什么是 xpay？

Accepted Answer

xpay 是 XPay Labs 的通用简称。当人们提到 xpay 时，指的就是 XPay Labs——同一个基于 Docker 的自托管、非托管加密支付基础设施，支持 TRON、EVM 链和 SUI，零交易手续费。

Question 2

什么是 XPay Labs（简称 xpay）？

Accepted Answer

XPay Labs（简称 xpay）是一款自托管加密支付基础设施。它帮助开发者在自家系统搭建多链稳定币收款系统，覆盖波场 TRON、EVM 兼容链与 SUI。完全自主掌控，无需第三方代收，零网关交易抽成。

Question 3

支持哪些区块链网络与加密货币？

Accepted Answer

原生开箱支持 TRON (TRC-20，重点针对 USDT 进行了底层加速)、Ethereum、BNB Chain、Polygon、Arbitrum 等各大以太坊 EVM 兼容链，以及新一代非 EVM 的 SUI。支持主流稳定币 (USDT / USDC)，商户亦可在配置文件中追加任意自定义 ERC-20 代币的合约地址。

Question 4

自托管和非托管具体如何确保我的资金安全？

Accepted Answer

在 XPay Labs 中，所有加密私钥、助记词及派生地址，均在您自己完全隔离的管理容器内存空间中产生与保存，绝不经过任何第三方云端。XPay 绝对不在云端收集或存储商户密钥。收款资金全流程由顾客直接划入您的专属私钥钱包，无法被外部冻结。

Question 5

Webhook 事件推送如果不通会如何处理？

Accepted Answer

我们的 Webhook 精巧微服务底层包含了自动重试机制。当您的商户服务器由于网络、过载等异常返回 500 等错误时，网关将按照指数退避自动重试推送。并且，每次 webhook 推送均有基于 SHA256 HMAC 密钥的验签头，确保推送者身份可信。

Question 6

是否有供开发者调用的 SDK、API、或者是技术支持？

Accepted Answer

是的。XPay Core 在自托管环境中开启后会开放符合标准 REST 设计规范的 API 路由，其整体语法与现代国际标准支付界面无缝衔接。并且在我们的技术文档中配有完备的多语言一键集成代码示范 (cURL, NodeJS等)。

Question 7

部署 XPay 最低系统资源要求高吗？

Accepted Answer

系统由于包含多链实时索引、商户节点、网关监控、加密签名和 Webhook 消息队列等多个核心后端服务，对运行环境的要求较为严谨。为保障 JVM 容器及全套组件在高负载下的绝对稳定，推荐最低硬件配置为 8GB RAM / 4核 vCPU；在高并发或由多个网关集群联合组成的生产环境下，建议主节点及服务集群分配 16GB RAM / 8核 vCPU 起步。通过我们提供的 Docker Compose 模板，您可以轻松实现全套前后端微服务及静态资源的一键整站打包部署，极速跑通全部服务。

Question 8

如何搭建自托管加密支付网关？

Accepted Answer

部署 XPay Labs 只需不到 30 分钟。首先准备一台至少 8GB RAM、4核 CPU 的 VPS（推荐 Ubuntu 22.04+），安装 Docker 和 Docker Compose，然后克隆仓库并运行 docker compose up -d。配置您的区块链 RPC 端点（TRON、EVM、SUI）并生成节点种子短语。部署完成后，网关在 180 端口提供 REST API。完整的安装指南请参阅我们的开发文档。

Question 9

XPay Labs 与 BitPay 或 Coinbase Commerce 相比如何？

Accepted Answer

根本区别在于资产托管和费用。BitPay（1% 手续费）和 Coinbase Commerce（0.8% + $25/月）会持有商户密钥并按交易收费。XPay Labs 是自托管且非托管的——密钥保留在您的 Docker 容器中，您只需支付区块链燃料费（通常每笔 $0.01-$0.50）。对于每月处理 $100,000 加密货币支付的企业，每年可节省 $6,000-$12,000 的网关费用。

Question 10

XPay Labs 支持哪些稳定币？

Accepted Answer

除所有支持链上的 USDT 外，XPay Labs 可以通过在节点配置 JSON 中声明合约地址来追踪任何标准 TRC20 或 ERC20 代币，包括 USDC、DAI、BUSD、FRAX 等。扫描器通过监控代币合约的 Transfer 事件日志来识别转账，从索引参数中提取金额、发送方和接收方。

Question 11

支付到账检测需要多长时间？

Accepted Answer

检测速度因链而异。在 TRON 上，内存池扫描器可在广播后 1-3 秒内检测到传入的 USDT 转账。在 EVM 链上，检测通常在 2-6 秒内完成。SUI 交易通常在 1-2 秒内检测到。系统可配置在触发 Webhook 前等待特定数量的区块确认。

Question 12

我可以自定义结账页面的品牌吗？

Accepted Answer

可以。XPay Labs 是完全白标的。结账 UI 使用 Vue 3 构建，可以根据您的品牌进行主题定制——颜色、字体、Logo、布局和自定义 CSS。整个前端与网关一起部署在 Docker 中，没有第三方 iframe 或外部品牌要求。开发者也可以使用 REST API 构建完全自定义的结账体验。

Question 13

XPay Labs 能否支持 USDT 收款？

Accepted Answer

可以。XPay Labs 在所有集成的区块链上原生支持 USDT——波场 TRON 上的 TRC20 USDT、以太坊及所有 EVM 链上的 ERC20 USDT、币安智能链上的 BEP20 USDT，同时也支持 USDC。多链扫描器同时监控所有网络，能在数秒内检测到账的稳定币付款。相较于收取 0.5-1% 手续费的托管网关，商家可降低 40-60% 的支付处理成本。

Question 14

XPay Labs 是否支持多链支付？

Accepted Answer

是的。XPay Labs 从底层架构上就是一套多链支付基础设施。它同时支持 TRON (TRC20)、所有 EVM 兼容链（以太坊、BSC、Polygon、Optimism、Arbitrum、Avalanche）以及 SUI。统一事件通道将所有区块链扫描输出合并为单一的 Webhook 数据流，无论顾客使用哪条链，您的应用收到的都是标准化的支付通知。

Question 15

XPay Labs 的 Webhook 是如何工作的？

Accepted Answer

当链上检测到付款时，Webhook 服务会构建一个 HMAC-SHA256 签名的 JSON 负载并发送至您配置的终端 URL。如果您的端点返回非 2xx 状态码，系统将按指数退避策略（1秒、2秒、4秒、8秒，最长间隔5分钟）自动重试，持续最多48小时。每个负载包含交易哈希、金额、币种、链和商户元数据。您可使用共享的 HMAC 密钥验证签名，确保负载来自您的 XPay 节点。

Question 16

XPay Labs 是否开放源代码？

Accepted Answer

XPay Labs 在 XPay 企业许可证下提供源代码。完整核心代码库发布于 GitHub，可供审计和自行部署。商户可精确检查密钥派生、交易扫描和 Webhook 分发的工作方式。社区支持通过 GitHub Issues 和 Discord 提供。商业支持计划起价为每年 $1,500，享有优先 SLA。

Question 17

自托管与非托管有什么区别？

Accepted Answer

自托管意味着您在自有基础设施（VPS、裸金属、Kubernetes）上部署和运行支付网关软件。非托管意味着您保留对私钥的独占控制权——没有任何第三方可以访问或转移您的资金。XPay Labs 两者兼具：您在自有服务器上运行，所有加密密钥材料均在您的 Docker 容器内生成和存储。与托管解决方案（提供商持有密钥并延迟结算给您）不同，XPay Labs 在任何环节都不触碰您的资金。

Question 18

XPay Labs 与 BTCPay Server 有何不同？

Accepted Answer

两者都是自托管方案，但 XPay Labs 专注于现代区块链网络（TRON、EVM、SUI）上的稳定币支付，而 BTCPay Server 主要面向比特币和闪电网络。XPay Labs 提供更注重开发者体验的 REST API（受 Stripe 设计模式启发）、原生多链并发扫描以及带自动重试队列的 HMAC 签名 Webhook。BTCPay Server 拥有更广泛的插件生态，但资源需求更高，且界面主要面向非技术商户。

Question 19

如果我的服务器在支付过程中宕机会怎样？

Accepted Answer

由于 XPay Labs 是非托管的，资金始终直接进入您的区块链钱包——宕机期间不存在资金损失风险。当节点恢复上线后，区块链扫描器会从上次检查点回放区块并检测任何遗漏的交易。Webhook 队列将待处理通知存储在持久化数据库中，待您的端点恢复可达后自动重试投递。

Question 20

是否有用于创建和管理支付的 API？

Accepted Answer

是的。XPay Labs 提供全面的 REST API 用于支付生命周期管理。create-payment 端点接受金额、币种、链和可选元数据，返回唯一的充值地址和结账 URL。其他端点涵盖 Invoice 状态查询、资金归集、Webhook 日志检索和商户钱包管理。API 响应遵循一致的 JSON 结构，字段类型明确。完整 API 文档（含 Node.js、Python、Go 和 cURL 示例）请参阅我们的技术文档。

Question 21

一个部署可以入驻多个商家吗？

Accepted Answer

可以。XPay Labs 原生支持多商家架构。一套 Docker Compose 部署即可服务无限商家，每个商家拥有独立的 API 凭证、独立的 Webhook 端点和独立的配置，商家之间数据完全隔离，互不可见。

Question 22

我可以向入驻商家收取交易手续费吗？

Accepted Answer

完全可以。作为平台运营者，您可以自主设置费率结构——按百分比抽成、每笔固定费用或混合模式。由于基础设施由您自己运行，没有第三方处理器抽成侵蚀您的利润，您产生的收入 100% 归您。

部署您专属的加密货币支付基础设施

实时交易内存池 (Mempool)

API 返回格式预览

您的基础设施、您的钱包、由您掌控

100% 绝对非托管

白标商业自由

灵活一键部署

零网关手续费

最佳加密支付基础设施，为高并发而生

领先多链支付

极简开发者 API

全自动资金下发

完美白标定制

高并发区块监听

可信 Webhook 通知

x402 协议

多商家平台

原生多链智能路由分发

TRON TRC-20

自托管高安全隔离架构图

商户业务服务器

XPay 核心引擎容器

区块链索引扫描模块

独立钱包管理服务

可靠的 Webhook 服务

如丝般顺滑的 API 设计

60 秒体验完整收款闭环

安全授权鉴权

实时下发账单

捕获区块入账

资金自动派 sweep

API Keys 生成机制

多品类数字化商业的可靠支撑

外贸及全球电商订单结算

SaaS 订阅系统计费模块

独立钱包与打赏终端

高定收银台视觉自定义

支付平台运营

常见问题解答 FAQ

掌握您的绝对收款主权