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

​
要求

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

​
请求参数

下表描述了请求正文中包含的参数：
字段 类型 描述交易状态与核心标识符Verdict StringCode Int(32)StatusMessage String(255)TransactionId String(36)NayaxTransactionId Int(64)SrvTranId StringRRN StringToken String(256)TraceNumber StringAuthSource String(5)InitiateTranReference Int(64)财务详情、卡片信息与时间戳Amount DoubleAuthAmount DoubleSettAmount DoubleAuthCode String(40)CurrencyCode String(3)CurrencyNumeric String(3)AuthDateTime StringSettDateTime DoubleCardNumber StringEntryMode String(4)ExpYear StringExpMonth StringEMVData StringCVV2 StringIDNumber StringRandomNumber StringPrimaryId StringPrimaryDescription StringSecondaryId StringSecondaryDescription StringCardHolderName StringIsDebitCard BoolIsGatewayTimeout BoolProviderExternalData StringIsRevalueCard Bool商品和项目详情Code Int(16)CatalogProductId String(100)Name String(255)Price DoubleUnitOfMeasurement String(64)Measurement DoubleGroup String(255)ProductGroupId String(255)PulseLineNumber Int(32)机器与 Actor 信息SiteId Int(16)MachineAuTime StringTimeoutMS Int(32)IsProductSelected BoolPaymentMethodID Int(32)BillingProviderId Int(32)AuditNumber Int(64)IsDeferredAuthorization BoolAgeLimitation Int(16)IsSoftDeclineCompletion BoolTransitTransactionType Int(32)DenyListIndication Int(32)HwSerial StringFWVersion StringType StringId Int(64)Name String(255)ExternalId String(200)Type String(50)TerminalId String(255)DecimalPlace Int(64)Offset String(255)GroupId StringOperatorId String(255)Region String(255)City String(255)ZipCode String(255)Name StringNumericCode String(3)Alpha2Code String(2)Alpha3Code String(3)Intra StringState StringCity String(255)CountryCode StringZipCode String(255)Address String(255)Latitude StringLongitude StringId Int(64)Name String(255)OperatorId Int(64)OperatorName StringMerchantId Int(64)DynamicURL StringMCC Int(32)SubMerchantId String(255)DirectActor StringOperator StringDistributor StringActor StringMachine StringSoftDecline String
请求的最终状态。必须是以下常量字符串值之一：
  • Approved
  • Declined
拒绝代码（Decline Code）。条件性字段——仅当 Verdict 为 “Declined” 时才会出现。有效的拒绝代码包括：
    1:余额不足 5:疑似欺诈 6:一般系统故障 997:缺少必填参数 999:一般异常 完整代码列表请参阅完整文档。
包含交易状态消息或有关结果的其他不同数据的自由文本字段。
此交易的唯一标识符。
    如果使用了 /StartSession，则回显其中的加密 ID。 否则，该值由 Nayax Engine 生成。
Nayax 内部交易的唯一 ID ，在后续请求中会重复出现。
集成商的内部交易 ID 。
    条件性字段:仅当未使用 /StartSession 时为必填项。 若已使用,该字段应为空,或回传交易 ID。
参考检索号(Reference Retrieval Number)。供第三方使用的外部交易 ID。强烈建议对消费者/持卡人可见。
唯一的交易令牌。仅供 Nayax 内部使用。
跟踪号。仅供 Nayax 内部使用。
仅供 Nayax 内部使用。
条件：反映预付会员卡重新尝试的原始 Nayax 交易 ID 。
付款金额（以美分为单位，最多保留 3 位小数）。
    示例:1 分 = 0.01。 没有小数位的货币(例如 JYN)仍以双精度浮点数表示(例如 234.0)。
在 /SaleRequest 中请求的原始金额。取决于 /Sale 响应。
在 /SaleRequest 中请求的原始金额。取决于 /Sale 响应。
外部授权码（通常来自发卡行的银行）。
ISO 4217 Alpha-3格式的货币代码。
ISO 4217 数字-3格式的货币代码。
/Sale 发生的日期和时间。格式:ddMMyyHHmmss。取决于 /Sale 响应的条件性字段。
结算日期/时间(Settlement Date/Time)。取决于 /Sale 响应的条件性字段。
根据交易类型提供的卡片信息：
    刷卡授权/销售的完整 Track 2 数据。 其他交易类型(例如退款、结算)仅提供卡号(PAN)。
注意： 卡片详细信息使用设备读取卡片时的相同格式。对于 Mifare 卡,Track 2 数据为十六进制。对于磁条卡,Track 2 数据为 ASCII。
卡片详细信息的读取方式。常见值:
    MCR:磁条读取 CON:接触式芯片(插卡) CLS:非接触式芯片(轻触) NFC:手机/移动设备非接触式 QR:QR 码读取
