Primeros pasos
Integración / SDKs
Verificación de usuarios
Verificación de empresas
Monitorización de transacciones
Registro de cambioscurl -X GET 'https://verification.didit.me/v3/events/11111111-2222-3333-4444-555555555555/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.monitoring_events.retrieve(
"11111111-2222-3333-4444-555555555555",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.monitoringEvents.retrieve("11111111-2222-3333-4444-555555555555");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.MonitoringEvents.Retrieve(ctx, "11111111-2222-3333-4444-555555555555")
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.monitoringEvents().retrieve("11111111-2222-3333-4444-555555555555");
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->monitoringEvents->retrieve('11111111-2222-3333-4444-555555555555');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.monitoring_events.retrieve("11111111-2222-3333-4444-555555555555")
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.MonitoringEvents.RetrieveAsync("11111111-2222-3333-4444-555555555555");
Console.WriteLine(JsonSerializer.Serialize(result));{
"event_uuid": "33333333-4444-5555-6666-777777777777",
"event_id": "login-2026-10-17-000001",
"event_category": "auth",
"action_type": "login",
"occurred_at": "2026-10-17T09:15:02.481000Z",
"received_at": "2026-10-17T09:15:02.903114Z",
"status": "IN_REVIEW",
"score": 40,
"subject_vendor_data": "user-42",
"subject_entity_type": "individual",
"subject_uuid": "66666666-7777-8888-9999-000000000000",
"counterparty_vendor_data": null,
"session_id": "web-session-abc",
"device_fingerprint": "fp-a8c1",
"ip_address": "203.0.113.42",
"ip_country": "ES",
"amount": null,
"currency": null,
"game_id": null,
"round_id": null,
"bonus_id": null,
"affiliate_code": null,
"payment_reference_id": null,
"retention_class": "risk_relevant",
"rules_matched_count": 1,
"correlation_pending": false,
"is_droppable": true,
"payload": {
"method": "password"
},
"custom_values": {
"vip_tier": "gold",
"vpn_or_proxy_detected": true
},
"device_context": {
"fingerprint": "fp-a8c1",
"network_context": {
"ip_address": "203.0.113.42",
"ip_country": "Spain",
"ip_country_code": "ES",
"ip_city": "Madrid",
"asn_number": 64500,
"asn_organization": "Example Networks",
"is_vpn_or_tor": true,
"is_data_center": false
}
},
"field_sources": {
"subject.vendor_data": "customer",
"event_category": "customer",
"action_type": "customer",
"occurred_at": "customer",
"received_at": "server",
"payload.method": "customer",
"session.session_id": "customer",
"session.sequence": "customer",
"device_context.fingerprint": "customer",
"device_context.network_context.ip_address": "customer",
"device_context.network_context.ip_country": "server",
"device_context.network_context.ip_country_code": "server",
"device_context.network_context.ip_city": "server",
"device_context.network_context.asn_number": "server",
"device_context.network_context.asn_organization": "server",
"device_context.network_context.is_vpn_or_tor": "server",
"device_context.network_context.is_data_center": "server"
},
"session_sequence": 142,
"table_id": null,
"hand_id": null,
"match_id": null,
"market_id": null,
"side": null,
"role": null,
"net_result_amount": null,
"payment_fingerprint": null,
"instrument_reference_hash": null,
"withdrawal_address_hash": null,
"dispute_id": null,
"chargeback_id": null,
"changed_field": null,
"identity_match_ref": null,
"schema_version": 1,
"expires_at": "2027-01-15T09:15:02.481000Z",
"rules_evaluated_count": 6,
"rule_runs": [
{
"rule_uuid": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"rule_title": "Login from VPN or Tor",
"library_key": null,
"matched": true,
"mode": "ACTIVE",
"is_async": false,
"severity": "MEDIUM",
"score_delta": 40,
"action_summary": "score +40; add_tag:VPN_LOGIN",
"matched_payload": [
{
"field": "event.ip.is_vpn_or_tor",
"operator": "eq",
"expected_value": true,
"current_value": true,
"matched": true,
"group_index": null,
"group_logic": "AND",
"field_source": "server"
}
],
"created_at": "2026-10-17T09:15:02.951207Z"
}
],
"ip_enrichment": {
"ip_country_code": "ES",
"ip_city": "Madrid",
"asn_number": 64500,
"asn_organization": "Example Networks",
"is_vpn_or_tor": true,
"is_data_center": false,
"proxy_type": null,
"last_enriched_at": "2026-10-17T09:15:02.910442Z"
},
"subject_profile": null,
"tags": [
"VPN_LOGIN"
]
}Obtener evento de monitorización con la API de Didit
Didit obtiene un evento de monitorización con su payload, contexto del dispositivo, datos de IP, señales del sujeto, etiquetas y evidencia de reglas.
curl -X GET 'https://verification.didit.me/v3/events/11111111-2222-3333-4444-555555555555/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.monitoring_events.retrieve(
"11111111-2222-3333-4444-555555555555",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.monitoringEvents.retrieve("11111111-2222-3333-4444-555555555555");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.MonitoringEvents.Retrieve(ctx, "11111111-2222-3333-4444-555555555555")
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.monitoringEvents().retrieve("11111111-2222-3333-4444-555555555555");
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->monitoringEvents->retrieve('11111111-2222-3333-4444-555555555555');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.monitoring_events.retrieve("11111111-2222-3333-4444-555555555555")
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.MonitoringEvents.RetrieveAsync("11111111-2222-3333-4444-555555555555");
Console.WriteLine(JsonSerializer.Serialize(result));{
"event_uuid": "33333333-4444-5555-6666-777777777777",
"event_id": "login-2026-10-17-000001",
"event_category": "auth",
"action_type": "login",
"occurred_at": "2026-10-17T09:15:02.481000Z",
"received_at": "2026-10-17T09:15:02.903114Z",
"status": "IN_REVIEW",
"score": 40,
"subject_vendor_data": "user-42",
"subject_entity_type": "individual",
"subject_uuid": "66666666-7777-8888-9999-000000000000",
"counterparty_vendor_data": null,
"session_id": "web-session-abc",
"device_fingerprint": "fp-a8c1",
"ip_address": "203.0.113.42",
"ip_country": "ES",
"amount": null,
"currency": null,
"game_id": null,
"round_id": null,
"bonus_id": null,
"affiliate_code": null,
"payment_reference_id": null,
"retention_class": "risk_relevant",
"rules_matched_count": 1,
"correlation_pending": false,
"is_droppable": true,
"payload": {
"method": "password"
},
"custom_values": {
"vip_tier": "gold",
"vpn_or_proxy_detected": true
},
"device_context": {
"fingerprint": "fp-a8c1",
"network_context": {
"ip_address": "203.0.113.42",
"ip_country": "Spain",
"ip_country_code": "ES",
"ip_city": "Madrid",
"asn_number": 64500,
"asn_organization": "Example Networks",
"is_vpn_or_tor": true,
"is_data_center": false
}
},
"field_sources": {
"subject.vendor_data": "customer",
"event_category": "customer",
"action_type": "customer",
"occurred_at": "customer",
"received_at": "server",
"payload.method": "customer",
"session.session_id": "customer",
"session.sequence": "customer",
"device_context.fingerprint": "customer",
"device_context.network_context.ip_address": "customer",
"device_context.network_context.ip_country": "server",
"device_context.network_context.ip_country_code": "server",
"device_context.network_context.ip_city": "server",
"device_context.network_context.asn_number": "server",
"device_context.network_context.asn_organization": "server",
"device_context.network_context.is_vpn_or_tor": "server",
"device_context.network_context.is_data_center": "server"
},
"session_sequence": 142,
"table_id": null,
"hand_id": null,
"match_id": null,
"market_id": null,
"side": null,
"role": null,
"net_result_amount": null,
"payment_fingerprint": null,
"instrument_reference_hash": null,
"withdrawal_address_hash": null,
"dispute_id": null,
"chargeback_id": null,
"changed_field": null,
"identity_match_ref": null,
"schema_version": 1,
"expires_at": "2027-01-15T09:15:02.481000Z",
"rules_evaluated_count": 6,
"rule_runs": [
{
"rule_uuid": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"rule_title": "Login from VPN or Tor",
"library_key": null,
"matched": true,
"mode": "ACTIVE",
"is_async": false,
"severity": "MEDIUM",
"score_delta": 40,
"action_summary": "score +40; add_tag:VPN_LOGIN",
"matched_payload": [
{
"field": "event.ip.is_vpn_or_tor",
"operator": "eq",
"expected_value": true,
"current_value": true,
"matched": true,
"group_index": null,
"group_logic": "AND",
"field_source": "server"
}
],
"created_at": "2026-10-17T09:15:02.951207Z"
}
],
"ip_enrichment": {
"ip_country_code": "ES",
"ip_city": "Madrid",
"asn_number": 64500,
"asn_organization": "Example Networks",
"is_vpn_or_tor": true,
"is_data_center": false,
"proxy_type": null,
"last_enriched_at": "2026-10-17T09:15:02.910442Z"
},
"subject_profile": null,
"tags": [
"VPN_LOGIN"
]
}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
Identificador de Didit del evento (event_uuid de la respuesta de creación, lote, listado o cronología), no tu propio event_id.
Respuesta
El evento con su evidencia.
Un evento de monitorización con su envoltorio completo, su enriquecimiento y la evidencia de las reglas. Todos los campos de MonitoringEvent más los campos siguientes.
Identificador de Didit del evento. Úsalo como {event_uuid} en las llamadas de obtención y eliminación.
Tu propio identificador, la clave de idempotencia que enviaste.
128Categoría del evento.
auth, session, gameplay, bonus, affiliate, payment, dispute, security, responsible_gambling, custom Qué ocurrió dentro de la categoría, tal como lo enviaste.
128Cuándo ocurrió el evento en tu lado.
Cuándo aceptó Didit el evento.
ACCEPTED: almacenado, ninguna regla coincidente cambió su estado (la respuesta normal para la mayoría de los eventos, y siempre la respuesta en una aplicación sandbox, donde no se ejecuta ninguna regla). APPROVED: una regla coincidió y la puntuación se mantuvo por debajo de tu umbral de revisión. IN_REVIEW: una regla hizo que la puntuación superara el umbral de revisión o fijó el estado. DECLINED: una regla lo rechazó o la puntuación superó tu umbral de rechazo.
ACCEPTED, APPROVED, IN_REVIEW, DECLINED Puntuación acumulada de las reglas. Empieza en 0; las acciones add_score de las reglas la modifican (se permiten incrementos negativos).
subject.vendor_data del evento: tu id para el usuario o la empresa.
255individual o company: qué tipo de sujeto nombra subject_vendor_data.
"individual"
UUID del usuario (persona física) o de la empresa a la que se resolvió el evento, o null cuando ese registro ya no existe.
El otro jugador de un evento P2P (promovido desde payload.counterparty_vendor_data).
255session.session_id enviado con el evento.
255device_context.fingerprint enviado con el evento.
255Dirección IP del evento. En el canal del servidor es device_context.network_context.ip_address tal como lo enviaste; en el canal del dispositivo es la IP de la solicitud.
64Código de país de ip_address obtenido del enriquecimiento de IP, o null cuando la dirección no se enriqueció (ausente, privada o telemetría de poco valor cuya dirección no se conocía ya).
"ES"
Importe como cadena decimal con 18 decimales, tomado de transaction_context.amount, payload.amount o payload.stake_amount, en ese orden.
"250.000000000000000000"
Moneda tomada de transaction_context.currency o payload.currency.
10Se promueve desde payload.game_id.
128Tomado de payload.round_id.
128Se promueve desde payload.bonus_id.
128Se promueve desde payload.affiliate_code.
128Referencia de pago tomada de transaction_context.payment_reference_id o de payload.payment_reference_id.
255Clase de retención. Los eventos de pago y de disputa son monetary_or_compliance; los eventos de seguridad y de juego responsable son risk_relevant; session.page_view, session.sdk_heartbeat, session.sdk_loaded, session.device_seen, session.bot_signal_observed, bonus.promotion_viewed y affiliate.referral_clicked son low_value; todo lo demás es standard. Un evento que coincide con una regla activa se promociona a risk_relevant (nunca se degrada).
low_value, standard, risk_relevant, monetary_or_compliance Número de reglas que coincidieron con el evento, incluidas las reglas en modo TEST (que registran evidencias pero no aplican ninguna acción).
x >= 0true mientras una regla asíncrona (correlación entre sujetos o una secuencia de más de 24 horas) aún tiene que ejecutarse para este evento. Se resuelve en minutos y status, score y rules_matched_count se actualizan en el mismo registro.
Indica si un SDK con contrapresión puede descartar eventos de este tipo. false para todos los eventos security, payment, dispute y responsible_gambling, y para gameplay.bet_placed, gameplay.bet_settled y gameplay.p2p_settlement.
Los campos de la categoría que enviaste en payload.
Los custom_values escalares que enviaste. Didit añade vpn_or_proxy_detected: true o is_data_center: true cuando el enriquecimiento de IP marca la dirección y tú no los estableciste.
El contexto de dispositivo tal como se almacena: tu device_context (incluidos fingerprint, persistent_device_id y bot_score cuando se envían) con network_context completado mediante el enriquecimiento de IP (ip_country, ip_country_code, ip_city, asn_number, asn_organization, is_vpn_or_tor, is_data_center, proxy_type, connection_type) para las claves que dejaste vacías.
Mapa de ruta de campo a procedencia: customer (enviado por tu backend), sdk (enviado a través del canal del dispositivo) o server (derivado por Didit, como received_at y los campos de red enriquecidos). Compruébalo antes de actuar ante una coincidencia.
Show child attributes
Show child attributes
session.sequence enviado con el evento.
Tomado de payload.table_id.
128Se promueve desde payload.hand_id.
128Tomado de payload.match_id.
128Tomado de payload.market_id.
128Tomado de payload.side.
64Tomado de payload.role.
64Tomado de payload.net_result_amount, como cadena decimal con 18 decimales.
"-120.000000000000000000"
Tomado de payload.payment_fingerprint.
255Tomado de payload.instrument_reference_hash.
255Tomado de payload.withdrawal_address_hash (o de payload.destination_reference_hash).
255Se promueve desde payload.dispute_id.
255Se promueve desde payload.chargeback_id.
255Se promueve desde payload.changed_field (eventos de cambios de seguridad).
128Se promueve desde payload.identity_match_ref (coincidencias en registros de juego responsable).
255Versión del esquema del sobre del evento. Actualmente, 1.
1
Cuándo expira el evento según su clase de retención y se elimina: occurred_at más el periodo de la clase (14, 30 o 90 días por defecto, ajustable por aplicación). Nulo para los eventos monetary_or_compliance, que siguen la retención de transacciones.
Número de reglas de eventos evaluadas para este evento.
x >= 0Todas las reglas que coincidieron con el evento, de la más reciente a la más antigua.
Show child attributes
Show child attributes
Enriquecimiento de la dirección IP del evento, o null si la dirección no se enriqueció. Consulta Enriquecimiento de IP.
Show child attributes
Show child attributes
Señales de riesgo de correo electrónico y teléfono del sujeto almacenadas en caché, o null cuando no existe ningún perfil para el sujeto.
Show child attributes
Show child attributes
Nombres de las etiquetas asociadas al evento (acciones add_tags de las reglas).