列卡配置

返回某個卡頭下可選的套餐配置（費率、首充、月費等）。客戶端根據費用選擇最合適的套餐。

只返回當前賬號實際可開的套餐：客戶經理已對該賬號關閉的套餐不會出現；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 ​

響應示例 ​

典型錯誤 ​