#4.2.2 H5 充值地址配置【已开发，待登录态和地区联调】

GET /tieup/api/v1/app/h5-recharge-config
Authorization: Bearer <access_token>

鉴权：仅验证 APP 登录状态，粉丝端和艺人端身份均可调用。接口不接收请求参数，配置渠道以当前登录用户的 channel_code 为准，客户端不能指定其他渠道。

响应字段：

开启时完整响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "enabled": true,
    "h5_recharge_url": "https://pay.example.com/recharge",
    "h5_recharge_description": "请使用浏览器打开充值页面",
    "withdraw_enabled": true,
    "withdraw_text_enabled": true,
    "withdraw_text_content": "提现将在每月15日前到账",
    "h5_withdraw_url": "https://example.com/withdraw",
    "scout_alliance_enabled": true,
    "h5_scout_alliance_url": "https://example.com/scout-alliance",
    "welfare_display_enabled": true
  }
}

关闭或明确境外 IP 的完整响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "enabled": false,
    "withdraw_enabled": true,
    "withdraw_text_enabled": true,
    "withdraw_text_content": "",
    "h5_withdraw_url": "",
    "scout_alliance_enabled": true,
    "h5_scout_alliance_url": "",
    "welfare_display_enabled": true
  }
}

地区判断说明：

• 服务端按 X-Forwarded-For、X-Real-IP、连接地址的顺序提取首个合法 IP，并使用本地 IPv4/IPv6 数据库查询，不调用外部地区接口。
• 中国大陆、香港、澳门、台湾继续读取后台 h5_recharge_display_enabled、h5_recharge_url 和 h5_recharge_description；明确为其他国家或地区时仅关闭 H5 充值入口，但仍返回提现、星探联盟和福利显示开关及相关地址。
• 私网、回环、非法 IP、数据库缺失或查询异常视为“无法识别”，不会拦截，继续返回后台实际开关。
• H5 充值开关默认关闭，提现、提现文字、星探联盟和福利显示开关默认开启；提现文字内容默认为空；地址、文字内容及开关均支持平台默认和当前登录用户所属渠道覆盖。H5 充值关闭时不返回充值地址或描述；提现和星探联盟地址、提现文字内容及福利显示开关始终返回，APP 应依据对应开关决定是否使用或展示。