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

# 卡产品配置（profileId）

> 说明 profileId / cardProfileId 的使用与线下分配方式

## 📄 正文

无论您计划发行哪一种卡——虚拟卡或实体卡、单一币种或多市场——都可以基于一份<b>卡配置（Card Profile）</b>完成定义：它决定了卡片用哪个 BIN、走哪个卡组织、币种、PAN/PIN 规则与卡片限额。作为持牌、自有 BIN 的发卡机构，DCS 会为每个接入机构（Enterprise）专属维护卡配置，让发卡规则与您的业务边界对齐。

卡配置是卡片全生命周期的底层模板。配置一经设定，其规则便贯穿开卡、授权、清算各环节；当您的发卡方式发生变化时，可由 DCS 协助更新。

### 核心概念

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/dcs-0bf7a937/oUoeUKtwWWK2o-Li/imgs/diagrams/pa-card-profile-light.svg?fit=max&auto=format&n=oUoeUKtwWWK2o-Li&q=85&s=b60e84beb7b5515c59505b4a6b90fe74" alt="接入机构、卡配置与卡订单的关系" width="794" height="262" data-path="imgs/diagrams/pa-card-profile-light.svg" />

  <img className="hidden dark:block" src="https://mintcdn.com/dcs-0bf7a937/oUoeUKtwWWK2o-Li/imgs/diagrams/pa-card-profile-dark.svg?fit=max&auto=format&n=oUoeUKtwWWK2o-Li&q=85&s=1b8bae19e6776c3fb1ae58b43343458b" alt="接入机构、卡配置与卡订单的关系" width="794" height="262" data-path="imgs/diagrams/pa-card-profile-dark.svg" />
</Frame>

* 一个 **Enterprise 可拥有多份卡配置**，用于在同一主体下发行多种类型的卡（例如不同币种、不同市场、虚拟/实体）。
* 每份卡配置由 `profileId` 唯一标识，归属于某个 `enterpriseId`。
* 创建卡订单时，通过传入 `profileId` 指明要使用哪一份卡配置。

### 卡配置包含哪些规则

| 规则类别     | 典型内容                                 |
| -------- | ------------------------------------ |
| 卡组织与 BIN | 发卡机构识别号（IIN/BIN）、卡组织（Visa 等）         |
| 卡片属性     | 主账号（PAN）长度、有效期、PIN 长度、币种             |
| 限额       | 卡片消费限额等（详见[限额查询](./velocity-limits)） |
| 实体卡制造    | 物理卡生产所需的发卡机构信息                       |

### 卡配置字段

| 字段名            | 类型     | 说明                                                         |
| -------------- | ------ | ---------------------------------------------------------- |
| `profileId`    | String | 卡配置唯一标识符。创建卡订单（`profileId`）、查询企业余额（`cardProfileId`）等接口引用此值 |
| `enterpriseId` | String | 关联的企业（Enterprise）ID                                        |

> **字段命名说明**：卡配置在各接口中以 `profileId` 标识；其中查询企业账户余额接口使用的字段名为 `cardProfileId`，两者指向同一卡配置。请在创建卡订单（`profileId`）、引导页（`type=7` 时 `profileId` 必填）等接口中以接口文档列明的字段名为准。

### 谁来配置

| 任务                              | 谁做       |
| ------------------------------- | -------- |
| 设计与维护卡配置（BIN、卡组织、币种、限额、实体卡制造信息） | **DCS**  |
| 提供发卡需求（目标市场、币种、虚拟/实体、卡面等）与商务洽谈  | **接入机构** |
| 获取分配到的 `profileId` 并在开卡时引用      | **接入机构** |

卡配置由 DCS 团队为您配置后下发 `profileId`，暂不提供自助创建/查询接口；如需核对名下可用的 `profileId`，请联系您的 DCS 对接人。

### 前置条件

* 已成功创建企业（Enterprise）。卡配置必须挂在一个已存在的 Enterprise 之下；如尚未开通，请参阅[入驻指南](../../getting-started/first-steps)。
* **可选（实体卡）**：如计划发行实体卡，请提前与 DCS 商务团队洽谈，以便为您选择最合适的卡片制造商。

### 如何使用 profileId

获得 `profileId` 后，在创建卡订单时传入即可指定使用哪一份卡配置：

```http theme={null}
POST /open-api/card-order/v1/apply-virtual
```

```json theme={null}
{
  "profileId": "<DCS 分配的卡配置 ID>",
  "cardOrderRef": "<接入机构侧幂等键>",
  "cardApplyMode": "NORMAL",
  "kycTicketId": "<已通过的 KYC 工单 ID>",
  "customerId": "<用户 ID>"
}
```

> 完整的请求字段、响应结构 `{ code, message, messageDetail, data }` 与错误码，请见[开卡流程](./card-issuing)。

## 下一步

`profileId` 就绪后，前往[开卡流程](./card-issuing)创建第一张卡；如需了解额度规则，请参阅[限额查询](./velocity-limits)。