Skip to main content
Cortina Prepaid 使用 Authorization 命令通知刷卡结果,以启动与 Cortina 支付提供商的授权流程。 此命令对于进行交易确认或拒绝处理至关重要。

​
要求

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

​
请求参数

下表描述了请求正文中包含的参数：
字段 类型 描述TransactionId String(36)NayaxTransactionId Int(64)Amount DoubleCurrencyCode String(3)CurrencyNumeric String(3)SiteId Int(16)MachineAuTime StringTimeoutMS Int(32)IsProductSelected BoolPaymentMethodID Int(32)BillingProviderId Int(32)AuditNumber Int(64)NayaxRRN StringIsDeferredAuthorization BoolAgeLimitation Int(16)IsSoftDeclineCompletion BoolTransitTransactionType Int(32)DenyListIndication Int(32)HwSerial StringFWVersion StringType StringId Int(64)Name String(255)ExternalId String(200)Type String(50)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)Intra StringState StringCity String(255)CountryCode StringZipCode String(255)Address String(255)Latitude StringLongitude StringId Int(64)Name String(255)OperatorId Int(64)OperatorName StringMerchantId Int(64)DynamicURL StringName StringNumericCode String(3)Alpha2Code String(2)Alpha3Code String(3)Intra StringState StringCity String(255)CountryCode StringZipCode String(255)Address String(255)Latitude StringLongitude StringMCC Int(32)SubMerchantId String(255)DirectActor StringOperator StringDistributor StringActor StringMachine StringSoftDecline StringCardNumber StringEntryMode String(4)ExpYear StringExpMonth StringEMVData StringCVV2 StringIDNumber StringRandomNumber StringPrimaryId StringPrimaryDescription StringSecondaryId StringSecondaryDescription StringCardHolderName StringIsDebitCard BoolSrvTranId StringAuthCode String(40)AuthAmount DoubleSettAmount DoubleRRN StringToken String(256)AuthDateTime StringSettDateTime DoubleTraceNumber StringAuthSource String(5)AdditionalData StringIsGatewayTimeout BoolProviderExternalData StringInitiateTranReference Int(64)IsRevalueCard Bool
此交易的唯一标识符。
    如果使用了 /StartSession,则回显加密在 ‘TranIDCipher’ 中的 ID。 如果未使用 /StartSession,则由 Nayax 引擎生成此值。
该交易的 Nayax 内部唯一标识符。此 ID 将在后续相关请求中回显。
付款金额（以美分为单位，最多保留 3 位小数）。
    示例:1 分 = 0.01,20 分 = 0.20。 注意:没有小数位的货币(例如 JYN)仍以双精度浮点数表示,例如 234 JYN = 234.0。
以其 ISO 4217 三位字母代码表示的货币(例如 USD、EUR)。
以其 ISO 4217 三位数字代码表示的货币(例如 USD 对应 840)。
承载该交易的 Nayax 服务器区域标识符。
机器授权时间戳。
Nayax 服务器超时配置,以毫秒为单位指定。
表示产品在支付流程开始之前是否已被预先选定。
所使用的特定支付提供商的 Nayax 标识符。
关联计费提供商的 Nayax 标识符。
仅供 Nayax 内部使用的保留字段。
用作外部交易标识的参考编号,供外部方使用。
    建议:该 ID 应对最终消费者及其银行/服务提供商可见。 该值必须在后续的 /Inquiry 请求中重复使用。
布尔指示符。暂无更多信息。
允许该交易所需的最低年龄。
布尔指示符。暂无更多信息。
交通支付的交易类型(枚举值):
    1:预付款 2:实时授权 3:后授权(聚合交易) 7:债务追偿
指示对消费者 Deny List 状态的影响(枚举值):
    0:未知/无影响 1:拒绝将导致该消费者被添加到拒绝名单。 2:批准将导致该消费者从拒绝名单中移除。
