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