com.xpay.sdk.intl

Class XPayIntlConfig

java.lang.Object

com.xpay.sdk.intl.XPayIntlConfig

public class XPayIntlConfig
extends Object

国际版开放接口 SDK 的不可变配置。

配置只保存平台下发的 HTTPS 接口域名、API Key、API Secret、响应验签时间窗口和可复用 HTTP 客户端。 /intl/v1 版本路径由客户端内部统一拼接，避免商户配置时把环境域名和接口版本混在一起。 SDK 强制关闭连接重试和重定向，防止资金请求重放或签名 Header 跨地址转发；密钥仅用于内存签名， 不写入日志、文件、缓存或网络请求体。

Field Summary

Fields

Modifier and Type	Field and Description
static long	DEFAULT_SIGNATURE_TOLERANCE_SECONDS 普通 API 响应和 Webhook 的默认时间戳容忍窗口，单位为秒。

Constructor Summary

Constructors

Constructor and Description
XPayIntlConfig(String baseUrl, String apiKey, String apiSecret) 使用 SDK 默认 HTTP 客户端创建配置。
XPayIntlConfig(String baseUrl, String apiKey, String apiSecret, long responseSignatureToleranceSeconds, okhttp3.OkHttpClient httpClient) 使用自定义响应验签窗口和 HTTP 客户端创建配置。
XPayIntlConfig(String baseUrl, String apiKey, String apiSecret, okhttp3.OkHttpClient httpClient) 使用调用方提供的 HTTP 客户端创建配置。

Method Summary

Modifier and Type	Method and Description
String	getApiKey() 获取 API Key。
String	getApiSecret() 获取 API Secret。
String	getBaseUrl() 获取国际版 API Base URL。
okhttp3.OkHttpClient	getHttpClient() 获取可复用 HTTP 客户端。
long	getResponseSignatureToleranceSeconds() 获取普通响应签名时间戳容忍窗口。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEFAULT_SIGNATURE_TOLERANCE_SECONDS

public static final long DEFAULT_SIGNATURE_TOLERANCE_SECONDS

普通 API 响应和 Webhook 的默认时间戳容忍窗口，单位为秒。

See Also:

Constant Field Values

Constructor Detail

XPayIntlConfig

public XPayIntlConfig(String baseUrl,
                      String apiKey,
                      String apiSecret)

使用 SDK 默认 HTTP 客户端创建配置。

失败策略：任一凭据为空、Base URL 不是严格的 HTTPS 根地址时立即抛出参数异常；本构造方法不访问网络、 数据库或缓存，也不启动异步任务。

Parameters:

baseUrl - 平台下发的 HTTPS 接口域名，例如 https://api.example.com

apiKey - 商户 API Key，用于 Api-Key Header

apiSecret - 商户 API Secret，仅用于本地 HMAC-SHA256

Throws:

IllegalArgumentException - Base URL 非法或任一凭据为空时抛出

XPayIntlConfig

public XPayIntlConfig(String baseUrl,
                      String apiKey,
                      String apiSecret,
                      okhttp3.OkHttpClient httpClient)

使用调用方提供的 HTTP 客户端创建配置。

SDK 会复制调用方客户端并强制关闭连接自动重试、HTTP 重定向和 HTTPS 重定向，避免 POST 重放或把 API Key 与按原 URL 计算的签名发送到其他地址。配置对象不可变，可被多个请求线程共享；调用方仍负责 原客户端共享连接池、Dispatcher 等资源的生命周期。

Parameters:

baseUrl - 平台下发的 HTTPS 接口域名，例如 https://api.example.com

apiKey - 商户 API Key，用于 Api-Key Header

apiSecret - 商户 API Secret，仅用于本地 HMAC-SHA256

httpClient - HTTP 客户端；传 null 时使用 SDK 默认客户端

Throws:

IllegalArgumentException - Base URL 非法或任一凭据为空时抛出

XPayIntlConfig

public XPayIntlConfig(String baseUrl,
                      String apiKey,
                      String apiSecret,
                      long responseSignatureToleranceSeconds,
                      okhttp3.OkHttpClient httpClient)

使用自定义响应验签窗口和 HTTP 客户端创建配置。

失败策略：验签窗口必须大于零；所有校验在对象构造阶段 fail-close 完成。该方法无事务、缓存、 异步任务或网络副作用。

Parameters:

baseUrl - 平台下发的 HTTPS 接口域名，例如 https://api.example.com

apiKey - 商户 API Key，用于 Api-Key Header

apiSecret - 商户 API Secret，仅用于本地 HMAC-SHA256

responseSignatureToleranceSeconds - 响应签名时间戳容忍窗口，必须大于零

httpClient - HTTP 客户端；传 null 时使用 SDK 默认客户端

Throws:

IllegalArgumentException - Base URL、凭据或响应验签窗口不合法时抛出

Method Detail

getBaseUrl

public String getBaseUrl()

获取国际版 API Base URL。

Returns:

不以斜杠结尾且不包含接口 Path、Query 或 Fragment 的 HTTPS 接口域名

getApiKey

public String getApiKey()

获取 API Key。

Returns:

商户 API Key；调用方不得写入日志或返回前端

getApiSecret

public String getApiSecret()

获取 API Secret。

Returns:

仅供 SDK 内存签名使用的 API Secret；调用方不得记录或传输明文

getResponseSignatureToleranceSeconds

public long getResponseSignatureToleranceSeconds()

获取普通响应签名时间戳容忍窗口。

Returns:

大于零的秒数；SDK 在解析响应 JSON 前使用该值 fail-close 验签

getHttpClient

public okhttp3.OkHttpClient getHttpClient()

获取可复用 HTTP 客户端。

Returns:

SDK 请求使用的 OkHttpClient 副本；连接重试和重定向固定关闭