跳转到主要内容
Didit 官方的 C# 和 .NET 库。它面向 .NET 8 和 .NET Standard 2.0,每个 API 方法都是 async。在 .NET Framework 上,请使用 C# 11 或更高版本。各 SDK 的共同内容请参阅服务端 SDK 概览。

安装

如需 ASP.NET Core 依赖注入,还需添加 Didit.Extensions.DependencyInjection,并通过 services.AddDidit() 注册客户端。 这些包在 NuGet 上的名称是 Didit 和 Didit.Extensions.DependencyInjection。源代码和更新日志位于 GitHub 上的 didit-protocol/sdk-dotnet。

配置客户端

new DiditClient() 会从环境变量中读取 DIDIT_API_KEY。如需覆盖该值,或设置应用级调用(案件、网络、监管报告)所需的组织和应用 ID,请传入 DiditClientOptions。请创建一个客户端并重复使用。
必填的请求属性标有 required,缺少时将无法编译。您未设置的可选属性不会被发送。

创建会话

为某个工作流创建验证会话,并将用户引导至该会话的 URL。

读取决策

用户完成验证后(或 Webhook 到达时),请读取决策。每项功能的结果都是一个列表,每个工作流节点对应一条记录。

验证 Webhook

传入未经修改的原始请求体,以及一个用于读取请求头的方法。DiditWebhooks.Verify 会对任何无效或过期的投递抛出 WebhookVerificationException,否则返回类型化的事件。
在 ASP.NET Core 最小 API 中,使用 StreamReader 读取请求体,并传入 name => request.Headers[name].FirstOrDefault()。轮换密钥期间,请同时传入两个密钥:new[] { newSecret, oldSecret }。事件和签名方案详见 Webhooks。

交易筛查

将付款、提款或加密货币转账提交至交易监控;响应中包含其状态和风险评分。

验证 Authentication 令牌

Authentication 在您的后端检查您的 Authentication 签发方所签名的访问令牌,无需为每个请求调用 Didit。它还可以交换授权码、刷新令牌、检查和撤销会话,以及执行升级验证。
令牌验证会针对您应用的签发方和签名密钥执行在服务器上验证令牌中的各项检查。

错误

列表与文件

API 参考中的服务端 endpoint 页面都提供了对应操作的 .NET 示例,但以下 endpoint 和字段除外:它们尚未包含在任何 1.0.1 版本中,具体列于概览中。
最后修改于 2026年11月7日