DeCard 托管模式核心能力速览
以下为 DeCard 托管模式相较合作伙伴自管（池账户）模式的特色能力，在本套文档各专题页有详细说明。本页不展开细节，仅作为导航入口：上线前要做哪些准备？
DeCard 托管模式的接入机构在上线前需要完成下面这条主线，分工如下：接入主线的端到端时序与前置项请参阅 前置准备 与 快速开始。
终端用户注册需要哪些信息？
DeCard 托管模式下，终端用户在系统内完成注册。注册有 手机号 与 邮箱 两条互斥路径，二选一即可：
注册主线（接口以接口定义为准）：
- 按所选路径调用
POST /captcha/v1/send-mobile-code或POST /captcha/v1/send-email-code下发验证码； POST /account/v1/register提交对应路径的字段完成注册。
所有接口统一返回{code, message, messageDetail, data}结构，成功码code=SYS_SUCCESS。详见 鉴权指南。 注册成功后系统会生成用户标识（externalUserId），后续 KYC、开卡、充值、查询均以该标识关联。register接口会在响应的data字段中直接返回该标识（data就是一个字符串），请在注册成功时保存。注册接口与字段的完整说明见 用户注册。 示例一律使用脱敏占位：手机号+65xxxxxxxx、邮箱user@example.com，切勿 在工单或日志中携带真实终端用户信息。
终端用户 KYC 需要准备哪些资料？
KYC 验证由 DCS 在系统内部完成自动审核与人工审核。终端用户需提供：- 身份证明（POI）：可接受的证件类型（如护照、身份证、驾照）因国家/地区而异，以 DCS 提供的证件白名单为准；
- 地址证明（POA）：部分国家/地区或在 Sumsub 验证仅含 POI 时，需额外补充 POA；
- 自拍/活体（Selfie）：用于核验证件与本人一致。
各国家/地区可接受的 POI/POA 白名单及是否必须 POA，见 合规 · KYC 证件说明。KYC 五种状态（KYC 审核时长与标准化拒绝原因码需根据卡产品配置和合规要求确认。UNDO/INIT/PENDING/PASS/REFUSE）见 合规 · 概述。
REFUSE 是本次申请的最终状态；如需重新发起申请，系统限制 24 小时内最多提交 10 次（上限可配置）。
KYC 用 Sumsub Share Token 还是 DCS 托管 H5？两种方式怎么选？
这取决于接入机构自身是否已有 KYC 能力：
使用 Sumsub 时，接入机构需在 Sumsub 平台为沙盒与生产环境分别配置 DCS 的合作伙伴令牌。上线前请向 DCS 确认应使用哪种 Token 共享模式，并确保已与 Sumsub 签署对应合约——未签约会影响上线。
Sumsub KYC 资料共享的两种方式与接入步骤见 Sumsub KYC 资料共享；H5 引导页参数见 H5 KYC 与开卡引导页。
跨境资金操作前需要做什么？（Travel Rule）
DeCard 托管模式遵循 Travel Rule（旅行规则）合规要求：在为用户获取链上充值地址之前，用户必须先上传 Travel Rule 信息（身份、资金来源、财富来源等）。- 上传：
POST /account/v1/update-travel-rule - 查询：
GET /account/v2/query-travel-rule
这是 DeCard 托管模式的合规特色能力，详见 合规 · 旅行规则（Travel Rule）。
接入前置配置有哪些？
请按实际网络拓扑，分别提供沙盒与生产环境的出口 IP，避免上线时因白名单缺失被拒。
鉴权头与签名规则见 接入资源 · 鉴权指南；IP 白名单见 IP 白名单；Webhook 事件与 WebSocket 实时推送（DCS 托管特色）见 Webhook 与 WebSocket 实时通知。
上线前自检清单
- 已确认卡类型、卡组织、卡 BIN 与发行地区，DCS 已配置接入凭证与卡类别（
categoryId）（自证：能在沙盒成功请求
/card/v2/detail等需鉴权的接口，返回非 401/403） - 已与 DCS 确认 KYC 接入方式（Sumsub Share Token 或 DCS 托管 H5）；如使用 Sumsub，已完成合约与令牌设置
（自证：在沙盒能以选定方式完成一次完整 KYC 流程，最终状态达
PASS） - 已确认个人 KYC 资料清单（POI / POA / 自拍），并核对各发行地区的证件白名单
（自证：按 KYC 证件说明 逐项比对，各发行地区所需证件均已准备就绪）
- 已向 DCS 提交 Webhook 回调地址与网络出口 IP（沙盒 + 生产）
（自证：联系 DCS 团队确认白名单已生效，或从沙盒后台触发测试推送验证回调端可达）
- 已接入实时通知（Webhook 事件订阅；如需面向终端用户实时推送，已联调 WebSocket）
（自证：可在 DCS 沙盒后台触发一条测试 Webhook，确认您的回调端能收到并验签通过）
- 已在沙盒完成「用户注册 → KYC → 开卡 → 充值 → 消费」完整流程
（自证：至少成功创建一张沙盒卡、完成一笔模拟充值并在 用户余额 查询到可用余额、完成一笔模拟消费/授权）
- 已与 DCS 确认生产接入凭证领取方式并切换至生产环境地址
（自证：已确认生产 Base URL（
https://api.thedecard.com）与生产凭证已就绪）
本组导航
- 上线后常见问题 — 上线后运营期的常见问题处理：卡片消费/退款、加入移动钱包、交易争议与上报路径等。