> ## Documentation Index
> Fetch the complete documentation index at: https://developer.speedpay.hk/llms.txt
> Use this file to discover all available pages before exploring further.

# 枚举值查询

> 查询 Visa 开卡与资料填写所需枚举值。

这些接口用于获取 Visa 申请资料、费用配置等场景中需要使用的枚举值。商户可在本地缓存结果，并定期刷新。

## 接口列表

| 名称      | 方法     | 路径                                                           | 返回 `list` 项 |
| ------- | ------ | ------------------------------------------------------------ | ----------- |
| 支持国家或地区 | `POST` | `/mc-platformapi/v1/open/et/vs/card/support/country`         | 国家或地区       |
| 支持费用类型  | `POST` | `/mc-platformapi/v1/open/et/vs/card/support/fee/type`        | 费用类型        |
| 开户目的    | `POST` | `/mc-platformapi/v1/open/et/vs/card/support/account/purpose` | 开户目的        |
| 行业类别    | `POST` | `/mc-platformapi/v1/open/et/vs/card/support/industry`        | 行业类别        |
| 财富来源    | `POST` | `/mc-platformapi/v1/open/et/vs/card/support/wealth`          | 财富来源        |
| 职位      | `POST` | `/mc-platformapi/v1/open/et/vs/card/support/position`        | 职位          |

所有接口均使用 `application/json`，并在 `Authorization` Header 中传入完整 JSON 请求体的 `SHA256withRSA` + `BASE64` 签名值。

## 请求说明

| 项目            | 说明                                                  |
| ------------- | --------------------------------------------------- |
| 方法            | `POST`                                              |
| Content-Type  | `application/json`                                  |
| Authorization | 完整 JSON 请求体经 `SHA256withRSA` 签名后再 `BASE64` 编码得到的签名值 |

### 请求参数

| 字段          | 类型        | 必填 | 说明                |
| ----------- | --------- | -- | ----------------- |
| `app_id`    | `string`  | 是  | 应用 ID，在商户平台生成     |
| `timestamp` | `integer` | 是  | Unix 秒级时间戳，参与请求验签 |

### 请求示例

```json theme={null}
{
  "app_id": "app_123456",
  "timestamp": 1784880000
}
```

## 返回说明

接口成功时返回通用响应结构，枚举数据位于 `data.list`。

## 返回示例

```json theme={null}
{
  "code": 0,
  "msg": "success",
  "data": {
    "list": []
  }
}
```

### 国家或地区

| 字段        | 类型       | 说明      |
| --------- | -------- | ------- |
| `code`    | `string` | 国家或地区代码 |
| `name`    | `string` | 英文名称    |
| `name_cn` | `string` | 中文名称    |

```json theme={null}
{
  "code": 0,
  "msg": "success",
  "data": {
    "list": [
      {
        "code": "HKG",
        "name": "Hong Kong",
        "name_cn": "中国香港"
      }
    ]
  }
}
```

### 费用类型

| 字段            | 类型       | 说明             |
| ------------- | -------- | -------------- |
| `code`        | `string` | 费用类型代码         |
| `name`        | `string` | 费用类型名称         |
| `description` | `string` | 费用类型说明，可能为空字符串 |

```json theme={null}
{
  "code": 0,
  "msg": "success",
  "data": {
    "list": [
      {
        "code": "F003",
        "name": "异常交易手续费",
        "description": ""
      }
    ]
  }
}
```

### 开户目的

| 字段     | 类型       | 说明     |
| ------ | -------- | ------ |
| `code` | `string` | 开户目的代码 |
| `name` | `string` | 开户目的名称 |

```json theme={null}
{
  "code": 0,
  "msg": "success",
  "data": {
    "list": [
      {
        "code": "01",
        "name": "消费购物(持卡人自用)"
      }
    ]
  }
}
```

### 行业类别

| 字段     | 类型       | 说明     |
| ------ | -------- | ------ |
| `code` | `string` | 行业类别代码 |
| `name` | `string` | 行业类别名称 |

```json theme={null}
{
  "code": 0,
  "msg": "success",
  "data": {
    "list": [
      {
        "code": "009",
        "name": "信息科技"
      }
    ]
  }
}
```

### 财富来源

| 字段     | 类型       | 说明     |
| ------ | -------- | ------ |
| `code` | `string` | 财富来源代码 |
| `name` | `string` | 财富来源名称 |

```json theme={null}
{
  "code": 0,
  "msg": "success",
  "data": {
    "list": [
      {
        "code": "01",
        "name": "薪金"
      }
    ]
  }
}
```

### 职位

| 字段     | 类型       | 说明   |
| ------ | -------- | ---- |
| `code` | `string` | 职位代码 |
| `name` | `string` | 职位名称 |

```json theme={null}
{
  "code": 0,
  "msg": "success",
  "data": {
    "list": [
      {
        "code": "1",
        "name": "普通员工"
      }
    ]
  }
}
```