Skip to main content

📄 正文

无论您面向的是高净值持卡人、差旅人群还是线下消费场景,都可以通过合作伙伴自管模式为终端用户发行 DCS 实体卡——一张可在全球线下商户、ATM 与数字钱包中使用的 Visa 卡。实体卡与虚拟卡共享同一套开卡、KYC、授权与清算流程,区别只在于其有形载体、寄送环节与激活步骤。 实体卡是有形的支付工具,内嵌 EMV 芯片与非接触(NFC)技术,印有卡号、有效期与卡片识别信息,可在超过 99% 的线下受理点使用。卡面支持品牌定制(如压花名字、企业卡面编码),帮助您向持卡人传递品牌形象。

实体卡与虚拟卡

实体卡与虚拟卡是互补而非替代关系。建议您让终端用户用虚拟卡覆盖线上支付与订阅、用实体卡覆盖线下消费与差旅。

如何为用户发行实体卡

DCS 实体卡通过虚拟卡换实体卡订单产生:先有一张虚拟卡,再针对该卡发起换卡订单,附上寄送地址与卡面信息。
虚拟卡转实体卡申请时序图虚拟卡转实体卡申请时序图
接口POST /open-api/card-order/v1/virtual-to-physical(谁做:接入机构发起) 最小请求体:
请求字段(节选,完整约束见 API 参考):
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(谁做:接入机构在持卡人收到卡后发起) 请求体:
成功后卡 statusPENDING_ACTIVATION 变为 ACTIVATED,响应 data 同时返回 typePHYSICAL)、panFirst6panLast4 等。卡状态流转与冻结/解冻/换卡详见 卡管理

下一步

实体卡发行成功后,请前往 卡管理 了解冻结/解冻、PIN 与换卡操作;如需把实体卡推送至 Apple Pay 与 Google Pay,请参阅 推送绑卡