com.xpay.sdk.intl

Class XPayIntlResponse

java.lang.Object

com.xpay.sdk.intl.XPayIntlResponse

public class XPayIntlResponse
extends Object

国际版 OpenAPI HTTP 响应。

SDK 保留 HTTP 状态码、Header 和原始 Body，并在构造前完成响应验签。只有接口无法识别 API Key 而返回 无签名的非2xx前置错误时，SDK 返回 signatureVerified=false 的诊断响应；调用方不得据此更新业务状态。

Field Summary

Fields

Modifier and Type	Field and Description
byte[]	body 未经 JSON 解析或重编码的响应 Body 字节；空响应为长度零数组，不允许为 null。
Map<String,List<String>>	headers 响应 Header，多值按 OkHttp 收到的内容保留；不会包含 SDK 本地密钥。
boolean	signatureVerified 是否已使用本次请求 API Key 对应的 API Secret 完成响应签名校验。
int	statusCode HTTP 状态码。

Constructor Summary

Constructors

Constructor and Description
XPayIntlResponse(int statusCode, Map<String,List<String>> headers, byte[] body, boolean signatureVerified) 创建经过响应签名处理的 SDK 响应。

Method Summary

Modifier and Type	Method and Description
String	bodyAsString() 以 UTF-8 读取响应 Body。
boolean	isSignatureVerified() 判断响应是否已通过签名校验。
boolean	isSuccessful() 判断 HTTP 调用是否符合最终五接口成功合同。

Methods inherited from class java.lang.Object

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

Field Detail

statusCode

public final int statusCode

HTTP 状态码。

headers

public final Map<String,List<String>> headers

响应 Header，多值按 OkHttp 收到的内容保留；不会包含 SDK 本地密钥。

body

public final byte[] body

未经 JSON 解析或重编码的响应 Body 字节；空响应为长度零数组，不允许为 null。

signatureVerified

public final boolean signatureVerified

是否已使用本次请求 API Key 对应的 API Secret 完成响应签名校验。

Constructor Detail

XPayIntlResponse

public XPayIntlResponse(int statusCode,
                        Map<String,List<String>> headers,
                        byte[] body,
                        boolean signatureVerified)

创建经过响应签名处理的 SDK 响应。

构造方法只保存传输结果，不访问网络、缓存或数据库，不启动事务或异步任务。只有无法识别 API Key 的 非2xx前置错误可传 signatureVerified=false，调用方必须把它作为不可信诊断信息处理。

Parameters:

statusCode - HTTP 状态码

headers - 响应 Header；null 按不可变空 Map 处理

body - 原始响应 Body；null 按空字节数组处理

signatureVerified - 响应是否已经通过 HMAC-SHA256 验签

Method Detail

isSuccessful

public boolean isSuccessful()

判断 HTTP 调用是否符合最终五接口成功合同。

只有HTTP为200且响应签名已验证才代表接口调用成功；其它2xx不属于最终合同并fail-close。200仍不代表 订单终态成功，调用方仍需读取 status、接收 Webhook 或按 merchantOrderNo 查单。 该方法无事务、缓存或并发副作用。

Returns:

HTTP 状态码恰为200且响应验签通过时返回 true

isSignatureVerified

public boolean isSignatureVerified()

判断响应是否已通过签名校验。

返回 false 的响应是网关或服务认证前生成的无签名非2xx错误，Body 只能用于诊断，不能驱动 订单状态。该方法不访问网络、缓存或数据库。

Returns:

普通响应签名有效时返回 true

bodyAsString

public String bodyAsString()

以 UTF-8 读取响应 Body。

本方法仅供验签后的 JSON 解析或诊断展示，不会重新执行验签、缓存或异步处理。

Returns:

UTF-8 响应文本；空响应返回空字符串