Skip to main content
Cortina 预付使用 Settlement 命令通知集成方设备端结算流程的结果(即产品已出售),以便与 Cortina 支付提供商发起结算流程。 此命令对于进行交易确认或拒绝处理至关重要。

​
要求

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

​
请求参数

下表描述了请求正文中包含的参数：
字段 类型 描述交易标识符和状态TransactionId String(36)NayaxTransactionId Int(64)SrvTranId StringRRN StringToken String(256)TraceNumber StringAuthSource String(5)财务详情与金额Amount DoubleAuthAmount DoubleSettAmount DoubleCurrencyCode String(3)CurrencyNumeric String(3)DecimalPlace Int(64)AuthCode String(40)时间戳与标志MachineAuTime StringTimeoutMS Int(32)Offset String(255)AuthDateTime StringSettDateTime DoubleIsGatewayTimeout Bool卡片及支付详情CardNumber StringEntryMode String(4)ExpYear StringExpMonth StringEMVData StringIDNumber StringRandomNumber StringPrimaryId StringPrimaryDescription StringSecondaryId StringCardHolderName String商品/项目详情IsProductSelected BoolCode Int(16)CatalogProductId String(100)Name String(255)Price DoubleUnitOfMeasurement String(64)Measurement DoubleGroup String(255)ProductGroupId String(255)PulseLineNumber Int(32)机器和设备信息HwSerial StringFWVersion StringType StringId Int(64)Name String(255)TerminalId String(255)机器位置(Machine Location)SiteId Int(16)Region String(255)City String(255)ZipCode String(255)Latitude StringLongitude String参与方(商户/运营商)详情Id Int(64)Name String(255)OperatorId String(255)OperatorId Int(64)OperatorName StringMerchantId Int(64)DynamicURL StringState StringCity String(255)CountryCode StringZipCode String(255)Address String(255)国家信息(ISO 3166-1)Name StringNumericCode String(3)Alpha2Code String(2)Alpha3Code String(3)Intra String自定义数据（JSON 字符串）GroupId StringDirectActor StringOperator StringDistributor StringActor StringMachine StringAdditionalData String
此交易的唯一标识符。
    如果使用了 /StartSession，则回显其中的加密 ID。 否则，该值由 Nayax Engine 生成。
该交易的 Nayax 内部唯一 ID,将在后续请求中回传。
集成商的内部交易 ID 。
    条件性字段:若未使用 /StartSession,则为必填项。 若已使用,该字段应为空,或回传请求中的交易 ID。
检索参考号（RRN）。
    用作第三方(例如卡组织)的外部交易 ID。 建议对消费者/持卡人可见。
唯一的交易令牌。仅供 Nayax 内部使用。
跟踪号。仅供 Nayax 内部使用。
仅供 Nayax 内部使用。
支付金额。
    小数值(分位最多 3 位)。 没有小数位的货币(例如 JYN)仍以双精度浮点数表示(例如 234.0)。
/Authorization 请求中所请求的原始金额。是否显示取决于 /Authorization 的响应。
/Settlement 或 /Sale 流程中请求的原始金额。与 Authorization 命令无关。
以 ISO 4217 三位字母格式表示的货币代码(例如 USD、EUR)。
ISO 4217 数字 3 位格式的货币代码。
该机器上金额的小数点位置。
    示例:2 表示金额形式如 123.45。 示例:0 表示金额形式如 12345(整数表示)。
外部授权码(通常来自发卡行)。
机器授权时间戳。
Nayax 服务器超时配置（单位：毫秒）。
机器所在位置的 UTC 时区偏移量。
/Authorization 发生的日期和时间。格式：ddMMyyHHmmss。
结算日期/时间。仅与结算相关命令有关。与授权无关。
指示是否发生网关超时（响应中有效）。
根据交易类型提供的卡片信息：
    对于卡在场的 Authorization/Sale,为完整的 Track 2 数据。 对于其他交易类型(例如 Refund、Settlement),仅为卡的 PAN。
注意： 卡片详细信息使用设备读取卡片时的相同格式。对于 Mifare 卡,Track 2 数据为十六进制。对于磁条卡,Track 2 数据为 ASCII。
卡片信息的读取方式：
    MCR:磁条(刷卡) CON:接触式芯片(插卡) CLS:非接触式芯片(轻触) NFC:手机轻触 QR:QR 码读取
