Skip to main content
Cortina 预付使用 Cancel 命令通知集成方,以便在以下任一情况发生时,与 Cortina 支付提供商发起取消流程:
  1. 收到失败的 Authorization 响应(由于超时或 Authorization 响应中包含错误代码)。
  2. 产品选择过程中出现的问题 - 消费者无操作/按下取消按钮/消费者选择了无效的产品。
  3. 机器故障（产品分发/服务提供方面出现问题）
此命令对于让支付提供商知道交易已在 Nayax 端（以及从消费者的角度来看）被取消至关重要，并且执行此命令是为了让支付提供商在其端完成取消操作。
注意:此命令仅适用于预授权(PreAuthorization)。其在预选择(PreSelection)流程中的等效命令是 Void 命令。

​
要求

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

​
请求参数

下表描述了请求正文中包含的参数：
字段 类型 描述ReasonCode Int(16)ReasonText StringTransactionId String(36)NayaxTransactionId Int(64)Amount DoubleCurrencyCode String(3)CurrencyNumeric String(3)SiteId Int(16)MachineAuTime StringTimeoutMS Int(32)IsProductSelected BoolHwSerial StringFWVersion StringType StringId Int(64)Name String(255)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)State StringCity String(255)CountryCode StringZipCode String(255)Address String(255)Longitude StringLatitude StringId Int(64)Name String(255)OperatorId Int(64)OperatorName StringMerchantId Int(64)Name StringNumericCode String(3)Alpha2Code String(2)Alpha3Code String(3)State StringCity String(255)CountryCode StringZipCode String(255)Address String(255)Latitude StringLongitude StringDirectActor StringOperator StringDistributor StringActor StringMachine StringCardNumber StringEntryMode String(4)ExpYear StringExpMonth StringEMVData StringIDNumber StringRandomNumber StringPrimaryId StringPrimaryDescription StringSecondaryId StringSecondaryDescription StringCardHolderName StringSrvTranId StringAuthCode String(40)AuthAmount DoubleSettAmount DoubleRRN StringToken String(256)AuthDateTime StringSettDateTime DoubleTraceNumber StringAuthSource String(5)AdditionalData StringIsGatewayTimeout Bool
有效的取消或拒绝代码:
    1:余额不足 2:交易 ID 未知 3:持卡人超出每日/每周/每月交易次数限制 4:持卡人超出交易金额限制 5:疑似欺诈 6:一般系统故障 7:金额无效 8/998:请求无法解析(格式错误)/验证错误 9:不允许该持卡人进行此交易 40:仅供 Nayax 内部使用。 990:未找到 CertificateFileName 991:消息正文解密失败 992:超时异常 994:不支持的卡品牌 996:交易 ID 未知/交易 ID 重复(启动会话错误) 997:缺少必填参数 999:一般异常 1010:未找到公钥证书 1011:方法未实现
与 ReasonCode 对应的文字说明。
此交易的唯一标识符。
    如果使用了 /StartSession，则回显其中的加密 ID。 否则，该值由 Nayax Engine 生成。
Nayax 内部交易的唯一 ID ，在后续请求中会重复出现。
付款金额（以美分为单位，最多保留 3 位小数）。
    示例:1 分 = 0.01。 注意:没有小数位的货币(例如 JYN)仍以双精度浮点数表示(例如 234.0)。
以 ISO 4217 三位字母格式表示的货币代码。
ISO 4217 数字 3 位格式的货币代码。
Nayax 服务器区域标识符。
机器授权时间戳。
Nayax 服务器超时配置（单位：毫秒）。
表示产品在支付流程开始之前是否已被预先选定。
Nayax 设备硬件序列号。
设备固件版本。
Nayax 设备类型。
在 Nayax 后台分配的机器实体唯一 ID。
在 Nayax 后台中定义的机器名称。
终端标识符。请联系 Nayax TPOC 进行定义。
此机器所用金额的小数点位置。
    示例:值为 2 表示金额形式如 123.45。
