8. 偶像端 API 8.38 提现记录【基础探测通过，待数据联调】

Table of Contents

8.38 提现记录【基础探测通过，待数据联调】

GET /tieup/api/v1/artist/withdrawals

查询参数：

参数 类型 必填 说明
status integer 否 提现状态：1=待审核，2=审核通过，3=审核拒绝，4=打款中，5=已完成，6=打款失败，7=已取消
page integer 否 当前页码，默认 1
page_size integer 否 每页数量，默认 20

返回 items 和 pagination。 响应字段：

字段 类型 说明
items array 当前页数据列表
items[].withdraw_no string 提现单号
items[].withdraw_amount string 提现金额
items[].user_fee object 申请时锁定的平台提现服务费，结构为 {fee,val}
items[].provider_pay_amount string 云账户试算和下单金额
items[].tax_amount string 本次预扣税额
items[].estimated_received_amount string 申请时锁定的云账户预计到账金额
items[].actual_amount string 云账户最终实际到账金额；支付成功前为 "0.00"
items[].withdraw_status integer 提现状态：1=待审核，2=审核通过，3=审核拒绝，4=打款中，5=已完成，6=打款失败，7=已取消
items[].funds_status integer 资金状态：1=冻结中，2=已完成，3=已退回
items[].funds_status_label string 资金状态中文说明
items[].account_snapshot object 申请提现时的账户快照，账号仅返回脱敏值
items[].created_at string 创建时间
pagination.page integer 当前页码
pagination.page_size integer 每页数量
pagination.total integer 总数量

响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "items": [
      {
        "withdraw_no": "WD202606170001",
        "withdraw_amount": "2000.00",
        "user_fee": {"fee": "10", "val": "200.00"},
        "provider_pay_amount": "1800.00",
        "tax_amount": "90.00",
        "estimated_received_amount": "1710.00",
        "actual_amount": "0.00",
        "withdraw_status": 1,
        "funds_status": 1,
        "funds_status_label": "冻结中",
        "account_snapshot": {
          "account_type": 1,
          "account_type_label": "支付宝",
          "account_name": "李四",
          "account_no_masked": "al**************.com",
          "bank_name": null,
          "bank_branch": null
        },
        "created_at": "2026-06-17 10:00:00"
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total": 1,
      "next_cursor": null
    }
  }
}