6. 公开资源 API 6.6 充值套餐列表【基础探测通过，待数据联调】

Table of Contents

6.6 充值套餐列表【基础探测通过，待数据联调】

GET /tieup/api/v1/recharge-packages

响应字段：

字段 类型 说明
data array 充值套餐数组；无可用套餐时为空数组 []
data[].package_code string 充值套餐编码；创建充值订单时作为 package_code 传入
data[].package_name string 充值套餐名称
data[].pay_amount string 支付金额，单位元，固定两位小数
data[].candy_amount integer 到账糖果数量
data[].gift_candy_amount integer 赠送糖果数量
data[].currency string 币种，例如 CNY
data[].product_id string iOS Apple IAP Product ID；来源于后台充值套餐 config.ios_product_id，非 iOS 或未配置时为空字符串
data[].is_hot integer 是否热门：0=否，1=是；来源于后台充值套餐扩展配置 config.is_hot，缺失或非法值按 0 返回
data[].config object/null 后台扩展配置响应值；当前可包含 visible、tag、is_hot、ios_product_id 等字段
data[].config.visible boolean 前端是否展示；后台未配置时可能不存在
data[].config.tag string 运营标签，例如 热销、赠送
data[].config.is_hot integer 后台保存的热门标识：0=关，1=开
data[].config.ios_product_id string App Store Connect 消耗型商品 ID

响应示例：

{
  "code": 200,
  "message": "成功",
  "data": [
    {
      "package_code": "candy_100",
      "package_name": "100糖果包",
      "pay_amount": "10.00",
      "candy_amount": 100,
      "gift_candy_amount": 0,
      "currency": "CNY",
      "product_id": "tieup.candy.100",
      "is_hot": 1,
      "config": {
        "visible": true,
        "tag": "热销",
        "is_hot": 1,
        "ios_product_id": "tieup.candy.100"
      }
    }
  ]
}

说明：本接口只返回当前渠道、平台和市场可用且处于有效时间窗口内的启用套餐；APP 展示金额使用 pay_amount，创建糖果充值订单仍只需提交 package_code 和支付方式，不需要回传金额。后台未配置 config.is_hot 的旧套餐，接口顶层 is_hot 固定返回 0。iOS 糖果充值使用 product_id 发起 StoreKit 购买，服务端下单和小票确认仍以后台套餐配置快照为准。