Skip to main content

​
要求

Cortina 支付方式将向 Nayax 服务器发送 Start 命令,以通知其交易已开始。该调用的格式如下: https://lynx.nayax.com/payment/v2/transactions/cortina/(payment method's name)/start 有效载荷包含以下详细信息：

​
请求参数

下表描述了请求正文中包含的参数： 字段 类型 描述用户和安全标识符AppUserID String(40)TransactionId String(40)SecretToken String(64)Balance Double机器识别码（至少需要一项）TerminalId String(255)UniQR String产品选择(Products 数组)Products 数组 ***
消费者在第三方应用程序上的用户 ID 。
交易的唯一标识符。
    将在所有后续请求和响应中回显。 最小长度为 8 个字符。
Nayax 会提前提供您系统的唯一密钥，请务必妥善保管。
用户账户余额。小数形式（分最多保留3位数字）。
自动售货机的唯一标识符（设备的硬件序列号）。
    条件性字段:如果未发送 UniQR,则必须发送此字段。
与机器关联的二维码值。
    条件性字段:如果未发送 TerminalId,则必须发送此字段。
该数组为可选参数，但如果提供，则某些内部字段为必填项。仅与预选流程相关。
Code inside ProductsInt(16)所选项目的代码。
    条件：如果机器不是脉冲式机器，则为必填项。
PulseLineNumber inside ProductsInt(32)远程销售功能的脉冲线路编号。
    条件性字段:如果机器是 Pulse 机器,则为必填项。 必须为正整数(≥0\ge 0)。
Name inside ProductsString(255)Nayax 后台中定义的产品名称。
Price inside ProductsDouble机器货币的原始产品价格。
    条件性字段:如果机器未为该产品代码设置价格,则为必填项。 注意:交易金额是经调整后的最终计费价格。
UnitOfMeasurement inside ProductsString(64)产品的计量单位（例如 “unit” 或 “Liter”）。

​
Remote Vend:产品选择

The following applies to the PreSelection flow only. To specify which product to vend, include a "code" field inside the "Products" array with the corresponding product index. 脉冲机器代码编号 对于 Pulse 阵列机器(除 Pulse Line 之外的任何 Pulse 配置),"code" 编号从 0 开始。例如,若为:
图像
  • "Code": 0 → “Ultimate” 产品
  • "Code": 1 → “Superior” 产品
  • "Code": 2 → “Regular” 产品
如果您发送的数字超出虚拟机数组的范围,我们的服务器将选择列表中的第一项(Code: 0)。 对于 Pulse 1–6 配置(Pulse Line),请使用 "PulseLineNumber" 而非 "code",且计数从 1 开始(而非 0)。
图像

​
回复

Nayax 服务器将发送给支付方式的 Start 响应。其负载应如下所示:

​
响应参数

下表描述了 API 响应中返回的字段： 字段 类型 描述交易状态及错误代码
Verdict inside StatusString表示请求最终状态的常量字符串：
  • Approved
  • Declined
Code inside StatusInt(32)拒绝代码（Decline Code）。条件性字段——仅当 Verdict 为 “Declined” 时才会出现。有效代码包括：
    1：余额不足 5：疑似欺诈 6：系统一般性故障 7：金额无效 8 / 998：格式/解析错误或验证错误 992：超时异常 997：缺少必填参数 999：一般性异常 有关其他状态和内部错误（例如 40、990、1011），请参阅完整列表。
StatusMessage inside StatusString(255)包含交易状态消息或有关结果的其他不同数据的自由文本字段。
CustomDeclineCode inside StatusString用于指定自定义拒绝代码（例如与 Soft Decline 或 Switch Interface 相关的代码）。可能反映收单机构（acquirer）的响应代码。