卡片到期年份（ YY格式）。条件性（仅当接口为 1 或 10 时）。
卡片到期月份（ MM格式）。条件性（仅当接口为 1 或 10 时）。
EMV标签数据采用TLV（标签长度-值）格式。
持卡人 ID/识别号码。
暂无更多信息。
主品牌 ID(例如 Visa、Mastercard)。
主要品牌描述。
次品牌 ID(如适用)。
持卡人姓名。
表示产品在支付流程开始之前是否已被预先选定。
在 Nayax 后台或自动售货机中定义的所选商品代码。
所选商品的外部唯一标识符(产品目录编号)。
Nayax 后台中定义的产品名称。
The original Product Price in the machine’s currency. Note: Amount is the final billing price after adjustments.
产品的计量单位（例如 “unit” 或 “Liter”）。
以指定计量单位表示的产品数量。
在产品映射表中定义的产品组名称。
在产品映射表中定义的产品组代码。
用于通过脉冲(pulse)支持多台机器实现远程出货功能。必须为正整数 (≥0)(\ge 0)。
Nayax 设备硬件序列号。
设备固件版本(Device Firmware Version)。
Nayax 设备类型。
在 Nayax 后台分配的机器实体唯一 ID。
在 Nayax 后台中定义的机器名称。
在 Nayax 后台中定义的终端标识符。
托管该机器数据的 Nayax 服务器区域。
在 Nayax 后台中定义的机器区域(Machine Region)。
在 Nayax 后台中定义的机器所在城市。
在 Nayax 后台中定义的机器邮政编码。
机器位置纬度。
机器位置经度。
在 Nayax 后台中定义的 Actor ID(直接商户/运营商)。
在 Nayax 后台中定义的直接商户名称。
在 Nayax 后台中定义的商户 ID(运营商 ID - 字符串版本)。
商户运营商 ID(整数版本)。
商户运营商名称。
在 Nayax 后台中定义的商户 ID。
Actor 级别的 URL 配置。
演员地理位置代码。
Actor 地理位置城市。
Actor 地理位置国家代码(ISO-3)。
Actor 地理位置邮政编码。
Actor 地理位置地址。
国家全称。
以 ISO 3166-1 三位数字格式表示的国家代码。
以 ISO 3166-1 两位字母格式表示的国家代码。
以 ISO 3166-1 三位字母格式表示的国家代码。
用于跨国地理多元化的区域内(Intra Region,例如“European Union”)。
仅供 Nayax 内部使用。
直接演员自定义数据（ JSON 格式的字符串）。
操作员自定义数据（ JSON 格式的字符串）。
分销商自定义数据（ JSON 格式的字符串）。
演员自定义数据（ JSON 格式的字符串）。
机器自定义数据（ JSON 格式的字符串）。
通用自定义数据字符串， JSON 格式。

​
回复

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

​
响应参数

下表描述了 API 响应中返回的字段：
字段 类型 描述交易状态与错误Verdict StringCode Int(32)StatusMessage String(255)CustomDeclineCode String忠诚度和信用信息RegularCreditType Int(32)RegularCredit DoubleRevalueCredit Int(32)
请求的最终状态。必须是以下常量字符串值之一：
  • Approved
  • Declined
拒绝代码。条件性字段——仅当 Verdict 为 ‘Declined’ 时才存在。常见代码包括：
    1:余额不足 5:疑似欺诈 6:一般系统故障 7:金额无效 8/998:格式/解析错误 992:超时异常 997:缺少必填参数 999:一般异常
包含交易状态消息或有关结果的其他不同数据的自由文本字段。
用于指定自定义拒绝代码。
    通常与软拒绝或接口切换有关。 可能反映收单行的响应代码或自定义数据。
定义 RegularCredit 的计量单位（枚举值）：
    0：信用额度以交易次数计（count）。 1：信用额度以金额计（currency）。
根据 RegularCreditType 计算的常规信用额度值（金额或交易次数）。使用小数位数 2。
充值金额。
    仅当关联卡配置为可充值时才存在。 使用 2 位小数。