旅行规则（Travel Rule） - DCS Technical Documentation

📄 正文

旅行规则（Travel Rule） 是全球反洗钱（AML）监管框架下的要求，旨在规范跨境/虚拟资产转移过程中的信息交互，确保金融交易透明可追溯。在 DeCard 托管模式下，终端用户在获取链上充值地址之前，必须先上传旅行规则信息——未完成上传的用户无法获取链上充值地址，因而无法进行跨境充值。

前置条件：调用相关接口前，用户必须已通过注册接口创建，且您持有其 externalUserId。旅行规则上传应在用户获取链上充值地址之前完成。

DeCard 托管模式提供的能力

DCS 通过标准化接口为您提供旅行规则信息的管理能力，您按对接深度选择服务端对接或让用户在 DCS 托管页自助上传：

能力	接口	方法	说明
上传旅行规则	`/account/v1/update-travel-rule`	POST	提交用户身份、地址、出生信息（仅 `externalUserId` 必填）
查询旅行规则	`/account/v2/query-travel-rule`	GET	按 `externalUserId` 查已提交信息
引导页自助上传	`/redirect/v2/guidance-link`	POST	`action=TRAVEL_RULE`，用户在 DCS 托管页直接填写上传，无需您采集敏感资料
生成 EDD 文件预上传地址	`/account/v1/generate-file-upload-prepare`	POST	高风险场景：获取预签名 URL + `objectKey`
提交 EDD 文件	`/account/v1/upload-edd-file`	POST	提交资金来源（SoF）/财富来源（SoW）证明文件引用

DCS 的核心工作集中在四点：数据标准化（统一的证件类型、地址、出生日期等数据结构）、接口支持（上传/查询）、文件管理（EDD 增强尽职调查，覆盖资金来源与财富来源两大维度）、流程联动（与链上充值地址获取关联——未完成上传即取地址会被拒绝）。

EDD（增强尽职调查）：对高风险场景（大额跨境、可疑交易等），DCS 支持用户提交资金来源（SoF，6 类）与财富来源（SoW，6 类）共 12 类辅助证明文件，流程分两步：「生成预上传地址并上传文件 → 提交文件引用」。完整分类与字段见下方操作指南。

EDD 文件上传（增强尽职调查）

对于高风险合规场景（大额跨境、可疑交易等），DCS 提供 EDD（Enhanced Due Diligence）文件上传能力，支持用户提交资金来源（Source of Funds, SoF）与财富来源（Source of Wealth, SoW）两类辅助证明文件。整个流程分两步：

生成预上传地址：调 POST /account/v1/generate-file-upload-prepare，传入待上传的文件名列表，获取预签名 URL 和 objectKey。
提交 EDD 文件：将文件通过获取的 URL 上传后，调 POST /account/v1/upload-edd-file，提交各维度的 EDD 文件引用（含 fileName + filePath/objectKey）。

请求字段（EDD 提交请求体）

字段	类型	必填	说明
`externalUserId`	string	是	外部用户 ID
`requestRef`	string	是	唯一幂等 ID，用于防重复提交
`applyId`	string	否	虚拟卡申请 ID，关联特定卡申请单
`eddSowSalary`	object	否	财富来源（SoW）——薪资收入
`eddSowBizRevenue`	object	否	财富来源——经营收入
`eddSowGift`	object	否	财富来源——赠与
`eddSowInheritance`	object	否	财富来源——遗产继承
`eddSowInvest`	object	否	财富来源——投资收益
`eddSowOther`	object	否	财富来源——其他
`eddSofSaving`	object	否	资金来源（SoF）——薪资储蓄
`eddSofSale`	object	否	资金来源——资产出售
`eddSofBizRevenue`	object	否	资金来源——经营收入
`eddSofCrypto`	object	否	资金来源——加密货币
`eddSofInvest`	object	否	资金来源——投资变现
`eddSofOther`	object	否	资金来源——其他

