Skip to main content
Cortina 使用 Start Session 命令通知集成商,与 Cortina 支付提供商之间的交易请求已初始化。
重要提示:对于 Cortina Static QR(SQR),使用的是 Start 命令而非 StartSession,且 Start 是由 Cortina 支付提供商发送给 Nayax,而不是反过来(如前文所述)。
More on that in Static QR- Start.

​
要求

Nayax 的服务器会向您配置的 StartSession 端点发送 POST 请求,其格式如下: (customer's URL)/Cortina/StartSession 有效载荷包含以下详细信息：

​
请求参数

下表描述了请求中的所有参数: 字段 类型 是否必填 描述TokenId String 是RandomNumber String 是DynamicURL String(255) 否
第三方 Secret Token 参考编号。
由 Nayax 生成的唯一 27 位随机数。
Actor 级别的 URL 配置。支持路由到不同的 URL。
自定义数据字段(JSON 格式的字符串)
DirectActor Inside CustomDataStringNoJSON 格式的直接 Actor 自定义数据。请就定义联系 Nayax TPOC。
Operator Inside CustomDataStringNoJSON 格式的运营商自定义数据。请就定义联系 Nayax TPOC。
Distributor Inside CustomDataStringNoJSON 格式的分销商自定义数据。请就定义联系 Nayax TPOC。
Actor Inside CustomDataStringNoJSON 格式的 Actor 自定义数据。请就定义联系 Nayax TPOC。
Machine Inside CustomDataStringNoJSON 格式的 Machine 自定义数据。请就定义联系 Nayax TPOC。
SoftDecline Inside CustomDataStringNo与 Soft Decline 相关的 JSON 格式自定义数据。请就定义联系 Nayax TPOC。

​
回复

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

​
响应参数

下表描述了响应中的所有参数: 字段 类型 是否必填 描述TranIDCipher String(36) 是
用于在 /StartSession 请求中进行身份验证的加密交易 ID。
    集成方的角色:生成交易 ID(36 个字符/288 位),附加 = 和 RandomNumber 以形成密文(64 个字符)。使用 AES ECB 对该字符串进行加密。 AES 密钥:与 TokenID 匹配的 Secret Token 的最右侧 256 位(32 个字符)。 Nayax 的角色:解密该密文以提取交易 ID,该交易 ID 随后用于所有后续请求。
Verdict inside StatusStringYes表示请求最终状态的常量字符串:
  • Approved
  • Declined
Code inside StatusInt(32)No拒绝代码（Decline Code）。条件性字段——仅当 Verdict 为 “Declined” 时才会出现。有效的拒绝代码包括：
    1: 余额不足 5: 疑似欺诈 6: 一般系统故障 7: 金额无效 8 / 998: 格式/解析错误或验证错误 992: 超时异常 997: 缺少必填参数 999: 一般异常 有关错误代码的完整列表,请参阅完整文档。
StatusMessage inside StatusString(255)No包含交易状态消息或有关结果的其他不同数据的自由文本字段。
CustomDeclineCode inside StatusStringNo用于指定自定义拒绝代码（例如与 Soft Decline 或 Switch Interface 相关的代码）。可能反映收单机构（acquirer）的响应代码。