1. 我购买的邀请码列表

接口地址： /merchantapi/distribution/hall/myBuyHallCodeList

请求方式： POST

请求参数：

参数名	类型	必填	说明
page	int	否	页码
limit	int	否	每页数量

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "list": [
      {
        "id": 2,
        "code": "KzgcGm7s",
        "category_id": 1, // 分类ID  2026-5-20新增
        "category_name": "默认分类", // 分类名称 2026-5-20新增
        "status": 1,
        "used_user_id": 1002, // 使用者ID
        "user_id": 1000, // 购买者ID
        "used_time": 1763896066, // 使用时间
        "create_time": "2025-11-23 19:06:37", // 购买时间
        "update_time": "2025-11-23 19:07:46", // 更新时间
        "used_username": "test1002", // 使用者用户名
        "status_text": "已使用" // 状态文本：未使用/已使用
      }
    ],
    "total": 10
  }
}

---

2. 获取邀请码单价

接口地址： /merchantapi/distribution/hall/getCodePrice

请求方式： POST

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "price": 10 // 邀请码单价
  }
}

---

3. 购买邀请码

接口地址： /merchantapi/distribution/hall/buyHallCode

请求方式： POST

请求参数：

参数名	类型	必填	说明
category_id	int	是	购买分类ID 2026-5-20 新增
quantity	int	是	购买数量

响应示例：

{
  "code": 1, // 1=成功，0=失败
  "msg": "购买成功" // 其他：购买失败：您暂未开通任何货源大厅分类，无法购买邀请码/购买失败：仅可购买您已开通的大厅分类邀请码/购买失败：购买数量必须大于0/购买失败：运营钱包余额不足，请先充值
}

业务规则：

• 需要有足够的可用运营资金余额
• 仅可购买“当前商户自己已开通且仍启用”的大厅分类邀请码（用于下级代理核销）
• 购买后会扣除运营资金，并记录资金日志，业务类型为：buy_hall_code
• 购买成功后会发送站内消息，内容为：您已成功购买' . $quantity . '个货源大厅邀请码，总计花费' . $total_price . '元。

---

4. 核销邀请码

接口地址： /merchantapi/distribution/hall/verifyHallCode

请求方式： POST

请求参数：

参数名	类型	必填	说明
code	string	是	邀请码

响应示例：

{
  "code": 1, // 1=成功，0=失败
  "msg": "核销成功，已为您开通货源大厅功能",
  "data": {
    "hall_access": 1, // 货源大厅访问权限：0=未开通，1=已开通
    "category_id": 1, // 本次核销开通的分类ID
    "category_name": "默认分类", // 本次核销开通的分类名称
    "is_new_opened": 1, // 1=新开通分类，0=已开通过该分类
    "category_ids": [1, 2] // 当前商户已开通分类ID集合
  }
}

业务规则：

• 邀请码必须存在且未使用
• 核销成功后增加信誉分
• 信誉分达到 80 分才能开通货源大厅访问权限
• 信誉分达到 80 分并开通货源大厅访问权限时，会自动创建或补齐默认货源名片名称；默认名称为“店铺名+货源”，没有店铺名时依次使用商户用户名、商户ID兜底
• 核销成功后发送站内消息