Skip to main content
为确保通信安全,集成商发送的每个请求都必须包含两个特定的身份验证标头。这些标头用于验证您的身份并确保交易数据的完整性。

先决条件

开始之前,请确保您已准备好 Nayax 提供的以下资源:
  • 有效的 Header Hash Key(通常为 16 个字符),也称为签名密钥(Sign Key)
  • 关联的 Header Hash Key ID,也称为签名密钥 ID(Sign Key ID)
您的请求正文必须包含 SparkTransactionId 字段。

验证请求

拥有所需的资源后,您可以按照以下步骤开始向 Spark 验证您的 API 请求:
  1. 将静态字符串 IntegratorId 与您的 ID 按以下格式组合:IntegratorId: {HeaderHashKeyID}。请参见下面的示例:
  2. 将请求正文中的 SparkTransactionId 与您的 Header Hash Key 用分号(;)连接,格式如下:SparkTransactionId;HeaderHashKey
  3. 使用 UTF-8 编码对结果字符串执行 SHA-256 哈希运算。得到的哈希值:
  4. 最终的标题应如下所示:

请求示例(cURL)

参见 /StartAuthentication 端点的示例请求:
基本 URLSpark API 的基础 URL 为 https://nayax-spark-dmz.nayax.com/api。集成环境和生产环境使用同一个主机。

参见

交互式身份验证工具

在浏览器中构建和检查密文与签名请求头,无需编写代码。

交易流程

身份验证如何融入完整的 Spark 交易流程。