激活设备

终端设备首次使用时，需通过授权码完成激活绑定，获取签名密钥和 AES 密钥。

信息

本接口无需签名验证，属于设备接入前的初始化接口。

请求接口

POST /open/cashier/auth/activate

请求参数

参数	必填	类型	说明
auth_code	是	String	授权码
client_info	是	Object	客户端信息

client_info 结构

参数	必填	类型	说明
sn	否	String	设备序列号
name	否	String	设备名称
ip	否	String	设备IP
app	否	String	应用标识
version	否	String	应用版本

响应参数

参数	类型	说明
mch_id	String	商户号
sign_serial	String	密钥序列号
sign_secret	String	签名密钥（Secret）
ase_key	String	AES 加密密钥（Base64 编码）

注意

sign_secret 和 ase_key 为敏感信息，请妥善保管，切勿泄露。

请求示例

{
  "auth_code": "AUTH20260507001",
  "client_info": {
    "sn": "SN-DEVICE-001",
    "name": "收银台A01",
    "ip": "192.168.1.100",
    "app": "cashier-pos",
    "version": "2.0.0"
  }
}

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "mch_id": "100001",
    "sign_serial": "KEY20260507001",
    "sign_secret": "your_sign_secret_key",
    "ase_key": "Base64EncodedAesKey=="
  }
}

签名验证不通过

已激活的设备在正常使用中，若接口返回响应码 -10007（签名验证不通过），说明当前密钥已失效，设备绑定关系可能已变更。响应示例：

{
  "code": -10007,
  "msg": "签名验证不通过",
  "data": null
}

收到该响应码后，请立即跳转至设备绑定页面，重新执行激活流程以获取新密钥，切勿继续使用已失效的密钥发起请求。