系统个人付款码查询人员接口

1. 接口概览

字段口径：staff_uuid 是组织人员 UUID，不是账号 UUID。接口不消费付款码、不创建订单、不扣款，也不修改余额。

2. 请求地址

POST {baseUrl}/api/consume/paycodeUserInfo

{baseUrl} 由实际部署环境提供。本文档不包含生产域名。

3. 请求头

本接口不需要传入 account、pwd、key 三个请求头字段。

4. 请求参数

JSON 请求体

兼容带 C 前缀、不带前缀，以及扫码枪附带首尾空格或 \r\n 的结果。

{
  "paycode": "C68ca123456789",
  "equipment_code": "EQ-001"
}

5. 成功响应

HTTP 状态码：200

{
  "code": 0,
  "message": "查询成功",
  "data": {
    "staff_uuid": "staff-uuid-001",
    "staff_name": "张三"
  }
}

成功判断：设备端必须以 code == 0 判断业务成功，不能只判断 HTTP 200。

6. 失败响应

业务失败时 HTTP 状态码仍为 200：

{
  "code": 1,
  "message": "该码已过期",
  "data": []
}

7. 调用示例

cURL

curl --request POST '{baseUrl}/api/consume/paycodeUserInfo' \
  --header 'Content-Type: application/json' \
  --data '{"paycode":"C68ca123456789","equipment_code":"EQ-001"}'

设备端处理逻辑

8. 服务端校验规则

1. 校验 equipment_code 非空，并查询编号相同且 del_flag=0 的设备。
2. 去除扫码原文首尾空白和扫码结束符。
3. 以单个大写 C 开头时移除系统展示前缀。
4. 查询未删除的个人动态付款码，内部类型为 type=4。
5. 校验付款码未使用且未过期。
6. 查询未删除的账号和组织人员。
7. 只返回 staff_uuid、staff_name。

9. 安全与副作用边界

• 接口不执行 checkApiAuth，无需传 account、pwd、key。
• equipment_code 必须对应未删除设备，用于确认调用设备，不作为登录凭据。
• 不返回手机号、证件号、余额、账号 ID 等额外信息。
• 不修改付款码 is_use，不创建订单，不扣款，不修改余额。
• 普通日志不得记录完整付款码。
• 接口只负责识别人；营养报告应由设备使用 staff_uuid 调用对应业务接口。

10. 验证记录

11. 版本与交付信息