获取授权二维码

终端设备获取授权二维码，用户使用酷点商户端扫码完成设备授权绑定。

信息

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

请求接口

POST /open/cashier/auth/qrcode

请求参数

参数	必填	类型	说明
client_info	是	Object	客户端信息

client_info 结构

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

响应参数

参数	类型	说明
qr_code_no	String	二维码编号
qr_code_url	String	二维码内容 URL，客户端据此生成二维码图片
expire_time	String	过期时间，格式 yyyy-MM-dd HH:mm:ss
status	String	二维码状态：PENDING-待授权、UNUSED-已授权待使用、USED-已使用、EXPIRED-已过期、REJECTED-已拒绝
auth_code	String	授权码，仅状态为 UNUSED 时返回，用于调用激活设备接口

请求示例

{
  "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": {
    "qr_code_no": "QR20260507001",
    "qr_code_url": "https://kudianvip.com/auth/scan?code=QR20260507001",
    "expire_time": "2026-05-07 10:30:00",
    "status": "PENDING"
  }
}