列卡配置

返回某个卡头下可选的套餐配置（费率、首充、月费等）。客户端根据费用选择最合适的套餐。

只返回当前账号实际可开的套餐：客户经理已对该账号关闭的套餐不会出现；header_id 必须来自 /card_headers/list —— 账号不可开的客户经理管控卡头会被拒绝（400 account_manager_bind_required / account_manager_unavailable / account_manager_open_disabled）。

端点

项	值
Method	POST
Path	/api/v1/openapi/card_configs/list
鉴权	HMAC
幂等键	不需要

请求字段

字段	类型	必填	说明
`header_id`	string	✅	`hdr_<id>` 格式（来自列卡头）

请求示例

json

{ "header_id": "hdr_5" }

响应字段

data.list[] 中每项：

字段	类型	说明
`package_id`	string	`pkg_<id>` 格式（apply 时回传）
`name`	object	i18n 名称
`currency`	string	卡内币种 ISO 4217（如 `USD`）
`open_card_fee`	string (decimal)	开卡费金额
`open_card_fee_asset`	string	开卡费资产符号（如 `USDT`）
`initial_deposit`	string (decimal)	首充底额——开卡时 1:1 免手续费进卡；也是不传 `first_deposit_amount` 时的默认首充
`min_first_deposit`	string (decimal)	生效首充最低金额（`max(initial_deposit, 套餐/卡头首充最低)`，含底额）。开卡的 `first_deposit_amount` 必须 ≥ 该值；该值高于 `initial_deposit` 时开卡必须显式传 `first_deposit_amount`
`min_recharge`	string (decimal)	最小单次充值
`max_recharge`	string (decimal)	最大单次充值
`monthly_fee`	string (decimal)	月费
`monthly_fee_asset`	string	月费资产符号
`recharge_fee`	`FeeSpec`	充值手续费
`close_fee`	`FeeSpec`	销卡手续费
`authorization_fee`	`FeeSpec`	授权交易费
`cross_border_fee`	`FeeSpec`	跨境交易费
`refund_fee`	`FeeSpec`	退款交易费
`is_default`	bool	是否为推荐默认套餐
`description`	object	i18n 套餐说明
`kyc_requirement`	object	该套餐开卡的有效平台实名要求（卡头 > 卡配置 > 卡类型三级合并，即 apply 实际校验口径）。结构同卡头列表的 `kyc_requirement`；`require_kyc=true` 且账号未达标时 apply 返回 `400 kyc_required`

`FeeSpec`

字段	类型	说明
`type`	string	`fixed` / `percent` / `fixed_plus_percent` / `unknown`
`rate`	string (decimal)	百分比费率（type=percent / fixed_plus_percent）
`fixed`	string (decimal)	固定费用（type=fixed / fixed_plus_percent）
`asset_symbol`	string	费用资产符号（如 `USDT`）

默认套餐选择规则

优先 is_default == true
否则按 (open_card_fee ASC, min_recharge ASC) 排序，取第一个

响应示例

json

{
  "code": 200,
  "message": "成功",
  "data": {
    "list": [
      {
        "package_id": "pkg_12",
        "name": { "zh-CN": "基础套餐", "en-US": "Basic" },
        "currency": "USD",
        "open_card_fee": "5.00",
        "open_card_fee_asset": "USDT",
        "initial_deposit": "10.00",
        "min_first_deposit": "10.00",
        "min_recharge": "10.00",
        "max_recharge": "10000.00",
        "monthly_fee": "0",
        "monthly_fee_asset": "USDT",
        "recharge_fee": {
          "type": "percent",
          "rate": "0.02",
          "fixed": "0",
          "asset_symbol": "USDT"
        },
        "close_fee": {
          "type": "fixed",
          "rate": "0",
          "fixed": "1.00",
          "asset_symbol": "USDT"
        },
        "authorization_fee": {
          "type": "fixed", "rate": "0", "fixed": "0.20", "asset_symbol": "USDT"
        },
        "cross_border_fee": {
          "type": "percent", "rate": "0.015", "fixed": "0", "asset_symbol": "USDT"
        },
        "refund_fee": {
          "type": "fixed", "rate": "0", "fixed": "0", "asset_symbol": "USDT"
        },
        "is_default": true,
        "description": {
          "zh-CN": "适合个人小额消费",
          "en-US": "For personal small spending"
        },
        "kyc_requirement": {
          "require_kyc": true,
          "kyc_type": "personal",
          "kyc_level": "l2"
        }
      }
    ],
    "total": 3,
    "page": 1,
    "page_size": 3,
    "total_pages": 1,
    "has_next": false,
    "has_prev": false
  }
}

典型错误

HTTP	message_key	说明
400	`openapi_invalid_header_id`	header_id 格式错或不存在
400	`openapi_card_type_not_supported`	header 对应的卡类型不在虚拟卡范围
400	`account_manager_bind_required`	客户经理管控卡头，而账号未绑定客户经理
400	`account_manager_unavailable`	账号绑定的客户经理已失效；请联系平台客服
400	`account_manager_open_disabled`	客户经理未对该账号放开此卡头（这类卡头不会出现在 `/card_headers/list`）
401	`openapi_invalid_credentials`	鉴权失败
500	`openapi_list_card_configs_failed`	服务端异常

列卡配置 ​

端点 ​

请求字段 ​

请求示例 ​

响应字段 ​

FeeSpec ​

响应示例 ​

典型错误 ​