Skip to main content
Cortina 预付使用 Refund 命令通知集成方有关退款请求,以便集成方与 Cortina 支付提供商发起退款。

​
如何触发退款

您可以通过以下两种方式触发退款请求:
  • 在 Nayax Core 的动态交易监控器中。
  • 通过 Lynx API。

​
通过动态交易监控器

需要 Refunds Admin 角色在动态交易监控器中申请和批准退款需要 Refunds Admin 角色。请联系您的集成支持工程师为您分配该角色。
1

申请退款

右键单击相关交易,然后选择申请退款。
Nayax Core 交易右键菜单,其中突出显示了“申请退款”
2

批准退款

再次右键单击同一笔交易,然后选择批准/拒绝退款。
Nayax Core 交易右键菜单,其中突出显示了“批准/拒绝退款”
随后,Nayax 会按下文所述,向您的端点发送 Refund 命令。

​
通过 Lynx API

先调用 Request a Payment Refund 端点,再调用 Approve Payment Refund 端点。

​
要求

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

​
请求参数

下表描述了请求正文中包含的参数：
字段 类型 描述交易状态与取消代码ReasonCode Int(16)ReasonText String核心标识符和财务详情TransactionId String(36)NayaxTransactionId Int(64)SrvTranId StringAmount DoubleAuthAmount DoubleSettAmount DoubleAuthCode String(40)RRN StringToken String(256)TraceNumber StringAuthSource String(5)时间戳与系统详情AuthDateTime StringSettDateTime DoubleMachineAuTime StringTimeoutMS Int(32)IsGatewayTimeout BoolAdditionalData StringSiteId Int(16)IsProductSelected Bool机器及位置详情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 StringId Int(64)Name String(255)OperatorId Int(64)OperatorName StringMerchantId Int(64)DirectActor StringOperator StringDistributor StringActor StringMachine String
有效的取消或拒绝代码:
    1:余额不足 2:交易 ID 未知 3:持卡人超出每日/每周/每月交易次数限制 4:持卡人超出交易金额限制 5:疑似欺诈 6:一般系统故障 7:金额无效 8/998:请求无法解析(格式错误)/验证错误 9:不允许该持卡人进行此交易 40:仅供 Nayax 内部使用。 992:超时异常 997:缺少必填参数 999:一般异常 其他状态及技术错误(例如 990、994、1010)请参阅完整列表。
与 ReasonCode 对应的文字说明。
此交易的唯一标识符。
    如果使用了 /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 内部使用。
/Authorization 发生的日期和时间。格式：ddMMyyHHmmss。
结算日期/时间。与授权命令无关。
机器授权时间戳。
Nayax 服务器超时配置（单位：毫秒）。
指示是否发生网关超时（响应中有效）。
附加数据字符串， JSON 格式。请联系 Nayax TPOC 进行定义。
Nayax服务器区域。
指示商品是否已被预先选定。
Nayax 设备硬件序列号。
设备固件版本。
Nayax 设备类型。
机器实体的唯一 ID。
机器名称。
终端标识符。请联系 Nayax TPOC 进行定义。
金额的小数点位置。
UTC 时区偏移量。
仅供 Nayax 内部使用。
商户 ID。
机器所在地区。
机器所在城市。
机器邮政编码。
国家全称（用于机器位置）。
ISO-3166-1 Numeric-3 代码。
ISO-3166-1 Alpha-2 代码。
ISO-3166-1 Alpha-3 代码。
演员地理位置代码。
演员地理城市。
演员地理位置国家代码（ISO3） 。
演员地理位置邮政编码。
演员地理位置地址。
机器位置经度。
机器位置纬度。
Actor ID。
直接商户名称。
商户运营商 ID （整数格式）。
商户运营商名称。
商户 ID 。请联系 Nayax TPOC 进行定义。
直接演员自定义数据（ JSON 格式的字符串）。
操作员自定义数据（ JSON 格式的字符串）。
分销商自定义数据（ JSON 格式的字符串）。
演员自定义数据（ JSON 格式的字符串）。
机器自定义数据（ JSON 格式的字符串）。

​
回复

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

​
响应参数

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