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

​
要求

Nayax’s servers send a POST request to your configured Void endpoint, which would be of the following format: (customer's URL)/Cortina/PrePaid/Void 该负载（payload）包含读卡操作的完整结果：

​
请求参数

下表描述了请求正文中包含的参数：
字段 类型 描述核心标识符和财务详情TransactionId String(36)NayaxTransactionId Int(64)SrvTranId StringAmount DoubleAuthAmount DoubleSettAmount DoubleAuthCode String(40)RRN StringToken String(256)TraceNumber StringAuthSource String(5)CurrencyCode String(3)CurrencyNumeric String(3)时间戳与状态标志AuthDateTime StringSettDateTime DoubleMachineAuTime StringTimeoutMS Int(32)IsGatewayTimeout Bool卡片及支付详情CardNumber StringEntryMode String(4)ExpYear StringExpMonth StringEMVData StringIDNumber StringPrimaryId StringPrimaryDescription StringSecondaryId StringSecondaryDescription StringRandomNumber StringCardHolderName String机器及位置详情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)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 String自定义数据(JSON)DirectActor StringOperator StringDistributor StringActor StringMachine StringAdditionalData String
此交易的唯一标识符。
    如果使用了 /StartSession，则回显其加密后的 ID。 否则，将由 Nayax Engine 生成此值。
Nayax 内部交易的唯一 ID ，在后续请求中会重复出现。
集成商的内部交易 ID 。
    条件性：如果未使用 /StartSession，则为必填字段。 如果使用了 /StartSession，则该字段应为空，或回显交易 ID（Transaction ID）。
付款金额（以美分为单位，最多保留 3 位小数）。
    示例：1 分 = 0.01。 注意：没有小数位的货币仍以 double 类型表示（例如，234 JYN = 234.0）。
/Authorization 请求中所请求的原始金额。是否显示取决于 /Authorization 的响应。
/Settlement 或 /Sale 流程中请求的原始金额。与 Authorization 命令无关。
外部授权码（通常来自发卡行的银行）。
参考检索编号（RRN） 。建议向消费者/持卡人公开，以便获得支持。
唯一的交易令牌。仅供 Nayax 内部使用。
追踪编号。仅供Nayax内部使用。
仅供 Nayax 内部使用。
ISO 4217 Alpha-3格式的货币代码。
ISO 4217 数字-3格式的货币代码。
/Authorization 发生的日期和时间。格式：ddMMyyHHmmss。
结算日期/时间。与授权命令无关。
机器授权时间戳。
Nayax 服务器超时配置（单位：毫秒）。
指示是否发生网关超时（响应中有效）。
根据交易类型提供的卡片信息：
    对于卡片在场（card-present）的 Authorization/Sale，为完整的 Track 2 数据。 对于其他交易类型（例如 Refund、Settlement），仅为卡号（Card 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。
次要品牌描述。
暂无更多信息。
持卡人姓名。
Nayax服务器区域。
Nayax 设备硬件序列号。
设备固件版本。
Nayax 设备类型。
机器实体的唯一 ID。
机器名称。
终端标识符。请联系 Nayax TPOC 进行定义。
金额的小数点位置。
    示例：2 表示金额格式类似 123.45。
UTC 时区偏移量。
仅供 Nayax 内部使用。
商户 ID。
机器所在地区。
机器所在城市。
机器邮政编码。
国家全称（用于机器位置）。
ISO-3166-1 Numeric-3 代码。
ISO-3166-1 Alpha-2 代码。
ISO-3166-1 Alpha-3 代码。
演员地理位置代码。
演员地理城市。
演员地理位置国家代码（ISO3） 。
演员地理位置邮政编码。
演员地理位置地址。
机器位置经度。
机器位置纬度。
直接演员自定义数据（ JSON 格式的字符串）。
操作员自定义数据（ JSON 格式的字符串）。
分销商自定义数据（ JSON 格式的字符串）。
演员自定义数据（ JSON 格式的字符串）。
机器自定义数据（ JSON 格式的字符串）。
通用自定义数据字符串， JSON 格式。

​
回复

客户的支付方式会向 Nayax 服务器发送的撤销响应。负载应如下所示：

​
响应参数

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