查询商户列表

查询当前应用已授权的商户列表。

请求

GET /open-api/v1/merchants

请求参数

参数	类型	必填	说明
pageNo	int	否	页码，默认 1
pageSize	int	否	每页条数，默认 10，最大 100
name	string	否	商户名称（模糊匹配）
status	int	否	状态：0-正常 1-禁用 2-注销

请求示例

curl -X GET 'https://openapi.example.com/open-api/v1/merchants?pageNo=1&pageSize=10&name=测试' \
  -H 'X-App-Key: ak_1234567890abcdef' \
  -H 'X-Timestamp: 1709280000' \
  -H 'X-Nonce: a1b2c3d4' \
  -H 'X-Sign: calculated_signature'

响应

响应参数

字段	类型	说明
list	array	商户列表
list[].id	long	商户 ID
list[].merchantName	string	商户名称
list[].contactName	string	联系人
list[].contactPhone	string	联系电话
list[].address	string	地址
list[].status	int	状态：0-合作中 1-已终止
list[].cooperateTime	string	合作开始时间
total	long	总记录数
page	int	当前页码
size	int	每页条数

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "list": [
      {
        "id": 1001,
        "merchantName": "示例美容店",
        "contactName": "张三",
        "contactPhone": "138****1234",
        "address": "北京市朝阳区xxx路xx号",
        "status": 0,
        "cooperateTime": "2026-01-15T10:00:00+08:00"
      }
    ],
    "total": 1,
    "page": 1,
    "size": 10
  }
}

错误码

错误码	说明
100007	无 merchant 模块权限
100009	参数校验失败