Skip to main content

虚拟卡

无论您面向哪个市场、服务哪类终端用户,都可以在数秒内为其签发一张可立即消费的虚拟卡,无需等待制卡与邮寄。DCS 作为持牌发卡机构、自有 BIN Sponsor,在合作伙伴自管模式下为接入机构提供合规、可控的发卡能力——额度由接入机构掌握,授权由接入机构决策,DCS 负责卡的签发、生命周期与卡组织结算。 虚拟卡(Virtual Card)是一种无实体介质的数字化支付卡,具备与实体卡一致的消费授权与状态管理能力,适配线上支付、订阅、跨境结算等场景,是接入机构与终端用户之间的核心资金载体。

为什么选择虚拟卡


虚拟卡的创建流程

虚拟卡的签发以卡订单(Card Order)为驱动,整个流程异步执行:您提交一次申请请求,DCS 返回 cardOrderId,随后通过查询接口或 Webhook 跟踪状态直至终态。
虚拟卡创建流程虚拟卡创建流程
申请所需的前置条件(企业 Enterprise、卡配置 Card Profile)、完整请求字段与卡订单状态都集中在 申请卡 一页,本页不再重复。

申请虚拟卡(速览)

POST /open-api/card-order/v1/apply-virtual 最小必填字段: 调用前请先完成 申请 KYC 拿到 kycTicketId,再以 kycTicketId + customerId 发卡。 成功响应返回卡订单的关键信息:
关于统一响应结构:所有接口都包裹在 { code, message, messageDetail, data } 中——code 为系统级返回码(如 SYS_SUCCESS),message 为简要说明,messageDetail 为可直接面向终端用户展示的结构化文案(含 title/type/action/linkUrl 等),业务数据在 data 内。
申请请求需携带的鉴权头与 Content-Type、以及 code 取值字典,统一以 鉴权指南 一页为准。
完整字段表、加密细节与 needExtraInfo(KYC 补充信息)的处理动作,请见 开卡流程

卡订单状态(虚拟卡)

当状态为 FAILED,响应与 CARD_ORDER Webhook 中会带 errorCodeerrorReason。错误码归类与「可否重试 / 用户怎么办 / 能否补件」请见 卡申请错误码
状态跟踪可调用 GET /open-api/card-order/v1/detail 查询,或订阅 CARD_ORDER Webhook 被动接收。

虚拟卡转实体卡

虚拟卡可在后续申请转为实体卡。关键约定
  • 转换成功后会生成一个不同于原虚拟卡的 cardId,但两张卡的卡号保持一致
  • 实体卡激活前,所有授权仍归属原虚拟卡;
  • 实体卡激活后,原虚拟卡被注销,授权转归实体卡。
具体步骤见 实体卡

领取卡敏感信息

虚拟卡的卡号、CVV、过期时间属于敏感信息,须通过加密接口领取,并直接在前端向终端用户展示——
  • 持 PCI 资质的接入机构:调用 retrieve-secure-card 获取加密卡信息,自行解密后向用户展示;
  • 无 PCI 资质的接入机构:通过托管引导页在 DCS 页面向用户展示,敏感数据不经接入机构系统。
详见 领取卡敏感信息

下一步

  • 准备好前置条件后,前往 申请卡 查看完整字段与申请模式。
  • 卡片签发后,前往 卡管理 了解冻结、解冻、注销与换卡。
  • 需要限制单笔/周期消费,请见 消费限额