Nayax 设备硬件序列号。
设备固件版本号。
Nayax 设备类型。
在 Nayax 后台系统中分配的唯一机器实体 ID。
在 Nayax 后台配置的机器名称。
由运营商在 Nayax 后台系统中提供的机器外部 ID(机器编号 - 运营商)。
在 Nayax 后台中定义的机器类型。
终端标识符。请联系 Nayax TPOC 以获取定义。
此机器所用金额的小数点位置。
    示例:值为 2 表示金额形式如 123.45。 示例:值为 0 表示金额形式如 12345(整数表示)。
机器所在位置的 UTC 时区偏移量。
仅供 Nayax 内部使用的保留字段。
在 Nayax 后台中定义的商户 ID。
在 Nayax 后台中定义的地区。
在 Nayax 后台中定义的机器所在城市。
在 Nayax 后台中定义的机器所在邮政编码。
国家全称。
国家的 ISO-3166-1 三位数字代码(例如 840)。
国家的 ISO-3166-1 两位字母代码(例如 US)。
国家的 ISO-3166-1 三位字母代码(例如 USA)。
用于地理多元化的区域内(Intra Region)。
参与方的地理州/省代码。
与参与方关联的城市。
国家代码(ISO3)。
与参与方关联的邮政编码。
与参与方关联的地址。
机器所在位置的纬度。
机器所在位置的经度。
Actor ID。
直接商户名称(Direct Merchant Name)。
商户运营商 ID(Merchant Operator ID)。
商户运营商名称(Merchant Operator Name)。
商户 ID。请联系 Nayax TPOC 以进行定义。
Actor 级别的 URL 配置。
国家全称。
ISO-3166-1 三位数字代码。
ISO-3166-1 两位字母代码。
ISO-3166-1 三位字母代码。
用于地理多元化的区域内(Intra Region)。
参与方的地理州/省代码。
与参与方关联的城市。
国家代码(ISO3)。
与参与方关联的邮政编码。
与参与方关联的地址。
机器所在位置的纬度。
机器所在位置的经度。
商户类别代码(Merchant Category Code),用于按所提供商品或服务的类型对商户进行分类。
子商户标识符。请联系 Nayax TPOC 以进行定义。
以 JSON 格式表示的直接 Actor 自定义数据。
以 JSON 格式表示的运营商自定义数据。
以 JSON 格式表示的分销商自定义数据。
以 JSON 格式表示的 Actor 自定义数据。
以 JSON 格式表示的机器自定义数据。
以 JSON 格式表示的与软拒绝(Soft Decline)相关的自定义数据。
根据交易类型发送的卡片详细信息:
    对于刷卡授权/销售(Card Present Authorization/Sale):发送完整的 Track2 数据。 对于其他交易类型:仅发送卡号(PAN)。
注意： 卡片详细信息使用设备读取卡片时的相同格式。对于 Mifare 卡,Track 2 数据为十六进制。对于磁条卡,Track 2 数据为 ASCII。
指示卡片详细信息的读取方式。常见值包括:
    MCR:磁条读取(刷卡)。 CON:接触式芯片读取(插卡)。 CLS:非接触式芯片读取(轻触)。 NFC:手机/移动设备非接触式读取。 QR:通过 QR 码读取卡号。
卡片的有效期年份(YY 格式)。条件性字段:仅当 Interface 为 1 或 10 时发送。
卡片的有效期月份(MM 格式)。条件性字段:仅当 Interface 为 1 或 10 时发送。
以 TLV(标签-长度-值)格式包含 EMV 标签的字符串。
卡片验证值 2(CVV2)。
与持卡人或交易关联的 ID 号码。
暂无更多信息。
主品牌 ID(Primary Brand Id)。
主品牌描述(Primary Brand Description)。
次品牌 ID(如适用)。
次品牌描述(如适用)。
持卡人姓名(Card Holder Name)。
表示该卡为借记卡还是预付卡。
集成商的内部交易 ID 。
    条件性字段:仅当未使用 /StartSession 时为必填项。 若已使用 /StartSession,该字段应为空,或回传主交易 ID。
