Primeros pasos
Integración / SDKs
Verificación de usuarios
Verificación de empresas
Monitorización de transacciones
Registro de cambioscurl
curl -X POST 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/cases/c1a5e000-0000-4000-8000-000000000001/resolve/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"resolution": "FALSE_POSITIVE", "note": "Confirmed legitimate activity after reviewing documents."}'from didit import Didit
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
client = Didit()
result = client.cases.resolve(
"c1a5e000-0000-4000-8000-000000000001",
resolution="FALSE_POSITIVE",
note="Confirmed legitimate activity after reviewing documents.",
)
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.resolve("c1a5e000-0000-4000-8000-000000000001", {
resolution: "FALSE_POSITIVE",
note: "Confirmed legitimate activity after reviewing documents.",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
client := didit.NewClient()
result, err := client.Cases.Resolve(ctx, "c1a5e000-0000-4000-8000-000000000001", didit.CasesResolveParams{
Resolution: "FALSE_POSITIVE",
Note: didit.String("Confirmed legitimate activity after reviewing documents."),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.CasesResolveParams;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
Didit client = new Didit();
var result = client.cases().resolve("c1a5e000-0000-4000-8000-000000000001", CasesResolveParams.builder()
.resolution(CasesResolveParams.Resolution.of("FALSE_POSITIVE"))
.note("Confirmed legitimate activity after reviewing documents.")
.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->resolve('c1a5e000-0000-4000-8000-000000000001', [
'resolution' => 'FALSE_POSITIVE',
'note' => 'Confirmed legitimate activity after reviewing documents.',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
didit = Didit::Client.new
result = didit.cases.resolve(
"c1a5e000-0000-4000-8000-000000000001",
resolution: "FALSE_POSITIVE",
note: "Confirmed legitimate activity after reviewing documents."
)
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.ResolveAsync("c1a5e000-0000-4000-8000-000000000001", new CasesResolveParams
{
Resolution = "FALSE_POSITIVE",
Note = "Confirmed legitimate activity after reviewing documents.",
});
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
API para resolver casos: falso positivo o amenaza válida
Resuelve casos en Didit como falso positivo o amenaza válida, con control por checklist, nota obligatoria y aprobación de 4 ojos.
POST
/
v3
/
organization
/
{organization_id}
/
application
/
{application_id}
/
cases
/
{case_uuid}
/
resolve
/
curl
curl -X POST 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/cases/c1a5e000-0000-4000-8000-000000000001/resolve/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"resolution": "FALSE_POSITIVE", "note": "Confirmed legitimate activity after reviewing documents."}'from didit import Didit
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
client = Didit()
result = client.cases.resolve(
"c1a5e000-0000-4000-8000-000000000001",
resolution="FALSE_POSITIVE",
note="Confirmed legitimate activity after reviewing documents.",
)
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.resolve("c1a5e000-0000-4000-8000-000000000001", {
resolution: "FALSE_POSITIVE",
note: "Confirmed legitimate activity after reviewing documents.",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
client := didit.NewClient()
result, err := client.Cases.Resolve(ctx, "c1a5e000-0000-4000-8000-000000000001", didit.CasesResolveParams{
Resolution: "FALSE_POSITIVE",
Note: didit.String("Confirmed legitimate activity after reviewing documents."),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.CasesResolveParams;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
Didit client = new Didit();
var result = client.cases().resolve("c1a5e000-0000-4000-8000-000000000001", CasesResolveParams.builder()
.resolution(CasesResolveParams.Resolution.of("FALSE_POSITIVE"))
.note("Confirmed legitimate activity after reviewing documents.")
.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->resolve('c1a5e000-0000-4000-8000-000000000001', [
'resolution' => 'FALSE_POSITIVE',
'note' => 'Confirmed legitimate activity after reviewing documents.',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
didit = Didit::Client.new
result = didit.cases.resolve(
"c1a5e000-0000-4000-8000-000000000001",
resolution: "FALSE_POSITIVE",
note: "Confirmed legitimate activity after reviewing documents."
)
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.ResolveAsync("c1a5e000-0000-4000-8000-000000000001", new CasesResolveParams
{
Resolution = "FALSE_POSITIVE",
Note = "Confirmed legitimate activity after reviewing documents.",
});
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"
}
Resuelve un caso. Si su blueprint está emparejado con un blueprint verificador para la revisión de cuatro ojos, esta llamada deja la resolución pendiente en lugar de cerrar el caso: consulta el campo
pending_resolution de la respuesta para distinguir los dos resultados.
Indica el verificador
En un blueprint con un paso verificador de cuatro ojos, envíachecker con el uuid de usuario del miembro que debe aprobar la resolución.
Solo ese miembro puede entonces aprobarla o rechazarla; cualquier otra persona, incluida una clave de API, recibe 403.
El campo checker del caso lo identifica hasta que la resolución se aprueba, se rechaza o se devuelve para una nueva revisión porque la evidencia cambió.
Sin checker, la resolución espera en la cola del blueprint verificador.
El miembro debe tener acceso a los casos de esta aplicación y no puede ser el responsable que envía la resolución.
En un blueprint sin paso verificador, checker devuelve 400.
Las resoluciones de cuatro ojos requieren un miembro de la consola
Envía una resolución que pasa a revisión de cuatro ojos como miembro de la consola, no con una clave de API. Una resolución enviada con una clave de API no tiene un autor registrado, por lo que la aprobación y el rechazo de la aprobación devuelven403 para cualquier solicitante, incluido el verificador indicado.
Acceso
Los endpoints de casos requieren una clave de API con acceso completo. Una clave con acceso restringido recibe una respuesta403.
Relacionado
- Revisión de cuatro ojos (consola)
- Obtener un caso
- Checklist (consola)
- Actualizar el estado en bloque
Autorizaciones
La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.
Parámetros de ruta
UUID de la organización.
UUID de la aplicación.
UUID del caso.
Ejemplo:
"c1a5e000-0000-4000-8000-000000000001"
Cuerpo
application/json
Opciones disponibles:
FALSE_POSITIVE, VALID_THREAT, INCONCLUSIVE, REQUIREMENTS_NOT_MET, REQUIREMENTS_SATISFIED Obligatorio cuando el blueprint establece require_resolution_note.
Solo para esquemas con principio de cuatro ojos. El uuid de usuario del miembro que debe aprobar esta resolución (el mismo id que assigned_to.uuid en un caso, o members[].user_id en un equipo de revisión). El miembro debe tener acceso a los casos de esta aplicación y no puede ser el responsable que envía la resolución. Omítelo o envía null para dejar la resolución a la cola de verificadores.
Respuesta
Resuelto, o en espera de aprobación de cuatro ojos.
Opciones disponibles:
OPEN, AWAITING_USER, RESOLVED Opciones disponibles:
FALSE_POSITIVE, VALID_THREAT, INCONCLUSIVE, REQUIREMENTS_NOT_MET, REQUIREMENTS_SATISFIED Opciones disponibles:
LOW, MEDIUM, HIGH Opciones disponibles:
MANUAL, AML_SCREENING, TRANSACTION_RULE, WORKFLOW_BUILDER El único usuario o empresa al que está vinculado el caso.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
El equipo de revisión responsable del caso, o null si ningún equipo es responsable. El enrutamiento lo establece cuando una regla de enrutamiento asigna el caso a uno de sus equipos. Cámbialo o bórralo con PATCH .../cases/{case_uuid}/ (team).
Show child attributes
Show child attributes
Se establece solo mientras una resolución de doble validación (4-eyes) está preparada en el blueprint del verificador, a la espera de su aprobación o del rechazo de la aprobación.
Show child attributes
Show child attributes
El miembro designado para aprobar o rechazar la resolución pendiente. Solo tiene valor mientras una resolución con principio de cuatro ojos espera a un verificador designado. Null cuando no hay nada pendiente, mientras la resolución pendiente espera en la cola de verificadores, y una vez que la resolución se aprueba, se rechaza o se devuelve para una nueva revisión porque las pruebas cambiaron.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Las 50 notas más recientes.
Show child attributes
Show child attributes
Los 100 eventos más recientes.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Última modificación el 1 de noviembre de 2026