> ## 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.

# 枚举值查询

> 查询 JCB 卡申请所需枚举值。

这些接口用于获取 JCB 卡申请所需枚举值。JCB 国家或地区使用 JCB 专用接口；职业编码和职位字段复用 Visa 枚举值，可直接调用对应 Visa 枚举接口。

## 接口列表

| 名称      | 方法     | 路径                                                    | 返回 `list` 项 | 说明                               |
| ------- | ------ | ----------------------------------------------------- | ----------- | -------------------------------- |
| 支持国家或地区 | `POST` | `/mc-platformapi/v1/open/jcb/card/support/country`    | 国家或地区       | JCB 专用国家或地区列表                    |
| 职业编码    | `POST` | `/mc-platformapi/v1/open/et/vs/card/support/industry` | 职业编码        | 与 Visa 申请参数 `profession` 使用同一套枚举 |
| 职位      | `POST` | `/mc-platformapi/v1/open/et/vs/card/support/position` | 职位          | 与 Visa 申请参数 `position` 使用同一套枚举   |

所有接口均使用 `application/json`，并在 `Authorization` Header 中传入完整 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": "HKG",
        "name": "Hong Kong",
        "name_cn": "中国香港"
      }
    ]
  }
}
```

### 国家或地区

| 字段        | 类型       | 说明                                 |
| --------- | -------- | ---------------------------------- |
| `code`    | `string` | 国家或地区代码，可作为 JCB 申请参数 `country` 的取值 |
| `name`    | `string` | 英文名称                               |
| `name_cn` | `string` | 中文名称                               |

### 职业编码

调用 `/mc-platformapi/v1/open/et/vs/card/support/industry` 获取，返回值与 Visa 一致，可作为 JCB 申请参数 `profession` 的取值。

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

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

### 职位

调用 `/mc-platformapi/v1/open/et/vs/card/support/position` 获取，返回值与 Visa 一致，可作为 JCB 申请参数 `position` 的取值。

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

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

## 使用说明

* `country` 使用 JCB 国家或地区接口返回的 `code`。
* `profession` 使用职业编码接口返回的 `code`，与 Visa 申请参数 `profession` 一致。
* `position` 使用职位接口返回的 `code`，与 Visa 申请参数 `position` 一致。
* 建议商户在本地缓存列表，并定期刷新。