外部授权代码（通常来自发卡行）。
在 /Authorization 请求中请求的原始金额。
/Settlement 或 /Sale 流程中请求的原始金额。与 Authorization 无关。
参考检索号(Reference Retrieval Number)。强烈建议对最终消费者/持卡人可见。
该交易的唯一令牌。仅供 Nayax 内部使用。
/Authorization 发生的日期和时间字符串。格式：ddMMyyHHmmss。
结算日期/时间。与授权无关。
跟踪号。仅供 Nayax 内部使用。
仅供 Nayax 内部使用。
以 JSON 格式字符串发送的附加数据。
表示是否发生了网关超时。
来自提供商的外部数据，格式为 JSON 字符串。
条件性字段:反映预付忠诚卡重试时的原始 Nayax 交易 ID。
表示是否允许对该卡进行充值(revalue)。

​
回复

客户的支付方式将向 Nayax 服务器发送授权响应。有效负载应如下所示：

​
响应参数

下表描述了 API 响应中返回的字段：
字段 类型 描述Verdict StringCode Int(32)StatusMessage String(255)CustomDeclineCode StringSrvTranId StringAuthCode String(40)AuthAmount DoubleSettAmount DoubleRRN StringToken String(256)AuthDateTime StringSettDateTime DoubleTraceNumber StringAuthSource String(5)AdditionalData StringIsGatewayTimeout BoolProviderExternalData StringInitiateTranReference Int(64)IsRevalueCard BoolRegularCreditType Int(32)RegularCredit DoubleRevalueCredit Int(32)
请求状态的常量字符串:
  • Approved
  • Declined
条件性字段:仅当 Verdict 为 Declined 时返回。必填的拒绝代码:
    1:余额不足 2:交易 ID 未知 3:持卡人超出每日/每周/每月交易次数限制 4:持卡人超出交易金额限制 5:疑似欺诈 6:一般系统故障 7:金额无效 8:请求无法解析(格式错误) 9:不允许该持卡人进行此交易 40:仅供 Nayax 内部使用。 990:未找到 CertificateFileName 991:消息正文解密失败 992:超时异常 994:不支持的卡品牌 995: 996:交易 ID 未知/交易 ID 重复(启动会话错误) 997:缺少必填参数 998:验证/请求无法解析 999:一般异常 1010:未找到公钥证书 1011:方法未实现
交易状态消息,以自由文本字段形式提供,或用于其他各类数据。
用于指定自定义拒绝代码(例如用于软拒绝或接口切换)。该值可以是收单行的响应代码,或由其他数据组合而成。
集成商的内部交易 ID 。
    条件性字段:仅当未使用 /StartSession 时为必填项。 若已使用 /StartSession,该字段应为空,或回传请求中发送的交易 ID。
外部授权代码（通常来自发卡行）。
/Authorization 请求中所请求的原始金额。
/Settlement 或 /Sale 流程中请求的原始金额。与 Authorization 无关。
参考检索号(Reference Retrieval Number)。强烈建议对最终消费者/持卡人可见,以便支持。
该交易的唯一令牌。仅供 Nayax 内部使用。
/Authorization 发生的日期和时间字符串。格式：ddMMyyHHmmss。
结算日期/时间。与授权无关。
跟踪号。仅供 Nayax 内部使用。
仅供 Nayax 内部使用。
以 JSON 格式字符串发送的附加数据。请联系 Nayax TPOC 以进行定义。
表示是否发生了网关超时(在响应中有效)。
来自提供商的外部数据，格式为 JSON 字符串。
条件：反映预付会员卡重新尝试的原始 Nayax 交易 ID 。
表示是否允许对该卡进行充值(增加资金)。
定义 RegularCredit 字段所代表的内容(枚举值):
    0:该信用额以交易笔数计算。 1:该信用额以金额计算。
根据 RegularCreditType 计算的常规信用金额或交易笔数。小数位为 2。
充值信用金额(Revalue Credit)。仅当该卡配置为可充值时可用。小数位为 2。