签名认证

BlockATM API 使用 HMAC-SHA256 进行请求签名,确保请求的真实性和完整性。

认证参数

Header
说明
必填

BlockATM-api-Key

API 密钥

BlockATM-Request-Time

请求时间戳(毫秒)

签名接口必填

BlockATM-Signature-V2

HMAC-SHA256 签名

签名接口必填

BlockATM-Rec_Window

请求有效时间窗口(毫秒)

否(默认 30000)

circle-info

获取密钥:在 BlockATM 管理后台「收银台」→「集成」中获取 API Key 和 Secret Key。

签名算法

步骤 1:拼接参数字符串

将请求参数(JSON body)按 key 的 ASCII 升序排列,拼接为 key=value 格式,用 & 分隔。

示例原始请求:

{
  "custNo": "86000123",
  "orderNo": "202504001399",
  "lang": "zh-CN"
}

处理后:

步骤 2:拼接时间戳

在参数字符串末尾拼接时间戳:

步骤 3:计算 HMAC-SHA256

使用 Secret Key 对拼接后的字符串进行 HMAC-SHA256 签名:

多语言示例

验证签名

circle-exclamation

时间戳要求

要求
说明

格式

Unix 毫秒时间戳

有效期

默认 30 秒(可通过 Rec_Window 修改)

时区

建议使用 UTC

示例1742723373000 表示 2025-03-23 10:29:33 UTC

Last updated