> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thedecard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 前置准备

> 说明开始接入前需要领取和准备的配置，并衔接后续的快速开始。

***

## 📄 正文

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

### 准备步骤

1. **联系 DCS 开通**
   告知您要发行的卡类型（虚拟卡 / 实体卡）、卡组织与 BIN。DCS 将为您创建**企业（Enterprise）**并线下分配**卡配置（`profileId`）**。

2. **领取密钥**
   DCS 生成 `api_key` 与 `secret_key` 并交付给您。`secret_key` 用于请求签名，请妥善保管。签名规则见 [鉴权指南](../integration-resources/authentication)。

3. **配置回调**
   向 DCS 提供三项：`webhook_url`（业务通知地址）、`auth_url`（授权通知地址）、`external_public_key`（授权通知验签用的 RSA 公钥）。

4. **加入 IP 白名单**
   向 DCS 提供您的静态出口 IP，由 DCS 加入白名单后方可调用接口。

5. **准备就绪**
   以上完成后，前往 [快速开始](./quickstart)，在沙盒环境跑通第一张卡。

<Tip>
  我们提供 Java SDK 以加速接入（可选）：[dcs-connector-java](https://github.com/decard-tech/dcs-connector-java)。导入后填入自己的 apiKey / secretKey 即可开始，签名逻辑由 SDK 处理。

  ```xml theme={null}
  <dependency>
      <groupId>com.dcscc.connector</groupId>
      <artifactId>dcs-card-bridge-connector-java-clients</artifactId>
      <version>{latest-version}</version>
  </dependency>
  ```
</Tip>

***

### 环境与约定（接入参考）

**环境地址**

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

**全局约定**

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

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

***

## 下一步

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