com.xpay.sdk.intl

Class XPayIntlResponseVerifier

java.lang.Object

com.xpay.sdk.intl.XPayIntlResponseVerifier

public final class XPayIntlResponseVerifier
extends Object

国际版普通 API 响应验签工具。

工具使用发起请求所对应的 API Secret，对响应 Timestamp、Nonce 和精确原始 Body 组成的三行原文验签。验签失败统一返回 false，调用方必须 fail-close，不能据此响应更新订单终态。

Method Summary

Modifier and Type	Method and Description
static String	sign(String timestamp, String nonce, byte[] rawBody, String apiSecret) 生成普通 API 响应签名。
static boolean	verify(String timestampHeader, String nonceHeader, String signatureHeader, byte[] rawBody, String apiSecret, long toleranceSeconds) 校验普通 API 响应签名。
static boolean	verify(String timestampHeader, String nonceHeader, String signatureHeader, String rawBody, String apiSecret, long toleranceSeconds) 校验 UTF-8 文本形式的普通 API 响应签名。

Methods inherited from class java.lang.Object

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

Method Detail

verify

public static boolean verify(String timestampHeader,
                             String nonceHeader,
                             String signatureHeader,
                             byte[] rawBody,
                             String apiSecret,
                             long toleranceSeconds)

校验普通 API 响应签名。

每行后均包含一个换行字节，包括 Body 后的最后一个换行。方法先检查时间窗口，再执行常量时间比较； Header 缺失、格式错误、超窗或密钥错误均 fail-close 返回 false。方法无事务、缓存、网络或异步副作用， 可并发调用。

Parameters:

timestampHeader - 响应 Timestamp Header

nonceHeader - 响应 Nonce Header

signatureHeader - 响应 Signature Header，格式为 v1= 加 64 位小写十六进制

rawBody - 实际收到且未经 JSON 解析、格式化或重编码的响应 Body 字节

apiSecret - 本次请求 API Key 对应的 API Secret

toleranceSeconds - 与本机 Unix 时间允许的最大偏差秒数，必须大于零

Returns:

时间戳和签名均有效时返回 true，否则返回 false

verify

public static boolean verify(String timestampHeader,
                             String nonceHeader,
                             String signatureHeader,
                             String rawBody,
                             String apiSecret,
                             long toleranceSeconds)

校验 UTF-8 文本形式的普通 API 响应签名。

该重载便于未修改响应字符串的轻量接入；若框架可获取原始字节，应优先使用字节重载避免字符集转换。 验签失败返回 false，不启动事务、缓存或异步任务。

Parameters:

timestampHeader - 响应 Timestamp Header

nonceHeader - 响应 Nonce Header

signatureHeader - 响应 Signature Header

rawBody - 未改写的 UTF-8 响应 Body

apiSecret - 本次请求 API Key 对应的 API Secret

toleranceSeconds - 时间戳最大允许偏差秒数，必须大于零

Returns:

验签通过返回 true，否则返回 false

sign

public static String sign(String timestamp,
                          String nonce,
                          byte[] rawBody,
                          String apiSecret)

生成普通 API 响应签名。

该方法用于对接测试、测试向量和服务端互操作验证；生产商户通常只需调用 verify(java.lang.String, java.lang.String, java.lang.String, byte[], java.lang.String, long)。签名原文严格 保留原始 Body 字节，方法无事务、缓存、网络或异步副作用。

Parameters:

timestamp - 响应 Unix 秒级时间戳

nonce - 响应随机串

rawBody - 原始响应 Body 字节

apiSecret - API Secret

Returns:

v1= 加 64 位小写十六进制签名

Throws:

XPayIntlException - 参数含换行、密钥为空或加密算法异常时抛出