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 |
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": "subscription",
"business_id": 30001,
"total_amount": "140.00",
"settlement_base_amount": "98.00",
"artist_income_amount": "68.60",
"platform_fee_amount": "71.40",
"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": "subscription_paid",
"payment_amount": "140.00",
"settlement_base_amount": "98.00",
"settlement_base_difference_amount": "42.00",
"ios_markup_amount": "42.00",
"share_ratio": "70.00",
"platform_fee_ratio": "30.00"
}
}
}