跳转到主要内容
适用于 Java 和 Kotlin 的官方 Didit 库。它需要 Java 11 或更高版本,仅依赖 java.net.http、Jackson 和 JSpecify 可空性注解。每个方法都有一个 ...Async 变体,返回 CompletableFuture。各 SDK 的共同内容,请参阅服务端 SDK 概览。

安装

该构件为 Maven Central 上的 me.didit:didit-java。其源代码和变更日志位于 GitHub 上的 didit-protocol/sdk-java。

配置客户端

new Didit() 会从环境变量中读取 DIDIT_API_KEY。如需覆盖该值,或设置应用范围调用(案件、网络、监管报告)所需的组织和应用 ID,请使用构建器。
请求类型是构建器,其 build() 会检查必填字段。可选的响应字段为 Optional 值;在 Kotlin 中,请使用 .getOrNull() 读取。本页以及每个 API 参考页面中的代码片段都是某个方法的方法体,所需的导入语句位于其上方。

创建会话

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

读取决策

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

验证 Webhook

传入原始请求体(保持接收时的原样)以及请求头。对于任何无效或已过期的投递,Webhooks.verify 都会抛出 WebhookVerificationException;否则返回类型化的事件。
在 Spring Boot 中,请以 @RequestBody byte[] body 接收请求体,以 @RequestHeader Map<String, String> headers 接收请求头。若在轮换一个密钥的同时需要接受两个密钥,请传入 VerifyOptions。事件和签名方案详见 Webhooks。

筛查交易

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

验证 Authentication token

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

错误

每个异常都继承自非受检异常 DiditException。

列表与文件

API 参考中的服务端 endpoint 页面都为其操作提供了 Java 示例,但 1.0.1 版本尚未提供的 endpoint 和字段除外,它们列在概览中。
最后修改于 2026年11月7日