logan

Appearance

用户邀请返佣 ​

用户邀请用户。被邀请用户完成商品购买后，邀请用户获得：订单平台手续费 × 用户返佣比例。返佣先待结算，退款期结束且没有未完成投诉时进入用户余额；退款订单不返佣。

邀请关系只允许在被邀请用户第一次注册登录用户端时，通过 user_spread_{邀请人ID} 启动参数绑定。

1. MiniApp 登录绑定 ​

POST /home/base/miniAppUserLogin

参数类型必填说明
initDatastring是Telegram MiniApp 原始登录数据
user_spread_idint否从 user_spread_{ID} 解析，仅首次注册用户端时生效

2. 获取邀请信息 ​

POST /home/spread/getInfo

返回 spread_id、start_param、spread_rate 和 spread_switch。

3. 获取邀请统计 ​

POST /home/spread/statistics

json
{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "total_invites": 3,
    "month_invites": 1,
    "total_rebate": 12.50,
    "month_rebate": 2.50,
    "pending_rebate": 2.50,
    "settled_rebate": 10.00
  }
}

累计返佣包含待结算与已结算，不包含已取消。

4. 邀请记录 ​

POST /home/spread/inviteList

参数：page、limit、可选 date_range。仅返回当前用户作为邀请人的 relation_type=user 关系。

5. 返佣明细 ​

POST /home/spread/rebateList

参数：page、limit、可选 date_range、可选 status（0 待结算、1 已结算、2 投诉冻结、-1 已取消）。明细包含 trade_no、order_fee、rate、money、settle_at 和 settled_at。