前置准备 - DCS Technical Documentation

📄 正文

在调用任何接口前，您需要先与 DCS 完成开通、领取密钥并配置回调。本页帮您把这些准备就绪——全部完成后，即可前往快速开始跑通第一张卡。

准备步骤

联系 DCS 开通 告知您要发行的卡类型（虚拟卡 / 实体卡）、卡组织与 BIN。DCS 将为您创建企业（Enterprise）并线下分配卡配置（profileId）。
领取密钥 DCS 生成 api_key 与 secret_key 并交付给您。secret_key 用于请求签名，请妥善保管。签名规则见鉴权指南。
配置回调 向 DCS 提供三项：webhook_url（业务通知地址）、auth_url（授权通知地址）、external_public_key（授权通知验签用的 RSA 公钥）。
加入 IP 白名单 向 DCS 提供您的静态出口 IP，由 DCS 加入白名单后方可调用接口。
准备就绪 以上完成后，前往快速开始，在沙盒环境跑通第一张卡。

我们提供 Java SDK 以加速接入（可选）：dcs-connector-java。导入后填入自己的 apiKey / secretKey 即可开始，签名逻辑由 SDK 处理。

<dependency>
    <groupId>com.dcscc.connector</groupId>
    <artifactId>dcs-card-bridge-connector-java-clients</artifactId>
    <version>{latest-version}</version>
</dependency>

环境与约定（接入参考）

环境地址

环境	URL
沙盒	`https://api.thedecard-sandbox.com`
生产	`https://api.thedecard.com`

全局约定

业务时间字段均为 UTC+8 时区（X-DAPI-TIMESTAMP 为 Unix 毫秒时间戳，与时区无关）
币种采用 ISO 3 位货币代码，国家码采用 ISO 2 位国家代码
如无特殊说明，Enterprise 指接入机构团队

🎗 PCI：请根据贵公司是否持有 PCI 牌照选择相应接口；如持有，请提前告知 DCS 并出示证件。是否持牌将影响能否调用卡敏感信息接口。

下一步

以上准备就绪后，前往快速开始在沙盒环境跑通第一张卡；如需了解请求签名与字段加密规则，可参阅鉴权指南。