Primers passos
Integració / SDK
Verificació d'usuaris
Verificació d'empreses
Monitoratge de transaccions
Registre de canviscurl
curl -X POST 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/cases/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"title": "Manual - Jane Doe", "blueprint": "b1de0000-0000-4000-8000-000000000002", "priority": "HIGH", "subject": {"type": "user", "uuid": "5b9a0000-0000-4000-8000-00000000f00d"}, "tags": ["review"]}'from didit import Didit
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
client = Didit()
result = client.cases.create(
title="Manual - Jane Doe",
blueprint="b1de0000-0000-4000-8000-000000000002",
priority="HIGH",
tags=["review"],
subject={
"type": "user",
"uuid": "5b9a0000-0000-4000-8000-00000000f00d",
},
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
const didit = new Didit();
const result = await didit.cases.create({
title: "Manual - Jane Doe",
blueprint: "b1de0000-0000-4000-8000-000000000002",
priority: "HIGH",
tags: ["review"],
subject: {
type: "user",
uuid: "5b9a0000-0000-4000-8000-00000000f00d",
},
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
client := didit.NewClient()
result, err := client.Cases.Create(ctx, didit.CasesCreateParams{
Title: "Manual - Jane Doe",
Blueprint: didit.String("b1de0000-0000-4000-8000-000000000002"),
Priority: didit.Some(didit.CasesCreateParamsPriority("HIGH")),
Tags: didit.Some([]string{"review"}),
Subject: didit.Some(didit.CasesCreateParamsSubject{
Type: didit.Some(didit.CasesCreateParamsSubjectType("user")),
UUID: didit.String("5b9a0000-0000-4000-8000-00000000f00d"),
}),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import java.util.List;
import me.didit.Didit;
import me.didit.types.CasesCreateParams;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
Didit client = new Didit();
var result = client.cases().create(CasesCreateParams.builder()
.title("Manual - Jane Doe")
.blueprint("b1de0000-0000-4000-8000-000000000002")
.priority(CasesCreateParams.Priority.of("HIGH"))
.tags(List.of("review"))
.subject(CasesCreateParams.Subject.builder()
.type(CasesCreateParams.Subject.Type.of("user"))
.uuid("5b9a0000-0000-4000-8000-00000000f00d")
.build())
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
$didit = new DiditClient();
$result = $didit->cases->create([
'title' => 'Manual - Jane Doe',
'blueprint' => 'b1de0000-0000-4000-8000-000000000002',
'priority' => 'HIGH',
'tags' => ['review'],
'subject' => [
'type' => 'user',
'uuid' => '5b9a0000-0000-4000-8000-00000000f00d',
],
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
didit = Didit::Client.new
result = didit.cases.create(
title: "Manual - Jane Doe",
blueprint: "b1de0000-0000-4000-8000-000000000002",
priority: "HIGH",
tags: ["review"],
subject: {
type: "user",
uuid: "5b9a0000-0000-4000-8000-00000000f00d",
}
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
using var client = new DiditClient();
var result = await client.Cases.CreateAsync(new CasesCreateParams
{
Title = "Manual - Jane Doe",
Blueprint = "b1de0000-0000-4000-8000-000000000002",
Priority = new CasesCreateParamsPriority("HIGH"),
Tags = new string[] { "review" },
Subject = new CasesCreateParamsSubject
{
Type = new CasesCreateParamsSubjectType("user"),
Uuid = "5b9a0000-0000-4000-8000-00000000f00d",
},
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"case_number": "<string>",
"title": "<string>",
"status": "OPEN",
"resolution": "FALSE_POSITIVE",
"resolution_notes": "<string>",
"priority": "LOW",
"source": "MANUAL",
"tags": [
"<string>"
],
"subject": {
"type": "user",
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"external_id": "<string>",
"country": "ESP",
"portrait": "<string>"
},
"assigned_to": {
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"full_name": "<string>",
"email": "jsmith@example.com"
},
"assigned_at": "2023-11-07T05:31:56Z",
"team": {
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>"
},
"due_at": "2023-11-07T05:31:56Z",
"resolved_at": "2023-11-07T05:31:56Z",
"resolved_by_email": "<string>",
"pending_resolution": {
"resolution": "FALSE_POSITIVE",
"resolution_notes": "<string>",
"maker_email": "jsmith@example.com",
"maker_name": "<string>",
"maker_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"maker_blueprint_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"staged_at": "2023-11-07T05:31:56Z"
},
"checker": {
"member_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"email": "jsmith@example.com"
},
"metadata": {},
"blueprint": {
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"assignment_method": "MANUAL",
"assignee_pool": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"max_active_cases": 123,
"escalation_enabled": true,
"transfer_enabled": true,
"require_resolution_note": true,
"is_active": true,
"preset_key": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"escalation_blueprint": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"escalation_blueprint_name": "<string>",
"four_eyes_checker_blueprint": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"four_eyes_checker_blueprint_name": "<string>",
"content_config": {
"checklist": {
"enabled": true,
"optional": true,
"items": [
{
"label": "<string>",
"order": 123
}
]
},
"aml_control": {
"enabled": true,
"financial": true,
"identity": true
},
"identity": {
"enabled": true,
"personal_information": true,
"applicant_tags": true,
"contact_information": true,
"risk_overview": true,
"poi_documents": true,
"poa_documents": true
},
"verifications": {
"enabled": true,
"summary": true
},
"reporting": {
"enabled": true,
"fiu_reports": true
},
"financial": {
"enabled": true,
"payment_methods": true,
"transactions": true
}
},
"creation_sources": [
{
"kind": "aml",
"id": "<string>",
"name": "<string>"
}
],
"receives_escalation_from": [
{
"id": "<string>",
"name": "<string>"
}
],
"updated_at": "2023-11-07T05:31:56Z",
"version": 123,
"default_deadline_hours": 4380
},
"notes": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"comment": "<string>",
"actor_email": "jsmith@example.com",
"actor_name": "<string>",
"mentioned_emails": [
"jsmith@example.com"
],
"is_internal": true,
"attachments": [
{
"s3_key": "<string>",
"filename": "<string>",
"file_size": 123,
"url": "<string>"
}
],
"tags": [
"<string>"
],
"created_at": "2023-11-07T05:31:56Z"
}
],
"events": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"event_type": "CREATED",
"actor_email": "jsmith@example.com",
"actor_name": "<string>",
"previous_status": "OPEN",
"new_status": "OPEN",
"metadata": {},
"created_at": "2023-11-07T05:31:56Z"
}
],
"links": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"linked_entity_type": "session",
"linked_entity_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"linked_entity_summary": {},
"created_at": "2023-11-07T05:31:56Z"
}
],
"links_count": 123,
"notes_count": 123,
"checklist_items": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"label": "<string>",
"is_completed": true,
"completed_by": "jsmith@example.com",
"completed_at": "2023-11-07T05:31:56Z",
"order": 123
}
],
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}{}Casos
Crear casos amb l'API
Crea un cas de compliment de Didit vinculat a un únic usuari o empresa, amb sessions o transaccions opcionals i assignat a un responsable.
POST
/
v3
/
organization
/
{organization_id}
/
application
/
{application_id}
/
cases
/
curl
curl -X POST 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/cases/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"title": "Manual - Jane Doe", "blueprint": "b1de0000-0000-4000-8000-000000000002", "priority": "HIGH", "subject": {"type": "user", "uuid": "5b9a0000-0000-4000-8000-00000000f00d"}, "tags": ["review"]}'from didit import Didit
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
client = Didit()
result = client.cases.create(
title="Manual - Jane Doe",
blueprint="b1de0000-0000-4000-8000-000000000002",
priority="HIGH",
tags=["review"],
subject={
"type": "user",
"uuid": "5b9a0000-0000-4000-8000-00000000f00d",
},
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
const didit = new Didit();
const result = await didit.cases.create({
title: "Manual - Jane Doe",
blueprint: "b1de0000-0000-4000-8000-000000000002",
priority: "HIGH",
tags: ["review"],
subject: {
type: "user",
uuid: "5b9a0000-0000-4000-8000-00000000f00d",
},
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
client := didit.NewClient()
result, err := client.Cases.Create(ctx, didit.CasesCreateParams{
Title: "Manual - Jane Doe",
Blueprint: didit.String("b1de0000-0000-4000-8000-000000000002"),
Priority: didit.Some(didit.CasesCreateParamsPriority("HIGH")),
Tags: didit.Some([]string{"review"}),
Subject: didit.Some(didit.CasesCreateParamsSubject{
Type: didit.Some(didit.CasesCreateParamsSubjectType("user")),
UUID: didit.String("5b9a0000-0000-4000-8000-00000000f00d"),
}),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import java.util.List;
import me.didit.Didit;
import me.didit.types.CasesCreateParams;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
Didit client = new Didit();
var result = client.cases().create(CasesCreateParams.builder()
.title("Manual - Jane Doe")
.blueprint("b1de0000-0000-4000-8000-000000000002")
.priority(CasesCreateParams.Priority.of("HIGH"))
.tags(List.of("review"))
.subject(CasesCreateParams.Subject.builder()
.type(CasesCreateParams.Subject.Type.of("user"))
.uuid("5b9a0000-0000-4000-8000-00000000f00d")
.build())
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
$didit = new DiditClient();
$result = $didit->cases->create([
'title' => 'Manual - Jane Doe',
'blueprint' => 'b1de0000-0000-4000-8000-000000000002',
'priority' => 'HIGH',
'tags' => ['review'],
'subject' => [
'type' => 'user',
'uuid' => '5b9a0000-0000-4000-8000-00000000f00d',
],
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
didit = Didit::Client.new
result = didit.cases.create(
title: "Manual - Jane Doe",
blueprint: "b1de0000-0000-4000-8000-000000000002",
priority: "HIGH",
tags: ["review"],
subject: {
type: "user",
uuid: "5b9a0000-0000-4000-8000-00000000f00d",
}
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
using var client = new DiditClient();
var result = await client.Cases.CreateAsync(new CasesCreateParams
{
Title = "Manual - Jane Doe",
Blueprint = "b1de0000-0000-4000-8000-000000000002",
Priority = new CasesCreateParamsPriority("HIGH"),
Tags = new string[] { "review" },
Subject = new CasesCreateParamsSubject
{
Type = new CasesCreateParamsSubjectType("user"),
Uuid = "5b9a0000-0000-4000-8000-00000000f00d",
},
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"case_number": "<string>",
"title": "<string>",
"status": "OPEN",
"resolution": "FALSE_POSITIVE",
"resolution_notes": "<string>",
"priority": "LOW",
"source": "MANUAL",
"tags": [
"<string>"
],
"subject": {
"type": "user",
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"external_id": "<string>",
"country": "ESP",
"portrait": "<string>"
},
"assigned_to": {
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"full_name": "<string>",
"email": "jsmith@example.com"
},
"assigned_at": "2023-11-07T05:31:56Z",
"team": {
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>"
},
"due_at": "2023-11-07T05:31:56Z",
"resolved_at": "2023-11-07T05:31:56Z",
"resolved_by_email": "<string>",
"pending_resolution": {
"resolution": "FALSE_POSITIVE",
"resolution_notes": "<string>",
"maker_email": "jsmith@example.com",
"maker_name": "<string>",
"maker_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"maker_blueprint_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"staged_at": "2023-11-07T05:31:56Z"
},
"checker": {
"member_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"email": "jsmith@example.com"
},
"metadata": {},
"blueprint": {
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"assignment_method": "MANUAL",
"assignee_pool": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"max_active_cases": 123,
"escalation_enabled": true,
"transfer_enabled": true,
"require_resolution_note": true,
"is_active": true,
"preset_key": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"escalation_blueprint": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"escalation_blueprint_name": "<string>",
"four_eyes_checker_blueprint": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"four_eyes_checker_blueprint_name": "<string>",
"content_config": {
"checklist": {
"enabled": true,
"optional": true,
"items": [
{
"label": "<string>",
"order": 123
}
]
},
"aml_control": {
"enabled": true,
"financial": true,
"identity": true
},
"identity": {
"enabled": true,
"personal_information": true,
"applicant_tags": true,
"contact_information": true,
"risk_overview": true,
"poi_documents": true,
"poa_documents": true
},
"verifications": {
"enabled": true,
"summary": true
},
"reporting": {
"enabled": true,
"fiu_reports": true
},
"financial": {
"enabled": true,
"payment_methods": true,
"transactions": true
}
},
"creation_sources": [
{
"kind": "aml",
"id": "<string>",
"name": "<string>"
}
],
"receives_escalation_from": [
{
"id": "<string>",
"name": "<string>"
}
],
"updated_at": "2023-11-07T05:31:56Z",
"version": 123,
"default_deadline_hours": 4380
},
"notes": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"comment": "<string>",
"actor_email": "jsmith@example.com",
"actor_name": "<string>",
"mentioned_emails": [
"jsmith@example.com"
],
"is_internal": true,
"attachments": [
{
"s3_key": "<string>",
"filename": "<string>",
"file_size": 123,
"url": "<string>"
}
],
"tags": [
"<string>"
],
"created_at": "2023-11-07T05:31:56Z"
}
],
"events": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"event_type": "CREATED",
"actor_email": "jsmith@example.com",
"actor_name": "<string>",
"previous_status": "OPEN",
"new_status": "OPEN",
"metadata": {},
"created_at": "2023-11-07T05:31:56Z"
}
],
"links": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"linked_entity_type": "session",
"linked_entity_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"linked_entity_summary": {},
"created_at": "2023-11-07T05:31:56Z"
}
],
"links_count": 123,
"notes_count": 123,
"checklist_items": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"label": "<string>",
"is_completed": true,
"completed_by": "jsmith@example.com",
"completed_at": "2023-11-07T05:31:56Z",
"order": 123
}
],
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}{}
Crea un cas associat a un únic subjecte. Proporciona
subject directament, o bé indica links i deixa que Didit derivi el subjecte a partir del propietari de la primera entitat enllaçada.
Passa
blueprint sempre que en tinguis un: determina quines seccions de la pàgina del cas es mostren, si la resolució requereix una nota i a on es dirigeix el cas en cas d’escalament o transferència.Relacionats
Autoritzacions
La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.
Paràmetres de ruta
UUID de l'organització.
UUID de l'aplicació.
Cos
application/json
Maximum string length:
255UUID de CaseBlueprint. Omet-ho si no hi ha cap blueprint.
Opcions disponibles:
LOW, MEDIUM, HIGH Obligatori tret que es proporcioni links; l'únic subjecte del cas.
Show child attributes
Show child attributes
Sessions/sessions d'empresa/transaccions per adjuntar en crear, p. ex. [{"entity_type": "transaction", "entity_uuid": "..."}]. Quan s'omet el subjecte, el subjecte es deriva del propietari del primer enllaç.
UUID de l'usuari que s'ha d'assignar immediatament.
Torna a comprovar les investigacions existents abans de crear el cas. Quan és cert, un subjecte amb casos existents requereix un separate_incident_reason no buit. La consola sempre activa aquesta protecció. Ometre-ho manté el comportament existent de l'API.
Maximum string length:
1000Show child attributes
Show child attributes
Resposta
Cas creat.
Opcions disponibles:
OPEN, AWAITING_USER, RESOLVED Opcions disponibles:
FALSE_POSITIVE, VALID_THREAT, INCONCLUSIVE, REQUIREMENTS_NOT_MET, REQUIREMENTS_SATISFIED Opcions disponibles:
LOW, MEDIUM, HIGH Opcions disponibles:
MANUAL, AML_SCREENING, TRANSACTION_RULE, WORKFLOW_BUILDER L'únic usuari o empresa al qual està vinculat el cas.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
L'equip de revisió propietari del cas, o null quan cap equip n'és el propietari. L'encaminament l'assigna quan una regla d'encaminament assigna el cas a un dels seus equips. Canvia'l o buida'l amb PATCH .../cases/{case_uuid}/ (team).
Show child attributes
Show child attributes
S'estableix només mentre una resolució de 4 ulls està preparada a l'esquema del verificador, esperant l'aprovació o el rebuig de l'aprovació.
Show child attributes
Show child attributes
El membre designat per aprovar o rebutjar la resolució pendent. Només s'estableix mentre una resolució de quatre ulls espera un revisor designat. Null quan no hi ha res pendent, mentre la resolució pendent espera a la cua de revisors i un cop la resolució ha estat aprovada, rebutjada o retornada per a una nova revisió perquè les proves han canviat.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Les 50 notes més recents.
Show child attributes
Show child attributes
Els 100 esdeveniments més recents.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Darrera modificació el 7 de novembre del 2026