Skip to main content
Cortina DQR 使用 Inquiry 查询交易 ID 的批准状态。此调用将包含交易的最终金额以及在 GenerateQR 调用中生成的交易 ID。对此调用的“Approved”响应通常会尝试出售/释放产品。“Decline”将终止该交易,而“Pending”响应将在预定义的时间后触发后续的 Inquiry 请求。 Cortina 支付提供商应验证该信息,并相应地以待在 Nayax 设备上显示的动态 QR 信息作出响应。 该命令在整个授权流程期间都至关重要。

​
要求

Nayax 的服务器向您配置的 Inquiry 端点发送 POST 请求,格式如下: (customer's URL)/Cortina/DynamicQR/Inquiry 该负载（payload）包含读卡操作的完整结果：

​
请求参数

下表描述了请求正文中包含的参数： 字段 类型 描述交易标识符和参考信息TransactionId String(36)NayaxTransactionId Int(64)SrvTranId StringRRN StringAuthCode String(40)Token String(256)TraceNumber StringAuthSource String(5)财务与货币详情Amount DoubleAuthAmount DoubleSettAmount DoubleCurrencyCode String(3)CurrencyNumeric String(3)时间与系统状态AuthDateTime StringSettDateTime DoubleIsGatewayTimeout BoolIsLastPolling BoolPollingAttemptCounter Int(32)机器及位置详情SiteId Int(16)HwSerial StringFWVersion StringType StringId Int(64)Name String(255)TerminalId String(255)DecimalPlace Int(64)Offset String(255)GroupId StringOperatorId String(255)ZipCode String(255)国家和 Actor 地理详细信息Name StringNumericCode String(3)Alpha2Code String(2)Alpha3Code String(3)Id Int(64)Name String(255)OperatorId Int(64)OperatorName StringMerchantId Int(64)商品和项目详情Code Int(16)CatalogProductId String(100)Name String(255)Price DoubleUnitOfMeasurement String(64)Measurement DoubleGroup String(255)ProductGroupId String(255)PulseLineNumber Int(32)自定义数据（JSON 字符串）DirectActor StringOperator StringDistributor StringActor StringMachine StringAdditionalData String
此交易的唯一标识符。
    如果使用了 /StartSession，则回显其加密后的 ID。 否则，将由 Nayax Engine 生成此值。
Nayax 内部交易的唯一 ID ，在后续请求中会重复出现。
集成商的内部交易 ID 。
    条件性：如果未使用 /StartSession，则为必填字段。 如果使用了 /StartSession，则该字段应为空，或回显交易 ID（Transaction ID）。
参考检索编号（RRN） 。建议向消费者/持卡人公开，以便获得支持。
外部授权码（通常来自发卡行的银行）。
交易的唯一令牌。仅供 Nayax 内部使用。
追踪编号。仅供Nayax内部使用。
仅供 Nayax 内部使用。
付款金额（以美分为单位，最多保留 3 位小数）。
    示例：1 分 = 0.01。 注意：没有小数位的货币仍以 double 类型表示（例如，234 JYN = 234.0）。
/Authorization 请求中所请求的原始金额。是否显示取决于 /Authorization 的响应。
/Settlement 或 /Sale 流程中请求的原始金额。与 Authorization 无关。
ISO 4217 Alpha-3格式的货币代码。
ISO 4217 数字-3格式的货币代码。
/Authorization 发生的日期和时间。格式：ddMMyyHHmmss。
结算日期/时间。与授权命令无关。
指示是否发生网关超时（响应中有效）。
表示是否为最后一次轮询尝试的标志。
当前的轮询尝试次数。
Nayax服务器区域。
Nayax 设备硬件序列号。
设备固件版本。
Nayax 设备类型。
机器实体的唯一 ID。
机器名称。
终端标识符。请联系 Nayax TPOC 进行定义。
金额的小数点位置。
UTC 时区偏移量。
仅供 Nayax 内部使用。
商户 ID （字符串格式）。
机器邮政编码。
国家全称。
ISO-3166-1 Numeric-3 代码。
ISO-3166-1 Alpha-2 代码。
ISO-3166-1 Alpha-3 代码。
Actor ID。
直接商户名称。
商户运营商 ID （整数格式）。
商户运营商名称。
商户 ID 。请联系 Nayax TPOC 进行定义。
所选商品的代码。
所选商品的外部唯一标识符（产品目录编号）。
商品名称。
以机器货币计的原始商品价格。
    注意:交易金额是经调整后的计费价格。
产品的计量单位（例如 “unit” 或 “Liter”）。
产品数量（以计量单位表示）。
商品的分组名称。
商品的分组代码。
用于通过脉冲(pulse)支持远程出货功能。必须为正整数 (≥0)(\ge 0)。
直接演员自定义数据（ JSON 格式的字符串）。
操作员自定义数据（ JSON 格式的字符串）。
分销商自定义数据（ JSON 格式的字符串）。
演员自定义数据（ JSON 格式的字符串）。
机器自定义数据（ JSON 格式的字符串）。
通用自定义数据字符串， JSON 格式。

​
回复

客户支付方式将发送给 Nayax 服务器的 Inquiry 响应。 通常响应会是“Approved”或带有代码 993(表示“pending”,即支付提供商仍在决定是否批准该消费者,等待“Approved”/“Declined”的最终响应)的“Declined”。在“pending”响应的情况下,Nayax 服务器将持续轮询,直到收到最终响应(“Approved”/“Declined”)或达到 Nayax Core 中配置的限制为止。 有效载荷应如下所示：

​
响应参数

下表描述了 API 响应中返回的字段： 字段 类型 描述交易状态及错误代码Verdict StringCode Int(32)StatusMessage String(255)CustomDeclineCode String财务和时间详情AuthAmount DoubleSettAmount DoubleAuthDateTime StringSettDateTime Double交易标识符和参考信息SrvTranId StringAuthCode String(40)RRN StringToken String(256)TraceNumber StringAuthSource String(5)InitiateTranReference Int(64)系统和外部数据AdditionalData StringIsGatewayTimeout BoolProviderExternalData StringIsRevalueCard Bool
请求的最终状态。必须是以下常量字符串值之一：
  • Approved
  • Declined
拒绝代码（Decline Code）。条件性字段——仅当 Verdict 为 “Declined” 时才会出现。有效的拒绝代码包括：
    1:余额不足 5:疑似欺诈 6:一般系统故障 7:金额无效 8/998:格式/解析错误或验证错误 992:超时异常 997:缺少必填参数 999:一般异常 993:Pending(仅与 Inquiry 相关) 其他状态及技术错误请参阅完整列表。
包含交易状态消息或有关结果的其他不同数据的自由文本字段。
用于指定自定义拒绝代码（例如与 Soft Decline 或 Switch Interface 相关的代码）。可能反映收单机构（acquirer）的响应代码。
/Authorization 请求中所请求的原始金额。
/Settlement 或 /Sale 流程中请求的原始金额。与 Authorization 命令无关。
/Authorization 发生的日期和时间。格式：ddMMyyHHmmss。
结算日期/时间。与授权命令无关。
集成商的内部交易 ID 。
    条件性：如果未使用 /StartSession，则为必填字段。 如果使用了 /StartSession，则该字段应为空，或回显交易 ID（Transaction ID）。
外部授权码（通常来自发卡行的银行）。
检索参考号（RRN）。强烈建议向消费者/持卡人展示，以便提供支持。
交易的唯一令牌。仅供 Nayax 内部使用。
追踪编号。仅供Nayax内部使用。
仅供 Nayax 内部使用。
条件：反映预付会员卡重新尝试的原始 Nayax 交易 ID 。
附加数据字符串， JSON 格式。请联系 Nayax TPOC 进行定义。
指示是否发生网关超时（响应中有效）。
来自提供商的外部数据，格式为 JSON 字符串。
指示该卡是否允许重新估值。