结构

参数名称

类型

是否必需

描述

context

Context

是

表示应用程序级别的上下文。

usbDevice

UsbDevice

是

表示通过 USB 连接到 Android 系统的设备。

参数名称

类型

是否必需

描述

value

Integer

是

货币最小单位的金额值。例如，10000 表示新加坡元 100.00。（取值范围：0-2147483647）

currency

String

是

遵循 ISO-4217 标准的 3 个字符的货币代码。例如，USD。（最大长度：3 个字符）

参数名称

类型

是否必需

描述

无

无

参数名称

类型

是否必需

描述

timeout

Long

否

全局接口调用超时时长，以毫秒为单位，默认为 15000 毫秒（15 秒）。

debug

Boolean

否

表示是否打印调试日志。有效值为：

• true：打印调试日志。
• false：默认值。不打印调试日志。

参数名称

类型

是否必需

描述

paymentRequestId

String

是

由 POS 提供商定义的用于标识支付请求的唯一 ID。

• 最大长度：64 个字符。
• 仅允许字母（a-z、A-Z）、数字（0-9）和下划线（_）。

注意：此参数对每个门店是唯一的。此为幂等键参数。对于使用相同 paymentRequestId 发起的支付，将返回相同的结果。

paymentMethod

String

是

商户或收单机构用于收取付款的支付方式。请参阅支持的支付方式了解更多信息。

paymentAmount

Amount

是

商户请求以订单币种接收的支付金额。

originalMerchantOrderId

String

否

商户端用于标识订单的原始唯一 ID。（最大长度：255 个字符）

originalMerchantStoreId

String

否

商户端用于标识门店的原始唯一 ID。（最大长度：255 个字符）

参数名称

类型

是否必需

描述

paymentRequestId

String

是

由 POS 提供商定义的用于标识支付请求的唯一 ID。

• 最大长度：64 个字符。
• 仅允许字母（a-z、A-Z）、数字（0-9）和下划线（_）。

注意：此参数对每个门店是唯一的。使用 paymentRequestId 调用 inquiryPayment 接口查询支付状态。每次调用将返回最新的支付结果。

参数名称

类型

是否必需

描述

cashierReceipt

String

否

提供给商户的收据，显示交易信息。

customerReceipt

String

否

参数名称

类型

是否必需

描述

commandExecuteTimeout

Long

否

表示接口调用超时时长，以毫秒为单位。您可以为接口请求设置自定义超时时间。如果未设置，则使用默认超时时间。diagnosis、inquiryPayment 接口的默认超时时间为 15 秒，pay 接口的默认超时时间为 120 秒。

参数名称

类型

是否必需

描述

resultStatus

String

是

结果状态。有效值为：

• S：成功
• F：失败
• U：未知

resultCode

String

否

结果码。（最大长度：64 个字符）

resultMessage

String

否

详细描述结果码的结果消息。（最大长度：256 个字符）

键

描述

onConnectSuccess

onConnectFailure