UTC 时区偏移量。
仅供 Nayax 内部使用。
在 Nayax 后台中定义的商户 ID(字符串格式)。
在 Nayax 后台中定义的地区。
在 Nayax 后台中定义的机器所在城市。
在 Nayax 后台中定义的机器邮政编码。
国家全称。
ISO-3166-1 Numeric-3 代码。
ISO-3166-1 Alpha-2 代码。
ISO-3166-1 Alpha-3 代码。
演员地理位置代码。
演员地理城市。
演员地理位置国家代码（ISO3） 。
演员地理位置邮政编码。
演员地理位置地址。
机器位置经度。
机器位置纬度。
Actor ID(直接商户/运营商)。
直接商户名称。
商户运营商 ID （整数格式）。
商户运营商名称。
商户 ID 。请联系 Nayax TPOC 进行定义。
国家全称。
ISO-3166-1 Numeric-3 代码。
ISO-3166-1 Alpha-2 代码。
ISO-3166-1 Alpha-3 代码。
演员地理位置代码。
演员地理城市。
演员地理位置国家代码（ISO3） 。
演员地理位置邮政编码。
演员地理位置地址。
机器位置纬度。
机器位置经度。
直接演员自定义数据（ JSON 格式的字符串）。
操作员自定义数据（ JSON 格式的字符串）。
分销商自定义数据（ JSON 格式的字符串）。
演员自定义数据（ JSON 格式的字符串）。
机器自定义数据（ JSON 格式的字符串）。
根据交易类型提供的卡片信息：
    对于卡在场的 Authorization/Sale,为完整的 Track 2 数据。 对于其他交易类型(例如 Refund、Settlement),仅为卡的 PAN。
注意： 卡片详细信息使用设备读取卡片时的相同格式。对于 Mifare 卡,Track 2 数据为十六进制。对于磁条卡,Track 2 数据为 ASCII。
卡片信息的读取方式：
    MCR:磁条读取(刷卡) CON:接触式芯片读取(插卡) CLS:非接触式芯片读取(轻触) NFC:手机/移动设备非接触式读取(手机轻触) QR:通过 QR 码读取卡号 如有特殊情况,请咨询 Nayax POC。
卡片到期年份（ YY格式）。条件性（仅当接口为 1 或 10 时）。
卡片到期月份（ MM格式）。条件性（仅当接口为 1 或 10 时）。
EMV标签数据采用TLV（标签长度-值）格式。
持卡人ID号码。
暂无更多信息。
主要品牌 ID。
主要品牌描述。
次要品牌 ID。
次要品牌描述。
持卡人姓名。
集成商的内部交易 ID 。
    条件性字段:仅当未使用 /StartSession 时为必填项。 若已使用,该字段应为空,或回传交易 ID。
外部授权码（通常来自发卡行的银行）。
在 /Authorization 请求中请求的原始金额。
/Settlement 或 /Sale 流程中请求的原始金额。与 Authorization 无关。
参考检索号(Reference Retrieval Number)。强烈建议对最终消费者/持卡人可见。
该交易的唯一令牌。仅供 Nayax 内部使用。
/Authorization 发生的日期和时间字符串。格式：ddMMyyHHmmss。
结算日期/时间。与授权无关。
跟踪号(Trace number)。仅供 Nayax 内部使用。
仅供 Nayax 内部使用。
附加数据字符串， JSON 格式。请联系 Nayax TPOC 进行定义。
指示是否发生网关超时（响应中有效）。

​
回复

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

​
响应参数

下表描述了 API 响应中返回的字段：
字段 类型 描述Verdict StringCode Int(32)StatusMessage String(255)RegularCreditType Int(32)RegularCredit DoubleRevalueCredit Int(32)
请求的最终状态。必须是以下常量字符串值之一：
  • Approved
  • Declined
拒绝代码（Decline Code）。条件性字段——仅当 Verdict 为 “Declined” 时才会出现。有效的拒绝代码包括：
    1:余额不足 2:交易 ID 未知 3:持卡人超出交易次数限制 4:持卡人超出交易金额限制 5:疑似欺诈 6:一般系统故障 7:金额无效 8:请求无法解析(格式错误) 9:不允许该持卡人进行此交易 40:仅供 Nayax 内部使用。 990:未找到 CertificateFileName 991:消息正文解密失败 992:超时异常 994:不支持的卡品牌 996:交易 ID 未知/交易 ID 重复(启动会话错误) 997:缺少必填参数 998:验证/请求无法解析 999:一般异常 1010:未找到公钥证书 1011:方法未实现
包含交易状态消息或有关结果的其他不同数据的自由文本字段。
定义 RegularCredit 的计量单位（枚举值）：
    0：信用额度以交易次数计（count）。 1：信用额度以金额计（currency）。
根据 RegularCreditType 计算的常规信用额度值（金额或交易次数）。使用小数位数 2。
充值金额。
    仅当关联卡配置为可充值时才存在。 使用 2 位小数。