8. 偶像端 API 8.30 收入明细【基础探测通过，待数据联调】

Table of Contents

8.30 收入明细【基础探测通过，待数据联调】

GET /tieup/api/v1/artist/income-records

查询参数：

参数 类型 必填 说明
business_type string 否 收入业务类型：subscription=订阅，question=提问（包含追问），follow_up_question=追问，video_call=视频通话，benefit=福利
settlement_status integer 否 结算状态：1=待结算，2=已入账，3=已退款扣回，4=已取消
start_at string 否 收入记录创建开始时间，格式：Y-m-d H:i:s，筛选 created_at >= start_at
end_at string 否 收入记录创建结束时间，格式：Y-m-d H:i:s，筛选 created_at <= end_at
page integer 否 页码，默认 1
page_size integer 否 每页数量，默认 20，最大 100

响应字段：

字段 类型 说明
total_income_amount string 当前筛选条件下的总收入，汇总艺人收入金额，单位元，两位小数字符串；仅受 business_type、start_at、end_at 影响，不受 settlement_status 或分页影响
items array 当前页数据列表
items[].id integer 收入明细 ID
items[].income_no string 收入记录编号
items[].artist_id integer 艺人 ID
items[].artist_user_id integer 艺人关联用户 ID
items[].fan_user_id integer/null 来源粉丝用户 ID
items[].fan_nickname string 来源粉丝用户昵称；用户不存在或昵称为空时返回空字符串
items[].order_no string/null 平台订单号
items[].business_type string 收入业务类型：subscription、question、follow_up_question、video_call、benefit
items[].business_id integer/null 业务记录 ID
items[].sub_type string 仅 business_type=subscription 返回；订阅周期类型：month=月订阅，year=年订阅
items[].actual_duration_seconds string 仅 business_type=video_call 返回；数据库实际保存秒数，接口返回可读时长文本，例如 100 秒返回 1分钟40秒，未开始通话返回 0秒
items[].fan_no_show integer 仅 business_type=video_call 返回；1=粉丝爽约，2=粉丝未爽约；预约状态 6/7 返回 1
items[].total_amount string 总收入金额，单位元，两位小数字符串
items[].settlement_base_amount string 艺人分成结算基数，单位元，两位小数字符串；iOS 订阅为购买时普通价格，其他业务默认等于总收入
items[].artist_income_amount string 艺人收入金额，单位元，两位小数字符串
items[].platform_fee_amount string 平台金额，等于总收入减艺人收入；iOS 订阅包含高于普通价格的差额
items[].share_ratio string 应用于 settlement_base_amount 的艺人分成比例，百分比，两位小数字符串
items[].settlement_status integer 结算状态：1=待结算，2=已入账，3=已退款扣回，4=已取消
items[].settled_at string/null 入账时间
items[].refund_no string/null 关联退款单号
items[].created_at string/null 创建时间
pagination object 分页信息
pagination.page integer 当前页码
pagination.page_size integer 每页数量
pagination.total integer 总数量
pagination.next_cursor string/null 游标分页预留字段，当前为空

响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "total_income_amount": "2.10",
    "items": [
      {
        "id": 70001,
        "income_no": "IN202606170001",
        "artist_id": 20001,
        "artist_user_id": 20002,
        "fan_user_id": 10001,
        "fan_nickname": "Tieup用户",
        "order_no": "TO202606170001",
        "business_type": "video_call",
        "business_id": 40001,
        "actual_duration_seconds": "1分钟40秒",
        "fan_no_show": 2,
        "total_amount": "3.00",
        "settlement_base_amount": "3.00",
        "artist_income_amount": "2.10",
        "platform_fee_amount": "0.90",
        "share_ratio": "70.00",
        "settlement_status": 2,
        "settled_at": "2026-06-17 10:00:00",
        "refund_no": null,
        "created_at": "2026-06-17 10:00:00"
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total": 1,
      "next_cursor": null
    }
  }
}

说明：现金订阅支付成功后写入收入记录，默认 share_ratio = 70.00。非 iOS 订阅的 settlement_base_amount 等于实付金额；iOS 订阅按购买时普通月费或年费快照计算艺人收入，例如实付 140.00、普通价 98.00 时，艺人收入为 68.60，平台金额为 71.40。个人艺人收入同步进入 tieup_artist.withdrawable_amount 并写 tieup_artist_transaction.change_type = 1；经纪公司艺人收入保留待结算，由经纪公司结算流程处理。提问、追问、视频通话和福利使用糖果扣减，服务完成时按 tieup_business_config.basic.candy_cash_exchange_rate 折算现金收入，默认 100 糖果 = 1 元。