logan

Appearance

1. 获取推广统计数据 ​

接口地址： /merchantapi/user/assistant/statistics

响应示例：

json
{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "total_invites": 100,
    "total_rebate": "500.00",
    "month_invites": 10,
    "month_rebate": "50.00"
  }
}

字段说明：

  • total_invites: 累计邀请数 （不遵循数据时效性）
  • total_rebate: 数据保存周期内的累计返佣净额，与返佣明细使用同一资金日志口径；每笔金额按页面展示的两位小数计算后累计，投诉退款产生的负数返佣冲正会从累计金额中扣除
  • month_invites: 本月邀请数 （不遵循数据时效性）
  • month_rebate: 本月返佣净额，与返佣明细使用同一资金日志口径；每笔金额按页面展示的两位小数计算后累计，投诉退款产生的负数返佣冲正会从本月金额中扣除

本页只统计“商户邀请商户”。当被邀请商户的店铺卖出商品时产生返佣，金额为该笔订单平台手续费乘以 spread_rate，不是按商品成交总额计算。返佣先进入邀请商户的冻结资金，再按自动解冻流程结算；用户邀请用户使用独立关系和接口。

2. 获取推广链接 ​

接口地址： /merchantapi/user/assistant/getSpreadLink

响应示例：

json
{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "spread_link": "https://example.com?tgWebAppStartParam=merchant_spread_123",
    "spread_id": 123,
    "username": "商户A",
    "spread_rate": 5,
    "start_param": "merchant_spread_123"
  }
}

字段说明：

  • spread_link: 推广链接
  • spread_id: 推广 ID（用户 ID）
  • username: 用户名
  • spread_rate: 推广返佣比例（5%）
  • start_param: Telegram Mini App 启动参数；商户端前端用它生成邀请链接

3. 获取邀请记录列表 ​

接口地址： /merchantapi/user/assistant/inviteList

请求方式： POST

请求参数：

参数名类型必填说明
date_rangearray否日期范围
pageint否页码
limitint否每页数量

响应示例：

json
{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "list": [
      {
        "id": 1,
        "user_id": 1047, // 被邀请用户ID
        "parent_id": 1000, // 推广人ID
        "create_at": "2025-11-24 18:41:26", // 邀请时间
        "username": "test1047" // 被邀请用户名
      }
    ],
    "total": 1
  }
}

4. 获取返佣明细列表 ​

接口地址： /merchantapi/user/assistant/rebateList

请求方式： POST

请求参数：

参数名类型必填说明
date_rangearray否日期范围
pageint否页码
limitint否每页数量

响应示例：

json
{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "list": [
      {
        "id": 1,
        "user_id": 123,
        "business_type": "spread_rebate_freeze", // 返佣增加或投诉退款冲正的资金业务类型
        "type": "freeze_money", // 变动钱包类型，仅发生订单交易时冻结推广佣金，故 type一定为freeze_money
        "money": "5.00", // 返佣金额
        "balance": "105.00", // 变动后余额
        "reason": "受邀商户[test1017]店铺订单[Q260804a4f36d]推广返佣，增加并冻结金额：0.315元", // 返佣说明
        "create_at": 1699999999 // 创建时间
      }
    ],
    "total": 50
  }
}

返佣明细与推广统计读取返佣增加日志 spread_rebate_freeze，以及商户主动退款冲正日志 complaint_refund_deduct_rebate、平台判定退款冲正日志 complaint_refund_spread。冲正日志金额为负数，会抵扣 total_rebate 和 month_rebate。未传日期范围时，明细同样受商户数据保存周期限制；因此同一周期内所有明细的页面展示金额之和与 total_rebate 一致。

5. 获取推广海报配置 ​

接口地址： /merchantapi/user/assistant/getposter

响应示例：

json
{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "spread_link": "https://example.com?tgWebAppStartParam=merchant_spread_123", // 推广链接
    "spread_id": 123, // 推广 ID
    "username": "商户A", // 用户名
    "title": "邀请好友开店", // 海报标题
    "description": "邀请好友注册开店，享受订单返佣", // 海报描述
    "start_param": "merchant_spread_123"
  }
}