EDD 子对象分类（共 12 类：SoW 6 类 + SoF 6 类，覆盖财富来源与资金来源两大维度）

子对象	维度	说明
`eddSowSalary`	财富来源	薪资收入（雇主名、职位、年收入 + 证明文件）
`eddSowBizRevenue`	财富来源	经营收入（企业名、业务性质、年营收 + 证明文件）
`eddSowGift`	财富来源	赠与（赠与人、关系、财富来源、资产估值 + 证明文件）
`eddSowInheritance`	财富来源	遗产继承（逝者名、关系、继承年份、估值 + 证明文件）
`eddSowInvest`	财富来源	投资收益（投资类型、估值 + 证明文件）
`eddSowOther`	财富来源	其他财富来源（描述 + 证明文件）
`eddSofSaving`	资金来源	薪资储蓄（雇主名、职位、年收入 + 证明文件）
`eddSofSale`	资金来源	资产出售（证明文件）
`eddSofBizRevenue`	资金来源	经营收入（企业名、业务性质、年营收 + 证明文件）
`eddSofCrypto`	资金来源	加密货币（平台名、持有类型 + 证明文件）
`eddSofInvest`	资金来源	投资变现（投资类型、估值 + 证明文件）
`eddSofOther`	资金来源	其他资金来源（描述 + 证明文件）

每个子对象均包含 docUrls 数组（{ fileName, filePath }），指向已通过预上传地址上传的文件。完整字段规格（如 eddSowGift 的 recurringGifts 子结构、各子对象的必填规则等）见接口 API Reference 页。

请求示例（EDD 文件提交，仅展示部分子对象；脱敏占位数据）

POST /account/v1/upload-edd-file HTTP/1.1
Host: {{dicard-server}}
Content-Type: application/json

{
  "externalUserId": "<externalUserId>",
  "requestRef": "<idempotency-key>",
  "applyId": "<applyId>",
  "eddSowSalary": {
    "employerName": "<employer>",
    "jobTitle": "<title>",
    "annualIncome": "100000",
    "docUrls": [
      { "fileName": "payslip.pdf", "filePath": "<objectKey-from-prepare>" }
    ]
  },
  "eddSofSaving": {
    "employerName": "<employer>",
    "jobTitle": "<title>",
    "annualIncome": "100000",
    "docUrls": [
      { "fileName": "bank_statement.pdf", "filePath": "<objectKey-from-prepare>" }
    ]
  }
}

响应（结构统一为 { code, message, messageDetail, data }；提交成功时 data 为 null）

{
  "code": "<成功码，如 SYS_SUCCESS>",
  "message": "",
  "messageDetail": {},
  "data": null
}

流程图

未先完成 Travel Rule 上传就尝试获取链上充值地址将被拒绝。/account/v2/query-travel-rule 的查询响应 address 字段集与上传请求体不对称（查询仅返回 city/postalCode/addressLines），编程时请以接口字段规格为准。

下一步

充值前置流程中如何提交 Travel Rule（update-travel-rule 请求示例）：加密货币充值
引导页 action=TRAVEL_RULE 完整参数：H5 KYC 与开卡引导页（EDD 12 类 SoF/SoW 子对象明细见上文「EDD 文件上传」节）
合规整体流程与 KYC 在其中的位置：合规 · 概述
完成旅行规则信息后获取链上充值地址：加密货币充值
接口字段全规格：POST /account/v1/update-travel-rule、GET /account/v2/query-travel-rule、POST /redirect/v2/guidance-link、POST /account/v1/generate-file-upload-prepare、POST /account/v1/upload-edd-file

​📄 正文

​DeCard 托管模式提供的能力

​EDD 文件上传（增强尽职调查）

​流程图

​下一步

📄 正文

DeCard 托管模式提供的能力

EDD 文件上传（增强尽职调查）

流程图

下一步