8. 偶像端 API 8.39 提现详情【基础探测通过，待数据联调】

Table of Contents

8.39 提现详情【基础探测通过，待数据联调】

GET /tieup/api/v1/artist/withdrawals/{withdraw_no}

路径参数：

参数 类型 必填 说明
withdraw_no string 是 提现单号

响应字段：

字段 类型 说明
id integer 提现记录主键 ID
withdraw_no string 提现单号
artist_id integer 当前登录用户对应的偶像 ID
user_id integer 当前登录的 APP 用户 ID
withdraw_amount string 提现金额
user_fee object 申请时锁定的平台提现服务费，结构为 {fee,val}
provider_pay_amount string 云账户试算和下单金额
tax_amount string 本次预扣税额
estimated_received_amount string 申请时锁定的云账户预计到账金额
actual_amount string 云账户最终实际到账金额；支付成功前为 "0.00"
account_type integer 账户类型：1=支付宝，2=微信，3=银行卡
account_name string 申请提现时保存的收款账户姓名
account_no string 申请提现时保存的完整收款账号，仅当前偶像查询自己的提现详情时返回
account_no_masked string 脱敏后的收款账号，兼容旧前端展示
bank_name string/null 开户银行
bank_branch string/null 开户支行
status integer 提现状态，兼容内部字段
withdraw_status integer 提现状态：1=待审核，2=审核通过，3=审核拒绝，4=打款中，5=已完成，6=打款失败，7=已取消
funds_status integer 资金状态：1=冻结中，2=已完成，3=已退回
funds_status_label string 资金状态中文说明
applied_at string/null 提现申请时间
audited_at string/null 审核时间，未审核时为 null
paid_at string/null 打款完成时间，未完成时为 null
failed_reason string/null 审核拒绝或打款失败原因，无失败时为 null
created_at string/null 提现记录创建时间
account_snapshot object 申请提现时保存的收款账户快照
account_snapshot.account_type integer 账户类型：1=支付宝，2=微信，3=银行卡
account_snapshot.account_type_label string 账户类型中文
account_snapshot.account_name string 收款账户姓名
account_snapshot.account_no string 完整收款账号，与顶层 account_no 一致
account_snapshot.account_no_masked string 脱敏后的收款账号
account_snapshot.bank_name string/null 开户银行
account_snapshot.bank_branch string/null 开户支行
extra object 提现申请时保存的客户端、提现规则与扣税计算快照；旧数据无快照时为空对象

响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "id": 1,
    "withdraw_no": "WD202606170001",
    "artist_id": 20001,
    "user_id": 20002,
    "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",
    "account_type": 1,
    "account_name": "李四",
    "account_no": "alipay_account@example.com",
    "account_no_masked": "al**************.com",
    "bank_name": null,
    "bank_branch": null,
    "status": 1,
    "withdraw_status": 1,
    "funds_status": 1,
    "funds_status_label": "冻结中",
    "applied_at": "2026-06-17 10:00:00",
    "audited_at": null,
    "paid_at": null,
    "failed_reason": null,
    "created_at": "2026-06-17 10:00:00",
    "account_snapshot": {
      "account_type": 1,
      "account_type_label": "支付宝",
      "account_name": "李四",
      "account_no_masked": "al**************.com",
      "account_no": "alipay_account@example.com",
      "bank_name": null,
      "bank_branch": null
    },
    "extra": {
      "client_ip": "203.0.113.10",
      "withdraw_account_id": 1,
      "withdraw_window": {
        "current_day": 3,
        "start_day": 1,
        "end_day": 5,
        "is_open": true,
        "next_open_at": null
      },
      "withdraw_config": {
        "min_withdraw_amount": "100.00",
        "withdraw_service_fee_rate": "10.00",
        "window_start_day": 1,
        "window_end_day": 5,
        "arrival_day": 15,
        "tax_enabled": true
      },
      "tax_calculation": {
        "withdraw_amount": "2000.00",
        "user_fee": {"fee": "10", "val": "200.00"},
        "provider_pay_amount": "1800.00",
        "estimated_tax_amount": "90.00",
        "estimated_after_tax_amount": "1710.00",
        "estimated_received_amount": "1710.00",
        "estimated_user_fee_amount": "0.00",
        "tax_detail": {
          "user_personal_tax": {"text": "劳动者预扣个税", "val": "90.00"},
          "user_value_added_tax": {"text": "劳动者预扣增值税", "val": "0.00"},
          "user_additional_tax": {"text": "劳动者预扣附加税费", "val": "0.00"},
          "user_recover_tax_amount": {"text": "追缴增附税", "val": "0.00"},
          "user_recover_personal_tax_amount": {"text": "追缴个税", "val": "0.00"},
          "user_refund_tax_amount": {"text": "退回增附税", "val": "0.00"},
          "user_refund_personal_tax_amount": {"text": "退回个税", "val": "0.00"}
        }
      }
    }
  }
}

业务规则：

  • 接口先按当前登录用户定位偶像，再同时使用 artist_id 和 withdraw_no 查询提现单；不能读取其他偶像的收款账号。
  • account_no 读取提现申请时固化到提现单的账户快照，账户后续编辑或删除不会改变历史提现详情。
  • 提现记录列表和申请提现响应继续只返回 account_no_masked，完整账号仅在当前偶像的提现详情中返回。
  • 提现主状态和资金状态必须分别展示；withdraw_status=6 可能是资金仍冻结的下单失败，也可能是已经退回的支付失败或银行卡退汇，APP 不得仅凭主状态推断资金是否已释放。