跳转到主要内容
使用官方 XPayLabs Java SDK(xpay-java-sdk)将加密支付集成到您的 Spring Boot 应用程序中。SDK 提供全面的客户端,支持收款订单、付款、Webhook 处理和余额管理,HMAC-SHA256 签名自动处理。

安装

将 Maven 依赖添加到您的 pom.xml
对于 Gradle:

配置

使用您的商家令牌和 API 密钥配置 SDK:
属性必填描述
apiKey商家令牌
apiSecret用于 HMAC 签名的 API 密钥
baseUrl网关基础 URL(默认:https://api.xpaylabs.com;自托管部署时覆盖此值)
connectTimeout连接超时(毫秒,默认:30000)
readTimeout读取超时(毫秒,默认:30000)

核心 API 方法

创建收款订单

创建付款

查询订单状态

获取支持的代币

获取商家余额

获取用户的充值地址

处理 Webhook

SDK 提供内置的 Webhook 签名验证和事件解析。设置一个控制器来接收 Webhook 回调:

错误处理

SDK 针对 API 错误抛出 XPayApiException

完整示例

请参阅 SDK 仓库中的 XPayExample.java 类,获取涵盖所有 API 操作的完整示例。
SDK 使用 HMAC-SHA256 进行请求签名。XPay 类会自动处理——您只需传入请求对象,它会内部管理 signtimestampnonce 字段。
最后修改于 2026年6月26日