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

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

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

响应字段:

字段 类型 说明
enabled boolean 是否显示 H5 充值入口。明确境外 IP 固定为 false;境内或无法识别的 IP 返回后台实际开关
h5_recharge_url string H5 充值地址,仅 enabled=true 时返回,地址固定为 HTTP/HTTPS

开启时完整响应示例:

{
  "code": 200,
  "message": "成功",
  "data": {
    "enabled": true,
    "h5_recharge_url": "https://pay.example.com/recharge"
  }
}

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

{
  "code": 200,
  "message": "成功",
  "data": {
    "enabled": false
  }
}

地区判断说明:

  • 服务端按 X-Forwarded-ForX-Real-IP、连接地址的顺序提取首个合法 IP,并使用本地 IPv4/IPv6 数据库查询,不调用外部地区接口。
  • 中国大陆、香港、澳门、台湾继续读取后台 h5_recharge_display_enabledh5_recharge_url;明确为其他国家或地区时不查询业务配置,直接关闭。
  • 私网、回环、非法 IP、数据库缺失或查询异常视为“无法识别”,不会拦截,继续返回后台实际开关。
  • 后台开关默认关闭;平台默认配置可由当前登录用户所属渠道覆盖。关闭响应不会返回或泄露后台已保存地址。