卡产品配置（profileId） - DCS Technical Documentation

📄 正文

无论您计划发行哪一种卡——虚拟卡或实体卡、单一币种或多市场——都可以基于一份卡配置（Card Profile）完成定义：它决定了卡片用哪个 BIN、走哪个卡组织、币种、PAN/PIN 规则与卡片限额。作为持牌、自有 BIN 的发卡机构，DCS 会为每个接入机构（Enterprise）专属维护卡配置，让发卡规则与您的业务边界对齐。卡配置是卡片全生命周期的底层模板。配置一经设定，其规则便贯穿开卡、授权、清算各环节；当您的发卡方式发生变化时，可由 DCS 协助更新。

核心概念

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

卡配置包含哪些规则

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

卡配置字段

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

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

谁来配置

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

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

前置条件

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

如何使用 profileId

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

POST /open-api/card-order/v1/apply-virtual

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

完整的请求字段、响应结构 { code, message, messageDetail, data } 与错误码，请见开卡流程。

下一步

profileId 就绪后，前往开卡流程创建第一张卡；如需了解额度规则，请参阅限额查询。

​📄 正文

​核心概念

​卡配置包含哪些规则

​卡配置字段

​谁来配置

​前置条件

​如何使用 profileId

​下一步