加密货币交易所和入口的KYT集成指南 (ZH)
一份实用指南，介绍如何将钱包筛选功能接入加密货币交易所或入口——在正确时机筛选存款和提款，编码策略，并处理警报——使用BYOK，每次筛选仅需0.02美元。.
加密货币交易所或入口只有两个时刻会涉及链上风险：存款进入和提款流出。在这两个关键点正确地进行筛选，您就覆盖了“了解您的交易”（KYT）的核心。如果处理不当——筛选过晚、筛选错误或将每一次匹配都视为手动工单——您要么接受了被污染的资金，要么让您的分析师不堪重负。
这是一份关于如何将Didit的钱包筛选功能接入存款/提款流程的构建指南。它涵盖了在何处进行筛选、如何编码策略以实现大多数决策自动化，以及如何处理那些无法自动化的决策——所有这些都通过统一的/v3/ API实现，并且使用自带密钥（BYOK）时，每次筛选仅需0.02美元。
关键要点
- 两个筛选点：存款时筛选入账地址，提款时筛选目标地址。
- 在结算前进行门控。预转账筛选允许您在价值转移之前拒绝存款或阻止提款。
- 将策略编码为规则，以便低/中风险自动通过，高风险路由至审核，严重风险直接拒绝——分析师只需处理边缘情况。
- 转账后记录通过交易哈希保留审计追踪，并捕获追溯性的制裁指定。
- 内置案件管理 + SAR工作流——警报在同一控制台打开，无需单独工具。
- 每次筛选0.02美元，自带密钥（BYOK，Crystal或Merkle Science）；按次付费，无最低消费。
KYT对交易所意味着什么
KYC在用户入驻时验证其身份。KYT则监控其资金后续的流向——具体来说，他们存入的加密货币来自何处，以及他们提取的加密货币将流向何处。对于交易所或入口而言，义务是明确的：不接受带有制裁、混币器、暗网、勒索软件或被盗资金风险的资金，也不向带有相同风险的钱包发送资金。钱包筛选是逐笔交易强制执行此规定的机制。
为什么这很重要
存款和提款是价值进出的唯一两个门户，因此也是风险进出的唯一两个门户。接受被污染的存款会给您的账簿带来洗钱风险；向受制裁的钱包发送提款，无论意图如何，都构成制裁违规。监管机构对虚拟资产服务提供商（VASPs）的期望是明确的持续交易监控，而实际期望是您在结算之前就发现这些问题，而不是在月末审核时。
团队历史上筛选不足的原因是成本：传统的区块链分析订阅将筛选定价为企业合同。现在，使用BYOK，每次筛选仅需0.02美元，这一限制不复存在——您可以筛选每一笔存款和每一笔提款，并且成本比直接购买数据便宜约10倍。
技术细节
一切都在POST /v3/transactions/上运行。设置currency_kind: "crypto"，一个方向，以及您正在筛选的地址。
存款（INBOUND）——在入账前筛选源地址：
curl -X POST https://verification.didit.me/v3/transactions/ \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"transaction_id": "dep_a31f",
"category": "finance",
"amount": 8000,
"currency": "USDT",
"currency_kind": "crypto",
"direction": "INBOUND",
"wallet_address": "0x12ab...90cd",
"include_crypto_screening": true,
"subject": { "vendor_data": "user_2201", "role": "RECEIVER" }
}'提款（OUTBOUND）——在释放前筛选目标地址：
curl -X POST https://verification.didit.me/v3/transactions/ \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"transaction_id": "wd_b58c",
"category": "finance",
"amount": 8000,
"currency": "USDT",
"currency_kind": "crypto",
"direction": "OUTBOUND",
"wallet_address": "0x44de...11ff",
"include_crypto_screening": true,
"subject": { "vendor_data": "user_2201", "role": "SENDER" }
}'根据判定的风险等级进行分支处理：
{
"transaction_id": "wd_b58c",
"status": "APPROVED",
"wallet_screening": {
"risk_score": 12,
"risk_band": "LOW",
"exposure": [ { "category": "EXCHANGE", "type": "DIRECT", "share": 0.96 } ]
}
}结算后，通过哈希（payment_reference_id）筛选已确认的交易，以保留可审计的转账后记录。
Webhooks。订阅transaction.status.updated，以便您的账本反映分析师的决策和任何AWAITING_USER的补救措施。
价格。使用BYOK（Crystal或Merkle Science），每次筛选0.02美元，按次调用，无最低消费。
参考流程
存款请求
└─ POST /v3/transactions/ (INBOUND, wallet_address, screening)
├─ LOW / MEDIUM → 贷记存款
├─ HIGH → 暂停；开启警报；分析师审核
└─ CRITICAL → 拒绝；冻结；开启警报；考虑SAR
提款请求
└─ POST /v3/transactions/ (OUTBOUND, destination wallet_address, screening)
├─ LOW / MEDIUM → 释放
├─ HIGH → 暂停；分析师审核
└─ CRITICAL → 阻止；开启警报
结算后
└─ POST /v3/transactions/ (hash as payment_reference_id) → 审计记录在加密货币筛选规则包中编码一次LOW/MEDIUM/HIGH/CRITICAL的处理逻辑，这样状态返回时就已经决定——您的后端只需根据它采取行动。
使用案例
- 中心化交易所——筛选每一笔存款和提款；自动拒绝CRITICAL，排队处理HIGH，记录其余。
- 入口/出口——在结算到银行系统之前，对交易对手钱包上的法币↔加密货币兑换进行门控。
- 添加加密货币的经纪商——重用现有的交易监控集成；加密货币筛选使用相同的端点。
- 托管机构——在接收时进行筛选，并在移动时重新筛选，以网络图作为冻结证据。
- 虚拟资产服务提供商（VASPs）——在同一引擎上将KYT与FATF旅行规则数据交换配对，实现端到端的交易对手风险管理。
如何与Didit集成
- 配置提供商 + 默认设置。在控制台 → 交易 → 设置中，设置Crystal或Merkle Science（BYOK或托管）以及默认筛选行为。
- 编写策略规则。开启加密货币筛选包，并设置风险等级 → 操作，以便大多数决策自动化。
- 在两个入口进行筛选。在结算前，对每一笔存款（INBOUND）和提款（OUTBOUND）调用
POST /v3/transactions/。 - 结算后记录。通过哈希重新筛选已确认的交易，以用于审计追踪。
- 处理边缘情况。HIGH/CRITICAL筛选会开启警报；在同一控制台中调查、升级为案件并提交SARs。
由于所有功能都基于统一的/v3/ API，同一个用户通过交易监控流程，被标记的交易可以通过AWAITING_USER暂停并触发补救步骤，KYC、KYT和AML共同构成了一个身份和欺诈平台。
常见问题
我到底应该在哪里进行筛选？
在两个点：在入账前筛选每一笔存款的源地址（INBOUND），以及在释放前筛选每一笔提款的目标地址（OUTBOUND）。为了记录，可以添加按哈希进行的转账后筛选。
筛选每一笔交易会不会很贵？
不会。使用BYOK，每次筛选0.02美元——比直接购买分析数据便宜约10倍——因此，即使交易量很大，筛选每一笔存款和提款也是经济实惠的。
我如何避免每次匹配都进行手动审核？
在加密货币筛选规则包中编码策略，以便LOW/MEDIUM自动通过，HIGH路由到分析师，CRITICAL直接拒绝。分析师只处理边缘情况。
这也涵盖了旅行规则吗？
是的。相同的交易监控引擎支持FATF旅行规则，因此交易对手数据交换和钱包筛选可以同时运行。
我可以使用哪些提供商？
目前是Crystal和Merkle Science（BYOK或托管）；Chainalysis和Elliptic即将推出，BYOK价格为0.02美元。
准备好开始了吗？
阅读文档中的钱包筛选概述，在钱包筛选产品页面了解它如何与平台结合，并在定价页面查看按次调用价格。准备好后，免费开始——每月免费500次KYC检查，以及使用BYOK时每次筛选0.02美元的钱包筛选服务。