📄 正文
无论您面向的是高净值持卡人、差旅人群还是线下消费场景,都可以通过合作伙伴自管模式为终端用户发行 DCS 实体卡——一张可在全球线下商户、ATM 与数字钱包中使用的 Visa 卡。实体卡与虚拟卡共享同一套开卡、KYC、授权与清算流程,区别只在于其有形载体、寄送环节与激活步骤。 实体卡是有形的支付工具,内嵌 EMV 芯片与非接触(NFC)技术,印有卡号、有效期与卡片识别信息,可在超过 99% 的线下受理点使用。卡面支持品牌定制(如压花名字、企业卡面编码),帮助您向持卡人传递品牌形象。实体卡与虚拟卡
实体卡与虚拟卡是互补而非替代关系。建议您让终端用户用虚拟卡覆盖线上支付与订阅、用实体卡覆盖线下消费与差旅。
如何为用户发行实体卡
DCS 实体卡通过虚拟卡换实体卡订单产生:先有一张虚拟卡,再针对该卡发起换卡订单,附上寄送地址与卡面信息。POST /open-api/card-order/v1/virtual-to-physical(谁做:接入机构发起)
最小请求体:
24 小时内虚拟卡转实体卡有次数上限,超限返回 DAPI_VIRTUAL_TO_PHYSICAL_APPLY_LIMIT_EXCEEDED,需退避后重试。
寄送地址建议仅使用拉丁字符、数字与基本标点。非拉丁字符(中文、阿拉伯文等)可能无法通过制卡或物流地址校验,请在提交前转写为拉丁拼写。成功响应返回一笔卡订单,关键字段:
订单成功终态:卡订单成功终态为COMPLETED,可辅以cardId是否有值作为判据。其中PHYSICAL_SETTING_COMPLETED是虚转实流程的中间过程态、非终态(终态为COMPLETED/FAILED)。 所有接口返回统一结构{ code, message, messageDetail, data },其字段含义与成功 code/错误码字典见鉴权指南。实体卡寄送时效与费用以与 DCS 约定的卡配置为准,相关字段当前不随接口响应或 Webhook 返回。
⚠️ 新旧两张卡的关系(必读)
虚转实完成后,同一位持卡人名下会同时存在两个 cardId。这一段决定了您在激活前后该用哪个cardId、以及授权该记在哪张卡上:
因此:激活是一个切换点。请在收到激活成功后,把后续查询、冻结、限额等操作的
cardId 从虚拟卡切到实体卡;同时注意原虚拟卡转为 INVALID 属于预期行为,不是异常。
如何激活实体卡
实体卡寄达后需激活才能使用,虚拟卡则自动激活无需此步。POST /open-api/card/v1/physical-active(谁做:接入机构在持卡人收到卡后发起)
请求体:
成功后卡
status 由 PENDING_ACTIVATION 变为 ACTIVATED,响应 data 同时返回 type(PHYSICAL)、panFirst6、panLast4 等。卡状态流转与冻结/解冻/换卡详见 卡管理。

