交易状态与核心标识符
`Verdict`
String
请求的最终状态。必须是以下常量字符串值之一：
- **`Approved`**
- **`Declined`**
|
`Code`
Int(32)
拒绝代码（Decline Code）。条件性字段——仅当 `Verdict` 为 “Declined” 时才会出现。有效的拒绝代码包括：
1:余额不足
5:疑似欺诈
6:一般系统故障
997:缺少必填参数
999:一般异常
完整代码列表请参阅完整文档。
|
`StatusMessage`
String(255)
|
包含**交易状态消息**或有关结果的其他不同数据的自由文本字段。
|
`TransactionId`
String(36)
此交易的**唯一标识符**。
如果使用了 `/StartSession`，则回显其中的加密 ID。
否则，该值由 Nayax Engine 生成。
|
`NayaxTransactionId`
Int(64)
|
**Nayax 内部交易的唯一 ID** ，在后续请求中会重复出现。
|
`SrvTranId`
String
**集成商的内部交易 ID** 。
条件性字段:仅当未使用 `/StartSession` 时为必填项。
若已使用,该字段应为空,或回传交易 ID。
|
`RRN`
String
|
参考检索号(Reference Retrieval Number)。供第三方使用的外部交易 ID。强烈建议对消费者/持卡人可见。
|
`Token`
String(256)
|
唯一的交易令牌。仅供 Nayax 内部使用。
|
`TraceNumber`
String
|
跟踪号。仅供 Nayax 内部使用。
|
`AuthSource`
String(5)
|
仅供 Nayax 内部使用。
|
`InitiateTranReference`
Int(64)
|
**条件**：反映预付会员卡重新尝试的**原始 Nayax 交易 ID** 。
|
财务详情、卡片信息与时间戳
`Amount`
Double
**付款金额**（以美分为单位，最多保留 3 位小数）。
示例:1 分 = `0.01`。
没有小数位的货币(例如 JYN)仍以双精度浮点数表示(例如 `234.0`)。
|
`AuthAmount`
Double
|
在 `/Sale`Request 中请求的原始金额。取决于 `/Sale` 响应。
|
`SettAmount`
Double
|
在 `/Sale`Request 中请求的原始金额。取决于 `/Sale` 响应。
|
`AuthCode`
String(40)
|
**外部授权码**（通常来自发卡行的银行）。
|
`CurrencyCode`
String(3)
|
**ISO 4217 Alpha-3**格式的货币代码。
|
`CurrencyNumeric`
String(3)
|
**ISO 4217 数字-3**格式的货币代码。
|
`AuthDateTime`
String
|
`/Sale` 发生的日期和时间。格式:`ddMMyyHHmmss`。取决于 `/Sale` 响应的条件性字段。
|
`SettDateTime`
Double
|
结算日期/时间(Settlement Date/Time)。取决于 `/Sale` 响应的条件性字段。
|
`CardNumber`
String
根据交易类型提供的卡片信息：
刷卡授权/销售的完整 Track 2 数据。
其他交易类型(例如退款、结算)仅提供卡号(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（标签长度-值）格式**。
|
`CVV2`
String
|
卡验证值 2（CVV2）。
|
`IDNumber`
String
|
持卡人**ID号码**。
|
`RandomNumber`
String
|
暂无更多信息。
|
`PrimaryId`
String
|
主要品牌 ID。
|
`PrimaryDescription`
String
|
主要品牌描述。
|
`SecondaryId`
String
|
次要品牌 ID。
|
`SecondaryDescription`
String
|
次要品牌描述。
|
`CardHolderName`
String
|
持卡人姓名。
|
`IsDebitCard`
Bool
|
表示该卡为借记卡还是预付卡。
|
`IsGatewayTimeout`
Bool
|
指示是否发生**网关超时**（响应中有效）。
|
`ProviderExternalData`
String
|
来自提供商的外部数据，**格式为 JSON 字符串**。
|
`IsRevalueCard`
Bool
|
指示该卡是否**允许重新估值**。
|
商品和项目详情
`Code`
Int(16)
|
在 Nayax 后台或自动售货机中定义的所选商品代码。
|
`CatalogProductId`
String(100)
|
所选商品的外部唯一标识符（产品目录编号）。
|
`Name`
String(255)
|
在 Nayax 后台中定义的产品名称。
|
`Price`
Double
|
以机器所在货币表示的原始产品价格。注意:交易金额是经调整后的计费价格。
|
`UnitOfMeasurement`
String(64)
|
产品的计量单位（例如 “unit” 或 “Liter”）。
|
`Measurement`
Double
|
产品数量（以计量单位表示）。
|
`Group`
String(255)
|
产品在产品映射表(product map)中存在的组名称。
|
`ProductGroupId`
String(255)
|
产品在产品映射表(product map)中存在的组代码。
|
`PulseLineNumber`
Int(32)
|
用于通过脉冲(pulse)支持多台机器实现远程出货功能。必须为正整数 $(\ge 0)$。
|
机器与 Actor 信息
`SiteId`
Int(16)
|
**Nayax服务器**区域。
|
`MachineAuTime`
String
|
机器授权时间戳。
|
`TimeoutMS`
Int(32)
|
Nayax 服务器超时配置（单位：毫秒）。
|
`IsProductSelected`
Bool
|
指示商品是否已被预先选定。
|
`PaymentMethodID`
Int(32)
|
支付提供商的 Nayax 标识符。
|
`BillingProviderId`
Int(32)
|
计费提供商的 Nayax 标识符。
|
`AuditNumber`
Int(64)
|
仅供 Nayax 内部使用。
|
`IsDeferredAuthorization`
Bool
|
暂无更多信息。
|
`AgeLimitation`
Int(16)
|
允许交易所需的最低年龄。
|
`IsSoftDeclineCompletion`
Bool
|
暂无更多信息。
|
`TransitTransactionType`
Int(32)
交通交易类型(枚举值):
1:预付款
2:实时授权
3:后授权/聚合交易
7:债务追偿
|
`DenyListIndication`
Int(32)
指示对消费者 Deny List 状态的影响(枚举值):
0:未知/无影响
1:拒绝会导致该消费者被添加到拒绝名单。
2:批准会导致该消费者从拒绝名单中移除。
|
`HwSerial`
String
|
Nayax 设备**硬件序列号**。
|
`FWVersion`
String
|
设备固件版本。
|
`Type`
String
|
Nayax 设备类型。
|
`Id`
Int(64)
|
机器实体的唯一 ID。
|
`Name`
String(255)
|
机器名称。
|
`ExternalId`
String(200)
|
机器外部 ID(机器编号 - 运营商)。
|
`Type`
String(50)
|
机器类型(Machine Type)。
|
`TerminalId`
String(255)
|
**终端标识符**。请联系 Nayax TPOC 进行定义。
|
`DecimalPlace`
Int(64)
|
金额的**小数点位置**。
|
`Offset`
String(255)
|
UTC 时区偏移量。
|
`GroupId`
String
|
仅供 Nayax 内部使用。
|
`OperatorId`
String(255)
|
**商户 ID** （字符串格式）。
|
`Region`
String(255)
|
机器所在地区。
|
`City`
String(255)
|
机器所在城市。
|
`ZipCode`
String(255)
|
机器**邮政编码**。
|
`Name`
String
|
国家全称（用于机器位置）。
|
`NumericCode`
String(3)
|
ISO-3166-1 Numeric-3 代码。
|
`Alpha2Code`
String(2)
|
ISO-3166-1 Alpha-2 代码。
|
`Alpha3Code`
String(3)
|
ISO-3166-1 Alpha-3 代码。
|
`Intra`
String
|
区域内分区(Intra Region,跨国地理多样化)。
|
`State`
String
|
演员地理位置**代码**。
|
`City`
String(255)
|
演员地理**城市**。
|
`CountryCode`
String
|
演员地理位置**国家代码（ISO3）** 。
|
`ZipCode`
String(255)
|
演员地理位置**邮政编码**。
|
`Address`
String(255)
|
演员地理位置**地址**。
|
`Latitude`
String
|
机器位置**纬度**。
|
`Longitude`
String
|
机器位置**经度**。
|
`Id`
Int(64)
|
Actor ID。
|
`Name`
String(255)
|
直接商户名称。
|
`OperatorId`
Int(64)
|
**商户运营商 ID** （整数格式）。
|
`OperatorName`
String
|
商户运营商名称。
|
`MerchantId`
Int(64)
|
**商户 ID** 。请联系 Nayax TPOC 进行定义。
|
`DynamicURL`
String
|
参与方级别的 URL 配置。
|
`MCC`
Int(32)
|
商户类别代码(MCC),对业务类型进行分类。
|
`SubMerchantId`
String(255)
|
子商户标识符。请联系 Nayax TPOC 以进行定义。
|
`DirectActor`
String
|
直接演员**自定义数据**（ **JSON 格式**的字符串）。
|
`Operator`
String
|
操作员**自定义数据**（ **JSON 格式**的字符串）。
|
`Distributor`
String
|
分销商**自定义数据**（ **JSON 格式**的字符串）。
|
`Actor`
String
|
演员**自定义数据**（ **JSON 格式**的字符串）。
|
`Machine`
String
|
机器**自定义数据**（ **JSON 格式**的字符串）。
|
`SoftDecline`
String
|
软拒绝自定义数据(以 JSON 格式表示的字符串)。
|