SDK de Java i Kotlin per a KYC, AML i transaccions

La biblioteca oficial de Didit per a Java i Kotlin. Requereix Java 11 o posterior i només depèn de java.net.http, Jackson i de les anotacions de nul·labilitat de JSpecify. Cada mètode té una variant ...Async que retorna un CompletableFuture. Consulta la visió general dels SDK de servidor per veure què comparteix cada SDK.

Instal·lació

implementation("me.didit:didit-java:1.0.1")

<dependency>
  <groupId>me.didit</groupId>
  <artifactId>didit-java</artifactId>
  <version>1.0.1</version>
</dependency>

L’artefacte és me.didit:didit-java a Maven Central. El codi font i el registre de canvis es troben a didit-protocol/sdk-java a GitHub.

Configurar el client

new Didit() llegeix DIDIT_API_KEY de l’entorn. Utilitza el builder per sobreescriure’l, o per definir els identificadors de l’organització i de l’aplicació que necessiten les crides amb abast d’aplicació (casos, xarxes, informes regulatoris).

import java.time.Duration;
import me.didit.Didit;
import me.didit.core.RequestOptions;
import me.didit.types.SessionsRetrieveDecisionParams;

Didit client = Didit.builder()
        .apiKey(System.getenv("DIDIT_API_KEY"))
        .organizationId(System.getenv("DIDIT_ORGANIZATION_ID"))
        .applicationId(System.getenv("DIDIT_APPLICATION_ID"))
        .timeout(Duration.ofSeconds(30))
        .maxRetries(2)
        .build();

// Options for a single call.
var decision = client.sessions().retrieveDecision("11111111-2222-3333-4444-555555555555",
        SessionsRetrieveDecisionParams.builder().build(),
        RequestOptions.builder().timeout(Duration.ofSeconds(5)).build());
System.out.println(decision.status().orElse(null));

Els tipus de sol·licitud són builders, i el seu build() comprova els camps obligatoris. Els camps opcionals de les respostes són valors Optional; a Kotlin, llegeix-los amb .getOrNull(). Els fragments d’aquesta pàgina i de cada pàgina de referència de l’API són el cos d’un mètode, amb els imports necessaris a sobre.

Crear una sessió

Crea una sessió de verificació per a un flux de treball i envia el teu usuari a la seva URL.

import me.didit.Didit;
import me.didit.types.SessionsCreateParams;

Didit client = new Didit();

var session = client.sessions().create(SessionsCreateParams.builder()
        .workflowId("11111111-2222-3333-4444-555555555555")
        .vendorData("user-123")
        .callback("https://example.com/verification/done")
        .build());
System.out.println(session.url());

Llegir la decisió

Quan l’usuari acabi (o quan arribi el webhook), llegeix la decisió. Cada resultat de funcionalitat és una llista amb una entrada per cada node del flux de treball.

import java.util.List;
import me.didit.Didit;

Didit client = new Didit();

var decision = client.sessions().retrieveDecision("11111111-2222-3333-4444-555555555555");
decision.status().ifPresent(status -> System.out.println(status));
for (var verification : decision.idVerifications().orElse(List.of())) {
    System.out.println(verification.status().orElse(null));
}

Verificar un webhook

Passa el cos brut, exactament tal com s’ha rebut, i les capçaleres de la sol·licitud. Webhooks.verify llança WebhookVerificationException per a qualsevol entrega que no sigui vàlida i recent, i en cas contrari retorna un esdeveniment tipat.

import java.util.Map;
import me.didit.errors.WebhookVerificationException;
import me.didit.webhooks.SessionStatusUpdatedEvent;
import me.didit.webhooks.WebhookEvent;
import me.didit.webhooks.Webhooks;

public class DiditWebhookHandler {
    private final String secret = System.getenv("DIDIT_WEBHOOK_SECRET");

    public int handle(byte[] rawBody, Map<String, String> headers) {
        WebhookEvent event;
        try {
            event = Webhooks.verify(rawBody, headers, secret);
        } catch (WebhookVerificationException e) {
            System.out.println("rejected: " + e.reason());
            return 400;
        }
        if (event instanceof SessionStatusUpdatedEvent) {
            SessionStatusUpdatedEvent updated = (SessionStatusUpdatedEvent) event;
            System.out.println(updated.sessionId().orElse("") + " " + updated.status().orElse(""));
        }
        return 200;
    }
}

