8. 偶像端 API 8.31 收入详情【基础探测通过，待数据联调】

Table of Contents

8.31 收入详情【基础探测通过，待数据联调】

GET /tieup/api/v1/artist/income-records/{income_id}

路径参数：

参数 类型 必填 说明
income_id integer 是 收入明细 ID

响应字段：

字段 类型 说明
id integer 收入明细 ID
income_no string 收入记录编号
artist_id integer 艺人 ID
artist_user_id integer 艺人关联用户 ID
fan_user_id integer/null 来源粉丝用户 ID
fan_nickname string 来源粉丝用户昵称；用户不存在或昵称为空时返回空字符串
order_no string/null 平台订单号
business_type string 收入业务类型
business_id integer/null 业务记录 ID
sub_type string 仅 business_type=subscription 返回；订阅周期类型：month=月订阅，year=年订阅
actual_duration_seconds string 仅 business_type=video_call 返回；数据库实际保存秒数，接口返回可读时长文本，例如 100 秒返回 1分钟40秒，未开始通话返回 0秒
fan_no_show integer 仅 business_type=video_call 返回；1=粉丝爽约，2=粉丝未爽约；预约状态 6/7 返回 1
total_amount string 用户实付或业务折现总收入，单位元，两位小数
settlement_base_amount string 艺人分成结算基数，单位元，两位小数
artist_income_amount string 艺人收入金额，单位元，两位小数
platform_fee_amount string 总收入减艺人收入，单位元，两位小数
share_ratio string 应用于结算基数的艺人分成比例
settlement_status integer 结算状态：1=待结算，2=已入账，3=已退款扣回，4=已取消
settled_at string/null 入账时间
refund_no string/null 关联退款单号
created_at string/null 创建时间
extra object 收入计算快照，包含来源、实付金额、结算基数、差额、iOS 加价金额及分成配置

响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "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",
    "extra": {
      "source": "candy_business_completed",
      "payment_amount": "3.00",
      "settlement_base_amount": "3.00",
      "settlement_base_difference_amount": "0.00",
      "ios_markup_amount": "0.00",
      "booking_no": "VC202606170001",
      "video_call_plan_code": "call_10m",
      "duration_minutes": 10,
      "actual_duration_seconds": 100,
      "share_ratio": "70.00",
      "platform_fee_ratio": "30.00"
    }
  }
}