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/?event_category=payment&event_category=dispute&matched_only=true&occurred_from=2026-10-01T00:00:00Z&limit=50' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
for item in client.monitoring_events.list():
print(item)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
for await (const item of didit.monitoringEvents.list()) {
console.log(item);
}ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
iter := client.MonitoringEvents.ListAutoPaging(ctx, didit.MonitoringEventsListParams{})
for iter.Next() {
fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
log.Fatal(err)
}import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
for (var item : client.monitoringEvents().list()) {
System.out.println(item);
}<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
foreach ($didit->monitoringEvents->list() as $item) {
print_r($item->toArray());
}require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
didit.monitoring_events.list.auto_paging_each do |item|
puts item.to_h
endusing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
await foreach (var item in await client.MonitoringEvents.ListAsync())
{
Console.WriteLine(JsonSerializer.Serialize(item));
}{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"event_uuid": "11111111-2222-3333-4444-555555555555",
"event_id": "chargeback-2026-10-16-000318",
"event_category": "dispute",
"action_type": "chargeback_opened",
"occurred_at": "2026-10-16T14:02:11Z",
"received_at": "2026-10-16T14:02:12.418230Z",
"status": "IN_REVIEW",
"score": 60,
"subject_vendor_data": "user-42",
"subject_entity_type": "individual",
"subject_uuid": "66666666-7777-8888-9999-000000000000",
"counterparty_vendor_data": null,
"session_id": null,
"device_fingerprint": null,
"ip_address": null,
"ip_country": null,
"amount": "250.000000000000000000",
"currency": "EUR",
"game_id": null,
"round_id": null,
"bonus_id": null,
"affiliate_code": null,
"payment_reference_id": "dep_735",
"retention_class": "monetary_or_compliance",
"rules_matched_count": 1,
"correlation_pending": false,
"is_droppable": false
},
{
"event_uuid": "22222222-3333-4444-5555-666666666666",
"event_id": "login-2026-10-15-000912",
"event_category": "auth",
"action_type": "login",
"occurred_at": "2026-10-15T08:30:00.120000Z",
"received_at": "2026-10-15T08:30:00.734512Z",
"status": "ACCEPTED",
"score": 0,
"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": "standard",
"rules_matched_count": 0,
"correlation_pending": false,
"is_droppable": true
}
]
}Listar eventos de monitorización: API
Lista los eventos de monitorización de Didit por categoría, estado, sujeto, dispositivo, IP, referencia de pago y periodo, más recientes primero.
curl -X GET 'https://verification.didit.me/v3/events/?event_category=payment&event_category=dispute&matched_only=true&occurred_from=2026-10-01T00:00:00Z&limit=50' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
for item in client.monitoring_events.list():
print(item)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
for await (const item of didit.monitoringEvents.list()) {
console.log(item);
}ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
iter := client.MonitoringEvents.ListAutoPaging(ctx, didit.MonitoringEventsListParams{})
for iter.Next() {
fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
log.Fatal(err)
}import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
for (var item : client.monitoringEvents().list()) {
System.out.println(item);
}<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
foreach ($didit->monitoringEvents->list() as $item) {
print_r($item->toArray());
}require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
didit.monitoring_events.list.auto_paging_each do |item|
puts item.to_h
endusing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
await foreach (var item in await client.MonitoringEvents.ListAsync())
{
Console.WriteLine(JsonSerializer.Serialize(item));
}{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"event_uuid": "11111111-2222-3333-4444-555555555555",
"event_id": "chargeback-2026-10-16-000318",
"event_category": "dispute",
"action_type": "chargeback_opened",
"occurred_at": "2026-10-16T14:02:11Z",
"received_at": "2026-10-16T14:02:12.418230Z",
"status": "IN_REVIEW",
"score": 60,
"subject_vendor_data": "user-42",
"subject_entity_type": "individual",
"subject_uuid": "66666666-7777-8888-9999-000000000000",
"counterparty_vendor_data": null,
"session_id": null,
"device_fingerprint": null,
"ip_address": null,
"ip_country": null,
"amount": "250.000000000000000000",
"currency": "EUR",
"game_id": null,
"round_id": null,
"bonus_id": null,
"affiliate_code": null,
"payment_reference_id": "dep_735",
"retention_class": "monetary_or_compliance",
"rules_matched_count": 1,
"correlation_pending": false,
"is_droppable": false
},
{
"event_uuid": "22222222-3333-4444-5555-666666666666",
"event_id": "login-2026-10-15-000912",
"event_category": "auth",
"action_type": "login",
"occurred_at": "2026-10-15T08:30:00.120000Z",
"received_at": "2026-10-15T08:30:00.734512Z",
"status": "ACCEPTED",
"score": 0,
"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": "standard",
"rules_matched_count": 0,
"correlation_pending": false,
"is_droppable": true
}
]
}rules_matched_count.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 consulta
Número máximo de eventos por página. El valor predeterminado es 50. Los valores superiores a 1000000 devuelven 400; un valor no numérico, cero o negativo se sustituye por 50.
1 <= x <= 1000000Número de eventos que se omiten. El valor predeterminado es 0. Es preferible seguir la URL next de la respuesta.
0 <= x <= 1000000Solo eventos de estas categorías. Repite el parámetro para indicar varios valores (?event_category=payment&event_category=dispute); se devuelve cualquier evento que coincida con alguno de ellos.
auth, session, gameplay, bonus, affiliate, payment, dispute, security, responsible_gambling, custom Solo eventos con estos tipos de acción (coincidencia exacta, distingue mayúsculas y minúsculas). Repite el parámetro para indicar varios valores.
Solo eventos con estos estados. Repite el parámetro para indicar varios valores.
ACCEPTED, APPROVED, IN_REVIEW, DECLINED Solo eventos de estas clases de retención. Repite el parámetro para indicar varios valores.
low_value, standard, risk_relevant, monetary_or_compliance Coincidencia exacta con el vendor_data del sujeto. El mismo id puede designar a una persona física y a una empresa; añade subject_entity_type para elegir uno, o usa GET /v3/events/subjects/{vendor_data}/.
company devuelve solo eventos de sujetos de tipo empresa; cualquier otro valor no vacío (por ejemplo, individual) devuelve solo eventos de personas físicas. Omítelo para obtener ambos.
individual, company Coincidencia exacta con el business.vendor_data enviado con el evento.
Coincidencia exacta con session.session_id.
Coincidencia exacta con device_context.fingerprint.
Coincidencia exacta con la dirección IP del evento.
Coincidencia exacta con el game_id promovido.
Coincidencia exacta con el round_id promovido.
Coincidencia exacta con el affiliate_code promovido.
Coincidencia exacta con la referencia de pago (de transaction_context.payment_reference_id o payload.payment_reference_id).
Coincidencia exacta con el counterparty_vendor_data promovido.
true (también 1 o yes, sin distinguir mayúsculas de minúsculas) devuelve solo los eventos en los que coincidió al menos una regla (rules_matched_count mayor que 0). Cualquier otro valor se ignora.
Solo eventos con occurred_at igual o posterior a este instante (inclusive). Envía un valor ISO 8601: 2026-10-01T00:00:00Z, un desfase explícito con el + codificado en formato porcentual (2026-10-01T02:00:00%2B02:00; un + sin codificar se decodifica como un espacio y el valor deja de poder interpretarse) o solo una fecha (2026-10-01), que equivale a las 00:00:00 UTC de ese día. Un valor sin desfase se interpreta como UTC. No se aceptan valores en ningún otro formato.
Solo eventos con occurred_at igual o anterior a este instante (inclusive). Una fecha sola equivale al inicio de ese día, por lo que occurred_to=2026-10-15 excluye el resto del 15 de octubre; envía 2026-10-15T23:59:59Z para incluirlo. Envía un valor ISO 8601: 2026-10-01T00:00:00Z, un desfase explícito con el + codificado en formato porcentual (2026-10-01T02:00:00%2B02:00; un + sin codificar se decodifica como un espacio y el valor deja de poder interpretarse) o solo una fecha (2026-10-01), que equivale a las 00:00:00 UTC de ese día. Un valor sin desfase se interpreta como UTC. No se aceptan valores en ningún otro formato.
Coincidencia de subcadena, sin distinguir mayúsculas y minúsculas, en event_id, action_type, subject_vendor_data o counterparty_vendor_data.
Respuesta
Una página de resúmenes de eventos.
Una página de eventos de monitorización, con el occurred_at más reciente primero.
Número de eventos coincidentes, exacto hasta 100 y limitado a 100 por encima de esa cifra. No calcules el número de páginas a partir de él; sigue next hasta que sea null.
URL de la página siguiente, o null en la última página.
URL de la página anterior, o null en la primera página.
Show child attributes
Show child attributes