交易标识符和状态
`TransactionId`
`String(36)`
此交易的**唯一标识符**。
如果使用了 `/StartSession`，则回显其中的加密 ID。
否则，该值由 Nayax Engine 生成。
|
`NayaxTransactionId`
`Int(64)`
|
该交易的 Nayax 内部唯一 ID,将在后续请求中回传。
|
`SrvTranId`
`String`
**集成商的内部交易 ID** 。
条件性字段:若未使用 `/StartSession`,则为必填项。
若已使用,该字段应为空,或回传请求中的交易 ID。
|
`RRN`
`String`
检索参考号（RRN）。
用作第三方(例如卡组织)的外部交易 ID。
建议对消费者/持卡人可见。
|
`Token`
`String(256)`
|
唯一的交易令牌。仅供 Nayax 内部使用。
|
`TraceNumber`
`String`
|
跟踪号。仅供 Nayax 内部使用。
|
`AuthSource`
`String(5)`
|
仅供 Nayax 内部使用。
|
财务详情与金额
`Amount`
`Double`
支付金额。
小数值(分位最多 3 位)。
没有小数位的货币(例如 JYN)仍以双精度浮点数表示(例如 `234.0`)。
|
`AuthAmount`
`Double`
|
`/Authorization` 请求中所请求的原始金额。是否显示取决于 `/Authorization` 的响应。
|
`SettAmount`
`Double`
|
`/Settlement` 或 `/Sale` 流程中请求的原始金额。与 Authorization 命令无关。
|
`CurrencyCode`
`String(3)`
|
以 ISO 4217 三位字母格式表示的货币代码(例如 USD、EUR)。
|
`CurrencyNumeric`
`String(3)`
|
ISO 4217 数字 3 位格式的货币代码。
|
`DecimalPlace`
`Int(64)`
该机器上金额的小数点位置。
示例:`2` 表示金额形式如 123.45。
示例:`0` 表示金额形式如 12345(整数表示)。
|
`AuthCode`
`String(40)`
|
外部授权码(通常来自发卡行)。
|
时间戳与标志
`MachineAuTime`
`String`
|
机器授权时间戳。
|
`TimeoutMS`
`Int(32)`
|
Nayax 服务器超时配置（单位：毫秒）。
|
`Offset`
`String(255)`
|
机器所在位置的 UTC 时区偏移量。
|
`AuthDateTime`
`String`
|
`/Authorization` 发生的日期和时间。格式：`ddMMyyHHmmss`。
|
`SettDateTime`
`Double`
|
结算日期/时间。仅与结算相关命令有关。与授权无关。
|
`IsGatewayTimeout`
`Bool`
|
指示是否发生**网关超时**（响应中有效）。
|
卡片及支付详情
`CardNumber`
`String`
根据交易类型提供的卡片信息：
对于卡在场的 Authorization/Sale,为完整的 Track 2 数据。
对于其他交易类型(例如 Refund、Settlement),仅为卡的 PAN。
**注意：** 卡片详细信息使用设备读取卡片时的相同格式。对于 Mifare 卡,Track 2 数据为十六进制。对于磁条卡,Track 2 数据为 ASCII。
|
`EntryMode`
`String(4)`
卡片信息的读取方式：
MCR:磁条(刷卡)
CON:接触式芯片(插卡)
CLS:非接触式芯片(轻触)
NFC:手机轻触
QR:QR 码读取
|
`ExpYear`
`String`
|
卡片到期年份（ **YY**格式）。**条件性**（仅当接口为 1 或 10 时）。
|
`ExpMonth`
`String`
|
卡片到期月份（ **MM**格式）。**条件性**（仅当接口为 1 或 10 时）。
|
`EMVData`
`String`
|
EMV标签数据采用**TLV（标签长度-值）格式**。
|
`IDNumber`
`String`
|
持卡人 ID/识别号码。
|
`RandomNumber`
`String`
|
暂无更多信息。
|
`PrimaryId`
`String`
|
主品牌 ID(例如 Visa、Mastercard)。
|
`PrimaryDescription`
`String`
|
主要品牌描述。
|
`SecondaryId`
`String`
|
次品牌 ID(如适用)。
|
`CardHolderName`
`String`
|
持卡人姓名。
|
商品/项目详情
`IsProductSelected`
`Bool`
|
表示产品在支付流程开始之前是否已被预先选定。
|
`Code`
`Int(16)`
|
在 Nayax 后台或自动售货机中定义的所选商品代码。
|
`CatalogProductId`
`String(100)`
|
所选商品的外部唯一标识符(产品目录编号)。
|
`Name`
`String(255)`
|
Nayax 后台中定义的**产品名称**。
|
`Price`
`Double`
|
The original **Product Price** in the machine's currency. Note: `Amount` is the final billing price after adjustments.
|
`UnitOfMeasurement`
`String(64)`
|
产品的计量单位（例如 “unit” 或 “Liter”）。
|
`Measurement`
`Double`
|
以指定计量单位表示的产品数量。
|
`Group`
`String(255)`
|
在产品映射表中定义的产品组名称。
|
`ProductGroupId`
`String(255)`
|
在产品映射表中定义的产品组代码。
|
`PulseLineNumber`
`Int(32)`
|
用于通过脉冲(pulse)支持多台机器实现远程出货功能。必须为正整数 $(\ge 0)$。
|
机器和设备信息
`HwSerial`
`String`
|
Nayax 设备**硬件序列号**。
|
`FWVersion`
`String`
|
设备固件版本(Device Firmware Version)。
|
`Type`
`String`
|
Nayax 设备类型。
|
`Id`
`Int(64)`
|
在 Nayax 后台分配的机器实体唯一 ID。
|
`Name`
`String(255)`
|
在 Nayax 后台中定义的机器名称。
|
`TerminalId`
`String(255)`
|
在 Nayax 后台中定义的终端标识符。
|
机器位置(Machine Location)
`SiteId`
`Int(16)`
|
托管该机器数据的 Nayax 服务器区域。
|
`Region`
`String(255)`
|
在 Nayax 后台中定义的机器区域(Machine Region)。
|
`City`
`String(255)`
|
在 Nayax 后台中定义的机器所在城市。
|
`ZipCode`
`String(255)`
|
在 Nayax 后台中定义的机器邮政编码。
|
`Latitude`
`String`
|
机器位置**纬度**。
|
`Longitude`
`String`
|
机器位置**经度**。
|
参与方(商户/运营商)详情
`Id`
`Int(64)`
|
在 Nayax 后台中定义的 Actor ID(直接商户/运营商)。
|
`Name`
`String(255)`
|
在 Nayax 后台中定义的直接商户名称。
|
`OperatorId`
`String(255)`
|
在 Nayax 后台中定义的商户 ID(运营商 ID - 字符串版本)。
|
`OperatorId`
`Int(64)`
|
商户运营商 ID(整数版本)。
|
`OperatorName`
`String`
|
商户运营商名称。
|
`MerchantId`
`Int(64)`
|
在 Nayax 后台中定义的商户 ID。
|
`DynamicURL`
`String`
|
Actor 级别的 URL 配置。
|
`State`
`String`
|
演员地理位置**代码**。
|
`City`
`String(255)`
|
Actor 地理位置城市。
|
`CountryCode`
`String`
|
Actor 地理位置国家代码(ISO-3)。
|
`ZipCode`
`String(255)`
|
Actor 地理位置邮政编码。
|
`Address`
`String(255)`
|
Actor 地理位置地址。
|
国家信息(ISO 3166-1)
`Name`
`String`
|
国家**全称**。
|
`NumericCode`
`String(3)`
|
以 ISO 3166-1 三位数字格式表示的国家代码。
|
`Alpha2Code`
`String(2)`
|
以 ISO 3166-1 两位字母格式表示的国家代码。
|
`Alpha3Code`
`String(3)`
|
以 ISO 3166-1 三位字母格式表示的国家代码。
|
`Intra`
`String`
|
用于跨国地理多元化的区域内(Intra Region,例如“European Union”)。
|
自定义数据（JSON 字符串）
`GroupId`
`String`
|
仅供 Nayax 内部使用。
|
`DirectActor`
`String`
|
直接演员**自定义数据**（ **JSON 格式**的字符串）。
|
`Operator`
`String`
|
操作员**自定义数据**（ **JSON 格式**的字符串）。
|
`Distributor`
`String`
|
分销商**自定义数据**（ **JSON 格式**的字符串）。
|
`Actor`
`String`
|
演员**自定义数据**（ **JSON 格式**的字符串）。
|
`Machine`
`String`
|
机器**自定义数据**（ **JSON 格式**的字符串）。
|
`AdditionalData`
`String`
|
通用自定义数据字符串， **JSON 格式**。
|