快速开始 - DCS Technical Documentation

📄 正文

本指南带您在沙盒环境调通核心接口，发出第一张虚拟卡。全程 5 步。沙盒地址：https://api.thedecard-sandbox.com

以下示例省略鉴权头与字段加密。所有请求都需携带四个鉴权头（X-DAPI-API-KEY / X-DAPI-TIMESTAMP / X-DAPI-NONCE / X-DAPI-SIGN）并设置 Content-Type: application/json，手机号、邮箱、KYC 等敏感字段需 AES 加密——规则见鉴权指南。

分步路径的好处（创建用户 → 申请 KYC → 申请卡）：

KYC 工单可复用：同一用户开第二张卡时无需重交资料，复用同一个 kycTicketId；

状态可控、易排查：KYC 与开卡解耦，各自有独立工单与状态线。

1. 创建用户

POST /open-api/customer/v1/create-customer

{ "phoneCountryCode": "SG", "phone": "+6591234567", "email": "user@example.com", "customerRef": "your-uniq-ref-001" }

响应返回 customerId，后续步骤都要用：

{ "code": "SYS_SUCCESS", "message": "success", "messageDetail": null, "data": { "customerId": "C100001", "status": "SUCCEED" } }

2. 申请 KYC 工单

证件文件要先上传：调 POST /open-api/intent-ticket/v1/generate-pre-upload-url（businessType=CREATE_CARD_KYC）取临时上传地址，PUT 文件后拿到 objectKey，填入下面的 identityProofUrl。完整步骤见申请 KYC「方式二步骤 1」。

POST /open-api/kyc-ticket/v1/apply-kyc

{
  "kycTicketRef": "your-kyc-ref-001",
  "customerId": "C100001",
  "identifyProofList": [ { "identityProofType": "PASSPORT", "identityProofUrl": "<预上传返回的 objectKey>" } ],
  "addressProofList": [],
  "kycCareerInfo": { "employmentStatus": "EMPLOYED", "occupation": "..." }
}

响应返回 kycTicketId：

{ "data": { "kycTicketId": "KYC_1a2b", "kycTicketRef": "your-kyc-ref-001", "status": "PENDING" } }

等待工单 PASSED：通过 KYC_TICKET Webhook 或查询接口拿结果。若状态为 NEED_VERIFY，需引导用户完成人脸认证。证件字段、状态机与拒绝码见申请 KYC；可发地区与各地区证件要求见合规与 KYC 流程。

3. 申请虚拟卡（NORMAL 模式）

KYC 工单 PASSED 后，用 kycTicketId + customerId 开卡：

POST /open-api/card-order/v1/apply-virtual

{
  "profileId": "your-card-profile-id",
  "cardOrderRef": "your-order-ref-001",
  "cardApplyMode": "NORMAL",
  "customerId": "C100001",
  "kycTicketId": "KYC_1a2b"
}

响应返回 cardOrderId。同一用户后续再开卡，复用同一个 kycTicketId 即可，无需重新提交 KYC。

4. 查询卡订单，等待开卡成功

GET /open-api/card-order/v1/detail?cardOrderId=O100001

轮询直到 status = COMPLETED，响应中即包含 cardId：

{ "data": { "cardOrderId": "O100001", "status": "COMPLETED", "cardId": "CARD100001" } }

卡订单状态线：PENDING → CUSTOMER_PASS → KYC_PASS → CHANNEL_CUSTOMER_PASS → COMPLETED。若 FAILED，看 errorCode / errorReason（错误码见卡申请错误码）。

5. 查询卡详情 —— 卡已可消费

GET /open-api/card/v1/detail?cardId=CARD100001

{ "data": { "cardId": "CARD100001", "status": "ACTIVATED", "panFirst6": "441364", "panLast4": "1234" } }

虚拟卡自动激活（实体卡需激活）。完整卡号 / CVV 需通过专门接口获取，见获取卡敏感信息。至此第一张虚拟卡已激活。持卡人消费时，DCS 会将授权请求转发到您的 auth_url，由您实时返回 Approve / Decline——这是合作伙伴自管模式的核心，见授权（转发决策）。

下一步

开卡完整流程与 KYC 细节 → 开卡流程
冻结 / 解冻 / 换卡 / 重置 PIN → 卡管理
理解资金如何流转 → 资金模型

​📄 正文

​1. 创建用户

​2. 申请 KYC 工单

​3. 申请虚拟卡（NORMAL 模式）

​4. 查询卡订单，等待开卡成功

​5. 查询卡详情 —— 卡已可消费

​下一步