生成二维码

Cortina DQR 使用 GenerateQR 命令通知集成方有关消费者产品选择的信息,以便其发送 QR 生成详情。该命令包括交易 ID 标识(在 /StartSession 中生成)、所需金额、商户及机器详情(以及更多信息)。Cortina 支付提供商应验证该信息,并相应地以待在 Nayax 设备上显示的动态 QR 信息作出响应。该命令对于进入授权流程至关重要。

要求

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

{
  "ChannelId": 19,
  "BasicInfo": {
    "TransactionId": "236584335969834429321847829253667359,",
    "Amount": 0.1,
    "CurrencyCode": "USD",
    "CurrencyNumeric": 376,
    "SiteId": 12
  },
  "DeviceInfo": null,
  "MachineInfo": {
    "Id": 869761713,
    "Name": "TestPayDynamicQR V2",
    "TerminalId": 987654321,
    "DecimalPlace": 2,
    "Offset": 2,
    "GroupId": "Beverages",
    "OperatorId": 12345,
    "ZipCode": 10001,
    "Country": {
      "Name": "United States of America",
      "NumericCode": 840,
      "Alpha2Code": "US",
      "Alpha3Code": "USA"
    }
  },
  "ActorInfo": {
    "Id": 2001102296,
    "Name": "Far East Dev Zone",
    "OperatorId": 2000305191,
    "OperatorName": "TanyaT_OP",
    "MerchantId": 10011
  },
  "CustomData": {
    "DirectActor": 12312312,
    "Operator": 123121434134,
    "Distributor": "superDistributor",
    "Actor": 12312312,
    "Machine": 131231348
  },
  "Product": [
    {
      "Code": 11,
      "Name": "Stella",
      "Price": 0.1,
      "UnitOfMeasurement": "USD",
      "Measurement": 1
    },
    {
      "Code": 456,
      "Name": "expensiveSprite",
      "Price": 600,
      "UnitOfMeasurement": "USD",
      "Measurement": 0
    }
  ]
}

请求参数

下表描述了请求正文中包含的参数：字段类型描述交易标识符和状态TransactionId String(36)NayaxTransactionId Int(64)SrvTranId StringRRN StringToken String(256)TraceNumber StringAuthSource String(5)财务和时间详情Amount DoubleAuthAmount DoubleSettAmount DoubleAuthCode String(40)CurrencyCode String(3)CurrencyNumeric String(3)AuthDateTime StringSettDateTime Double机器及位置详情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)国家/地区 ISO 代码Name StringNumericCode String(3)Alpha2Code String(2)Alpha3Code String(3)参与方(商户/运营商)详情Id Int(64)Name String(255)OperatorId Int(64)OperatorName StringMerchantId Int(64)Actor 地理详情State StringCity String(255)CountryCode StringZipCode String(255)Address String(255)Longitude StringLatitude String商品/项目详情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 进行定义。
演员地理位置代码。
演员地理城市。
演员地理位置国家代码（ISO3）。
演员地理位置邮政编码。
演员地理位置地址。
机器位置经度。
机器位置纬度。
所选商品的代码。
所选商品的外部唯一标识符（产品目录编号）。
商品名称。
以机器货币计的原始商品价格。注意:交易金额是经调整(例如附加费、忠诚度调整)后的计费价格。
产品的计量单位（例如 “unit” 或 “Liter”）。
产品数量（以计量单位表示）。
商品的分组名称。
商品的分组代码。
用于通过脉冲(pulse)支持远程出货功能。必须为正整数 $(\ge 0)$ 。
直接演员自定义数据（ JSON 格式的字符串）。
操作员自定义数据（ JSON 格式的字符串）。
分销商自定义数据（ JSON 格式的字符串）。
演员自定义数据（ JSON 格式的字符串）。
机器自定义数据（ JSON 格式的字符串）。
通用自定义数据字符串， JSON 格式。

客户支付方式将发送给 Nayax 服务器的 GenerateQR 响应。负载应如下所示:

{
  "QRCode": "QR_URL_to_be_presented_on_the_device's_screen",
  "QRData": {
    "ChannelId": "19",
    "RRN": "111111",
    "SrvTranId": "236584335969834429321847829253667359"
  },
  "Status": {
    "Verdict": "Approved",
    "Code": 0,
    "StatusMessage": "Cortina V2 Stub Tester"
  },
  "additionalProperties": false
}

响应参数

下表描述了 API 响应中返回的字段：字段类型描述核心标识符与状态QRCode StringChannelId StringVerdict StringCode Int(32)StatusMessage String(255)CustomDeclineCode StringSrvTranId StringRRN String财务和时间详情AuthCode String(40)AuthAmount DoubleSettAmount DoubleAuthDateTime StringSettDateTime Double系统和条件标志Token String(256)TraceNumber StringAuthSource String(5)AdditionalData StringIsGatewayTimeout BoolProviderExternalData StringInitiateTranReference Int(64)IsRevalueCard Bool

提供给设备显示/交互使用的 QR URL。
多渠道集成的条件性字段。回传 Nayax 在请求中提供的值。
请求的最终状态。必须是以下常量字符串值之一： `Approved` `Declined`
拒绝代码。条件性字段——仅当 `Verdict` 为 ‘Declined’ 时才存在。常见代码包括： 1:余额不足 5:疑似欺诈 6:一般系统故障 7:金额无效 8/998:格式/解析错误或验证错误 992:超时异常 997:缺少必填参数 999:一般异常其他状态及技术错误请参阅完整列表。
包含交易状态消息或有关结果的其他不同数据的自由文本字段。
用于指定自定义拒绝代码（例如与 Soft Decline 或 Switch Interface 相关的代码）。可能反映收单机构（acquirer）的响应代码。
集成商的内部交易 ID 。条件性：如果未使用 `/StartSession`，则为必填字段。如果使用了 /StartSession，则该字段应为空，或回显交易 ID（Transaction ID）。
检索参考号（RRN）。用作外部方(例如卡组织)的外部交易 ID。强烈建议对消费者/持卡人可见,以便支持。该值必须在 `/Inquiry` 请求中回传。
外部授权码（通常来自发卡行的银行）。
`/Authorization` 请求中所请求的原始金额。
`/Settlement` 或 `/Sale` 流程中请求的原始金额。与 Authorization 命令无关。
`/Authorization` 发生的日期和时间。格式：`ddMMyyHHmmss`。
结算日期/时间。与授权命令无关。
交易的唯一令牌。仅供 Nayax 内部使用。
追踪编号。仅供Nayax内部使用。
仅供 Nayax 内部使用。
附加数据字符串， JSON 格式。请联系 Nayax TPOC 进行定义。
指示是否发生网关超时（响应中有效）。
来自提供商的外部数据，格式为 JSON 字符串。
条件：反映预付会员卡重新尝试的原始 Nayax 交易 ID 。
指示该卡是否允许重新估值。

Cortina Guides

API Reference

要求

请求参数

回复

响应参数

​要求

​请求参数

​回复

​响应参数

要求

请求参数

回复

响应参数