Skip to main content
Cortina SQR 使用 Sale 命令通知集成方在产品被选定后刷卡的结果,以启动与 Cortina 支付提供商的授权流程。 此命令对于进行交易确认或拒绝处理至关重要。

​
要求

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

​
请求参数

下表描述了请求正文中包含的参数： 字段 类型 描述交易标识符和状态TransactionId String(36)NayaxTransactionId Int(64)SrvTranId StringRRN StringAuthCode String(40)Token String(256)TraceNumber StringAuthSource String(5)InitiateTranReference Int(64)财务和时间详情Amount DoubleAuthAmount DoubleSettAmount DoubleAuthDateTime StringSettDateTime Double机器及位置详情SiteId Int(16)Id Int(64)Name String(255)TerminalId String(255)DecimalPlace Int(64)Offset String(255)GroupId StringOperatorId String(255)国家和 Actor 地理详细信息Name StringNumericCode String(3)Alpha2Code String(2)Alpha3Code String(3)Intra StringId Int(64)Name String(255)OperatorId Int(64)OperatorName StringMerchantId Int(64)DynamicURL String自定义数据（JSON 字符串）和系统标志DirectActor StringOperator StringDistributor StringActor StringMachine StringAdditionalData StringIsGatewayTimeout Bool卡片及支付详情CardNumber StringEntryMode String(4)ExpYear StringExpMonth StringEMVData StringCVV2 StringIDNumber StringRandomNumber StringPrimaryId StringPrimaryDescription StringSecondaryId StringSecondaryDescription StringCardHolderName String
此交易的唯一标识符。
    如果使用了 /StartSession，则回显其加密后的 ID。 否则，将由 Nayax Engine 生成此值。
Nayax 内部交易的唯一 ID ，在后续请求中会重复出现。
集成商的内部交易 ID 。
    条件性：如果未使用 /StartSession，则为必填字段。 如果使用了 /StartSession，则该字段应为空，或回显交易 ID（Transaction ID）。
参考检索编号（RRN） 。建议向消费者/持卡人公开，以便获得支持。
外部授权码（通常来自发卡行的银行）。
交易的唯一令牌。仅供 Nayax 内部使用。
追踪编号。仅供Nayax内部使用。
仅供 Nayax 内部使用。
条件：反映预付会员卡重新尝试的原始 Nayax 交易 ID 。
付款金额（以美分为单位，最多保留 3 位小数）。
    示例：1 分 = 0.01。 注意：没有小数位的货币仍以 double 类型表示（例如，234 JYN = 234.0）。
/Authorization 请求中所请求的原始金额。是否显示取决于 /Authorization 的响应。
/Settlement 或 /Sale 流程中请求的原始金额。与 Authorization 无关。
/Authorization 发生的日期和时间。格式：ddMMyyHHmmss。
结算日期/时间。与授权命令无关。
Nayax服务器区域。
机器实体的唯一 ID。
机器名称。
终端标识符。请联系 Nayax TPOC 进行定义。
金额的小数点位置。
UTC 时区偏移量。
仅供 Nayax 内部使用。
商户 ID （字符串格式）。
国家全称。
ISO-3166-1 Numeric-3 代码。
ISO-3166-1 Alpha-2 代码。
ISO-3166-1 Alpha-3 代码。
用于跨国地理多元化的区域内(Intra Region,例如“European Union”)。
Actor ID。
直接商户名称。
商户运营商 ID （整数格式）。
商户运营商名称。
商户 ID 。请联系 Nayax TPOC 进行定义。
参与方级别的 URL 配置。
直接演员自定义数据（ JSON 格式的字符串）。
操作员自定义数据（ JSON 格式的字符串）。
分销商自定义数据（ JSON 格式的字符串）。
演员自定义数据（ JSON 格式的字符串）。
机器自定义数据（ JSON 格式的字符串）。
通用自定义数据字符串， JSON 格式。
指示是否发生网关超时（响应中有效）。
根据交易类型提供的卡片信息：
    对于卡片在场（card-present）的 Authorization/Sale，为完整的 Track 2 数据。 对于其他交易类型，仅为卡号（Card PAN）。
卡片信息的读取方式：
    MCR：磁条读取（刷卡） CON：接触式芯片（插卡） CLS：非接触式芯片（挥卡） NFC：手机/移动设备非接触式 QR：由 DOT 读取的二维码 有关特定边缘情况，请咨询 Nayax POC。
卡片到期年份（ YY格式）。条件性（仅当接口为 1 或 10 时）。
卡片到期月份（ MM格式）。条件性（仅当接口为 1 或 10 时）。
EMV标签数据采用TLV（标签长度-值）格式。
卡验证值 2（CVV2）。
持卡人ID号码。
暂无更多信息。
主要品牌 ID。
主要品牌描述。
次要品牌 ID。
次要品牌描述。
持卡人姓名。

​
回复

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

​
响应参数

下表描述了 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)忠诚度及系统详情RegularCreditType Int(32)RegularCredit DoubleRevalueCredit Int(32)IsRevalueCard BoolIsGatewayTimeout BoolProviderExternalData String
表示请求最终状态的常量字符串：
  • Approved
  • Declined
拒绝代码（Decline Code）。条件性字段——仅当 Verdict 为 “Declined” 时才会出现。有效代码包括：
    1：余额不足 5：疑似欺诈 6：系统一般性故障 7：金额无效 8 / 998：格式/解析错误或验证错误 992：超时异常 997：缺少必填参数 999：一般性异常 有关其他状态和内部错误（例如 40、990、1011），请参阅完整列表。
包含交易状态消息或有关结果的其他不同数据的自由文本字段。
用于指定自定义拒绝代码（例如与 Soft Decline 或 Switch Interface 相关的代码）。可能反映收单机构（acquirer）的响应代码。
/Sale Request 中请求的原始金额。
/Sale Request 中请求的原始金额。
/Authorization 发生的日期和时间。格式：ddMMyyHHmmss。
结算日期/时间。与授权命令无关。
集成商的内部交易 ID 。
    条件性：如果未使用 /StartSession，则为必填字段。 如果使用了 /StartSession，则该字段应为空，或回显交易 ID（Transaction ID）。
外部授权码（通常来自发卡行的银行）。
参考检索编号（RRN） 。建议向消费者/持卡人公开，以便获得支持。
交易的唯一令牌。仅供 Nayax 内部使用。
追踪编号。仅供Nayax内部使用。
仅供 Nayax 内部使用。
条件：反映预付会员卡重新尝试的原始 Nayax 交易 ID 。
定义 RegularCredit 的计量单位（枚举值）：
    0：信用额度以交易次数计（count）。 1：信用额度以金额计（currency）。
根据 RegularCreditType 计算的常规信用额度值（金额或交易次数）。使用小数位数 2。
重新估值信用额度。仅当关联的卡配置为可重新估值时才会显示。
指示该卡是否允许重新估值。
指示是否发生网关超时（响应中有效）。
来自提供商的外部数据，格式为 JSON 字符串。