卡片到期年份（ YY格式）。条件性（仅当接口为 1 或 10 时）。
卡片到期月份（ MM格式）。条件性（仅当接口为 1 或 10 时）。
EMV标签数据采用TLV（标签长度-值）格式。
卡验证值 2（CVV2）。
持卡人ID号码。
暂无更多信息。
主要品牌 ID。
主要品牌描述。
次要品牌 ID。
次要品牌描述。
持卡人姓名。
表示该卡为借记卡还是预付卡。
指示是否发生网关超时（响应中有效）。
来自提供商的外部数据，格式为 JSON 字符串。
指示该卡是否允许重新估值。
在 Nayax 后台或自动售货机中定义的所选商品代码。
所选商品的外部唯一标识符（产品目录编号）。
在 Nayax 后台中定义的产品名称。
以机器所在货币表示的原始产品价格。注意:交易金额是经调整后的计费价格。
产品的计量单位（例如 “unit” 或 “Liter”）。
产品数量（以计量单位表示）。
产品在产品映射表(product map)中存在的组名称。
产品在产品映射表(product map)中存在的组代码。
用于通过脉冲(pulse)支持多台机器实现远程出货功能。必须为正整数 (≥0)(\ge 0)。
Nayax服务器区域。
机器授权时间戳。
Nayax 服务器超时配置（单位：毫秒）。
指示商品是否已被预先选定。
支付提供商的 Nayax 标识符。
计费提供商的 Nayax 标识符。
仅供 Nayax 内部使用。
暂无更多信息。
允许交易所需的最低年龄。
暂无更多信息。
交通交易类型(枚举值):
    1:预付款 2:实时授权 3:后授权/聚合交易 7:债务追偿
指示对消费者 Deny List 状态的影响(枚举值):
    0:未知/无影响 1:拒绝会导致该消费者被添加到拒绝名单。 2:批准会导致该消费者从拒绝名单中移除。
Nayax 设备硬件序列号。
设备固件版本。
Nayax 设备类型。
机器实体的唯一 ID。
机器名称。
机器外部 ID(机器编号 - 运营商)。
机器类型(Machine Type)。
终端标识符。请联系 Nayax TPOC 进行定义。
金额的小数点位置。
    示例：2 表示金额格式类似 123.45。
UTC 时区偏移量。
仅供 Nayax 内部使用。
商户 ID （字符串格式）。
机器所在地区。
机器所在城市。
机器邮政编码。
国家全称（用于机器位置）。
ISO-3166-1 Numeric-3 代码。
ISO-3166-1 Alpha-2 代码。
ISO-3166-1 Alpha-3 代码。
区域内分区(Intra Region,跨国地理多样化)。
演员地理位置代码。
演员地理城市。
演员地理位置国家代码（ISO3） 。
演员地理位置邮政编码。
演员地理位置地址。
机器位置纬度。
机器位置经度。
Actor ID。
直接商户名称。
商户运营商 ID （整数格式）。
商户运营商名称。
商户 ID 。请联系 Nayax TPOC 进行定义。
参与方级别的 URL 配置。
商户类别代码(MCC),对业务类型进行分类。
子商户标识符。请联系 Nayax TPOC 以进行定义。
直接演员自定义数据（ JSON 格式的字符串）。
操作员自定义数据（ JSON 格式的字符串）。
分销商自定义数据（ JSON 格式的字符串）。
演员自定义数据（ JSON 格式的字符串）。
机器自定义数据（ JSON 格式的字符串）。
软拒绝自定义数据(以 JSON 格式表示的字符串)。

​
回复

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

​
响应参数

下表描述了 API 响应中返回的字段：
字段 类型 描述Verdict StringCode Int(32)StatusMessage String(255)CustomDeclineCode StringSrvTranId StringAuthCode String(40)AuthAmount DoubleSettAmount DoubleRRN StringToken String(256)AuthDateTime StringSettDateTime DoubleTraceNumber StringAuthSource String(5)AdditionalData StringIsGatewayTimeout BoolProviderExternalData StringInitiateTranReference Int(64)IsRevalueCard Bool
请求的最终状态。必须是以下常量字符串值之一：
  • Approved
  • Declined
拒绝代码。条件性字段——仅当 Verdict 为 ‘Declined’ 时才存在。常见代码包括：
    1:余额不足 5:疑似欺诈 6:一般系统故障 7:金额无效 992:超时异常 997:缺少必填参数 999:一般异常 其他状态及技术错误请参阅完整列表。
包含交易状态消息或有关结果的其他不同数据的自由文本字段。
用于指定自定义拒绝代码（例如与 Soft Decline 或 Switch Interface 相关的代码）。可能反映收单机构（acquirer）的响应代码。
集成商的内部交易 ID 。
    条件性：如果未使用 /StartSession，则为必填字段。 如果使用了 /StartSession，则该字段应为空，或回显交易 ID（Transaction ID）。
外部授权代码（通常来自发卡行）。
/Sale Request 中请求的原始金额。
/Sale Request 中请求的原始金额。
参考检索号(Reference Retrieval Number)。供第三方使用的外部交易 ID。强烈建议对消费者/持卡人可见。
交易的唯一令牌。仅供 Nayax 内部使用。
/Authorization 发生的日期和时间。格式：ddMMyyHHmmss。
结算日期/时间。与授权命令无关。
跟踪号。仅供 Nayax 内部使用。
仅供 Nayax 内部使用。
附加数据字符串， JSON 格式。请联系 Nayax TPOC 进行定义。
指示是否发生网关超时（响应中有效）。
来自提供商的外部数据，格式为 JSON 字符串。
条件：反映预付会员卡重新尝试的原始 Nayax 交易 ID 。
指示该卡是否允许重新估值。