转账前与转账后钱包筛选：时机、差异及如何操作 (ZH)

Didit 的钱包筛选 API 同时支持这两种方式。预转账筛选获取一个钱包地址，并在您接受存款或发放提款之前返回风险评估。后转账筛选获取一个交易哈希，并在事后评估已确认的交易。两者都返回相同的 0-100 风险评分，并带有低/中/高/关键等级以及资金来源细分，并且每次筛选费用均为 0.02 美元。

本指南解释了它们之间的区别以及如何将它们集成到实际流程中。

主要收获

• 预转账 = 地址，在价值转移之前。筛选钱包地址以在存款或提款发生之前进行把关。
• 后转账 = 交易哈希，在结算之后。筛选已确认的交易（通过 payment_reference_id）以进行记录和持续审查。
• 两者返回相同的评估结构 — 0-100 风险评分、低/中/高/关键等级以及按资金来源类别划分的风险敞口。
• 在大多数流程中同时使用两者：预转账用于决策，后转账用于记录和重新检查。
• 由 currency_kind: "crypto" 触发，加上方向（INBOUND / OUTBOUND）；通过 include_crypto_screening 每次调用覆盖。
• 使用 BYOK（Crystal 或 Merkle Science），每次筛选费用为 0.02 美元，无论您使用哪种时机。

各自筛选什么

预转账筛选评估一个钱包地址。您尚不知道是否会有任何价值转移 — 您在问：“如果我从（或向）此地址接受资金（或发送资金），我将面临什么风险？”API 会追溯该地址的流入和流出历史并返回其风险。这是决策点：通过、暂停审查或在任何事情结算之前拒绝。

后转账筛选通过其哈希评估特定交易。价值已经转移；您正在记录所发生事件的风险并保持其最新状态。因为链上标签会演变 — 一个地址在您与之交易后可能会被添加到制裁名单中 — 后转账筛选（和定期重新筛选）可以使您的记录在审计和持续监控义务方面保持准确。

为何重要

选择错误的筛选时机可能会造成真正的漏洞。如果只进行后转账筛选，您在知道资金有风险之前就已经接受了资金 — 您现在正在撤销已结算的交易，而不是拒绝待处理的交易。如果只进行预转账筛选，您的记录就会过时：您在存款时捕获的评估无法反映之后出现的情报，这会削弱任何审计线索并错过追溯性制裁指定。

监管机构和良好实践都指向相同的答案：通过预转账筛选在前端把关，然后通过后转账筛选维护准确、可重新检查的记录。同时运行这两种筛选之所以重要，是因为每次筛选 0.02 美元的价格 — 在这个成本下，两次筛选仍然比传统订阅上的单次筛选便宜一个数量级。

技术细节

两种模式都在交易监控内的统一 /v3/ API 上运行。区别在于您传递的是钱包地址还是交易引用。

预转账 — 在接受存款前筛选地址：

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_61a0",
    "category": "finance",
    "currency_kind": "crypto",
    "direction": "INBOUND",
    "wallet_address": "0x4d2a...91bc",
    "include_crypto_screening": true,
    "subject": { "vendor_data": "user_5012", "role": "RECEIVER" }
  }'

后转账 — 通过哈希筛选已结算的交易：

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_77f3",
    "category": "finance",
    "currency_kind": "crypto",
    "direction": "OUTBOUND",
    "payment_reference_id": "0xabc123...def",
    "include_crypto_screening": true,
    "subject": { "vendor_data": "user_5012", "role": "SENDER" }
  }'

两者都返回相同的评估结构：

{
  "wallet_screening": {
    "risk_score": 41,
    "risk_band": "MEDIUM",
    "exposure": [
      { "category": "HIGH_RISK_EXCHANGE", "type": "DIRECT", "share": 0.27 }
    ]
  }
}

触发器。当 currency_kind 为 "crypto" 且设置了 direction（INBOUND 或 OUTBOUND）时，筛选就会触发。默认情况下 — 加密交易是否自动筛选 — 在控制台 → 交易 → 设置中配置，并且 include_crypto_screening 会在每次调用时覆盖它。

关键字段。对于预转账，传递 wallet_address；对于后转账，将交易哈希作为 payment_reference_id 传递。

价格。使用 BYOK（Crystal 或 Merkle Science），两种模式每次筛选 0.02 美元。

何时使用

使用案例

• 加密货币交易所 — 对每笔存款和提款进行预转账筛选以控制流程；后转账筛选以保持完整、可重新检查的账本。
• 法币出入金通道 — 预转账筛选以阻止涉及高风险钱包的转换在结算前进行。
• 托管人 — 在接收时进行预转账筛选，随着标签演变对存储资产进行后转账重新筛选。
• 钱包 — 预转账筛选以在用户发送到被标记地址之前发出警告。
• VASP — 后转账记录与旅行规则数据配对，以形成可辩护的合规性追踪。

如何与 Didit 集成

1. 设置默认值在交易 → 设置中 — 选择加密交易是否自动筛选以及使用哪个提供商密钥。
2. 前端把关。在接受存款或发放提款之前，使用 wallet_address 调用 POST /v3/transactions/ 并根据等级采取行动。
3. 结算后记录。一旦交易确认，使用哈希作为 payment_reference_id 再次筛选。
4. 处理警报。高/关键筛选会在内置案例管理器中打开警报，以供调查和 SAR 备案。

常见问题

预转账和后转账筛选之间有什么实际区别？

预转账筛选在价值转移之前筛选钱包地址，以便您可以拒绝。后转账筛选通过其哈希筛选已结算的交易，以便您拥有准确、可重新检查的记录。

我需要同时进行这两种筛选吗？

大多数团队应该这样做。预转账控制流程；后转账保持记录最新 — 包括捕获在您交易后被添加到制裁名单的地址。

我如何筛选交易哈希？

在 POST /v3/transactions/ 中，将哈希作为 payment_reference_id 传递，并带有 currency_kind: "crypto" 和一个方向。

同时运行这两种筛选会花费两倍的钱吗？

是的 — 每次 0.02 美元 — 但以这个价格，两次筛选仍然远低于传统区块链分析订阅中的一次筛选。

我能否仅对某些交易开启筛选？

是的。在控制台 → 交易 → 设置中设置默认值，并通过 include_crypto_screening 每次调用进行覆盖。

准备好开始了吗？

阅读文档中的钱包筛选概述，查看它在钱包筛选产品页面上如何适应平台，并在定价页面上查看每次调用的价格。准备好后，免费开始 — 每月 500 次免费 KYC 检查，钱包筛选每次 0.02 美元。