A Spring Boot, rep el cos com a @RequestBody byte[] body i les capçaleres com a @RequestHeader Map<String, String> headers. Per acceptar dos secrets compartits mentre en rotes un, passa VerifyOptions. Consulta Webhooks per als esdeveniments i l’esquema de signatura.

Cribrar una transacció

Envia un pagament, una retirada o una transferència de criptoactius al monitoratge de transaccions; la resposta inclou el seu estat i la puntuació de risc.

import me.didit.Didit;
import me.didit.types.TransactionsCreateParams;

Didit client = new Didit();

var transaction = client.transactions().create(TransactionsCreateParams.builder()
        .transactionId("txn-1001")
        .transactionCategory(TransactionsCreateParams.TransactionCategory.of("finance"))
        .transactionDetails(TransactionsCreateParams.TransactionDetails.builder()
                .direction(TransactionsCreateParams.TransactionDetails.Direction.of("outbound"))
                .amount(1500.0)
                .currency("EUR")
                .build())
        .subject(TransactionsCreateParams.Subject.builder()
                .entityType("individual")
                .vendorData("user-123")
                .fullName("Maria Garcia")
                .build())
        .build());
System.out.println(transaction.status().orElse(null) + " " + transaction.score().orElse(null));

Verificar els tokens d’Authentication

Authentication comprova els tokens d’accés que signa l’emissor d’Authentication, al teu backend, sense cridar Didit per a cada sol·licitud. També intercanvia codis, renova tokens, comprova i revoca sessions, i executa autenticacions reforçades.

La verificació del token fa les comprovacions descrites a Verificar un token al teu servidor, contra l’emissor i les claus de signatura de la teva aplicació.

import me.didit.authentication.AccessTokenClaims;
import me.didit.authentication.Authentication;
import me.didit.errors.TokenVerificationException;

public class CurrentUser {
    // The publishable key (pk_live_... or pk_test_...) carries your issuer URL.
    private final Authentication auth = Authentication.builder()
            .publishableKey("pk_live_...")
            .clientId("your-application-id")
            .build();

    public String subject(String accessToken) {
        try {
            AccessTokenClaims claims = auth.verifyAccessToken(accessToken);
            return claims.subject();
        } catch (TokenVerificationException e) {
            System.out.println("rejected: " + e.reason());
            return null;
        }
    }
}

Errors

Totes les excepcions hereten de DiditException, una excepció no comprovada.

import me.didit.Didit;
import me.didit.errors.ApiStatusException;
import me.didit.errors.NotFoundException;

Didit client = new Didit();

try {
    client.sessions().retrieveDecision("11111111-2222-3333-4444-555555555555");
} catch (NotFoundException e) {
    System.out.println("no such session");
} catch (ApiStatusException e) {
    System.out.println(e.statusCode() + " " + e.requestId().orElse(""));
}

Llistes i fitxers

import java.nio.file.Path;
import me.didit.Didit;
import me.didit.types.IdVerificationVerifyParams;
import me.didit.types.SessionsListParams;

Didit client = new Didit();

// Lists page through every result.
for (var session : client.sessions().list(SessionsListParams.builder().status("Approved").build())) {
    System.out.println(session);
}

// Uploads take a Path or a FileUpload (bytes or a stream).
var result = client.idVerification().verify(IdVerificationVerifyParams.builder()
        .frontImage(Path.of("id-front.jpg"))
        .backImage(Path.of("id-back.jpg"))
        .build());
System.out.println(result);

Les pàgines d’endpoints del servidor de la referència de l’API tenen un exemple en Java per a la seva operació, excepte els endpoints i camps que cap versió 1.0.1 encara no té, indicats a la visió general.

Guies

Autenticació

Model Context Protocol (MCP)

SDK web

SDK natius

SDK de servidor

Integracions

SDK de Java i Kotlin per a KYC, AML i transaccions

Instal·lació

Configurar el client

Crear una sessió

Llegir la decisió

Verificar un webhook

Cribrar una transacció

Verificar els tokens d’Authentication

Errors

Llistes i fitxers

​Instal·lació

​Configurar el client

​Crear una sessió

​Llegir la decisió

​Verificar un webhook

​Cribrar una transacció

​Verificar els tokens d’Authentication

​Errors

​Llistes i fitxers

Instal·lació

Configurar el client

Crear una sessió

Llegir la decisió

Verificar un webhook

Cribrar una transacció

Verificar els tokens d’Authentication

Errors

Llistes i fitxers