Primers passos
Integració / SDK
Verificació d'usuaris
Verificació d'empreses
Monitoratge de transaccions
Registre de canviscurl -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"
]
}Obtenir un esdeveniment de monitoratge: API
Didit: obté un esdeveniment de monitoratge amb payload, dispositiu, IP, senyals en caché, etiquetes i evidència de regles.
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"
]
}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
Identificador de Didit de l'esdeveniment (event_uuid de la resposta de creació, lot, llistat o línia temporal), no el teu propi event_id.
Resposta
L'esdeveniment amb les seves evidències.
Un esdeveniment de monitoratge amb el seu sobre complet, enriquiment i evidències de regles. Tots els camps de MonitoringEvent més els camps següents.
Identificador de Didit de l'esdeveniment. Utilitza'l com a {event_uuid} a les crides de recuperació i eliminació.
El teu propi identificador, la clau d'idempotència que has enviat.
128Categoria de l'esdeveniment.
auth, session, gameplay, bonus, affiliate, payment, dispute, security, responsible_gambling, custom Què ha passat dins de la categoria, tal com ho has enviat.
128Quan va ocórrer l'esdeveniment al teu costat.
Quan Didit ha acceptat l'esdeveniment.
ACCEPTED: emmagatzemat, cap regla coincident no n'ha canviat l'estat (la resposta habitual per a la majoria d'esdeveniments, i sempre la resposta en una aplicació de sandbox, on no s'executa cap regla). APPROVED: una regla ha coincidit i la puntuació s'ha mantingut per sota del teu llindar de revisió. IN_REVIEW: una regla ha fet que la puntuació superés el llindar de revisió o n'ha establert l'estat. DECLINED: una regla ho ha rebutjat o la puntuació ha superat el teu llindar de rebuig.
ACCEPTED, APPROVED, IN_REVIEW, DECLINED Puntuació de regles acumulada. Comença a 0; les accions add_score de les regles la modifiquen (es permeten increments negatius).
subject.vendor_data de l'esdeveniment: el teu id per a l'usuari o l'empresa.
255individual o company: quin tipus de subjecte indica subject_vendor_data.
"individual"
UUID de l'usuari (persona física) o empresa al qual s'ha resolt l'esdeveniment, o null quan aquest registre ja no existeix.
L'altre participant d'un esdeveniment P2P (promogut des de payload.counterparty_vendor_data).
255session.session_id enviat amb l'esdeveniment.
255device_context.fingerprint enviat amb l'esdeveniment.
255Adreça IP de l'esdeveniment. A la via del servidor és device_context.network_context.ip_address tal com la vas enviar; a la via del dispositiu és la IP de la sol·licitud.
64Codi de país d'ip_address obtingut de l'enriquiment d'IP, o null quan l'adreça no s'ha enriquit (telemetria absent, privada o de baix valor l'adreça de la qual encara no es coneixia).
"ES"
Import com a cadena decimal amb 18 decimals, procedent de transaction_context.amount, payload.amount o payload.stake_amount, en aquest ordre.
"250.000000000000000000"
Moneda de transaction_context.currency o payload.currency.
10Promogut des de payload.game_id.
128Promogut des de payload.round_id.
128Promocionat des de payload.bonus_id.
128Promocionat des de payload.affiliate_code.
128Referència de pagament de transaction_context.payment_reference_id o payload.payment_reference_id.
255Classe de conservació de dades. Els esdeveniments de pagament i disputa són monetary_or_compliance; els esdeveniments de seguretat i joc responsable són risk_relevant; session.page_view, session.sdk_heartbeat, session.sdk_loaded, session.device_seen, session.bot_signal_observed, bonus.promotion_viewed i affiliate.referral_clicked són low_value; tota la resta és standard. Un esdeveniment que hagi coincidit amb una regla activa es promociona a risk_relevant (mai es degrada).
low_value, standard, risk_relevant, monetary_or_compliance Nombre de regles que han coincidit amb l'esdeveniment, incloses les regles en mode TEST (que registren proves però no apliquen cap acció).
x >= 0true mentre una regla asíncrona (correlació entre subjectes o una seqüència de més de 24 hores) encara s'ha d'executar per a aquest esdeveniment. Es resol en qüestió de minuts i status, score i rules_matched_count s'actualitzen in situ.
Indica si un SDK sotmès a contrapressió pot descartar esdeveniments d'aquest tipus. false per a tots els esdeveniments de security, payment, dispute i responsible_gambling i per a gameplay.bet_placed, gameplay.bet_settled i gameplay.p2p_settlement.
Els camps de categoria que has enviat a payload.
Els custom_values escalars que has enviat. Didit afegeix vpn_or_proxy_detected: true o is_data_center: true quan l'enriquiment d'IP marca l'adreça i no els havies definit.
El context de dispositiu tal com s'ha emmagatzemat: el teu device_context (inclosos fingerprint, persistent_device_id i bot_score quan s'envien) amb el network_context completat per l'enriquiment d'IP (ip_country, ip_country_code, ip_city, asn_number, asn_organization, is_vpn_or_tor, is_data_center, proxy_type, connection_type) per a les claus que hagis deixat buides.
Ruta del camp fins a la procedència: customer (enviat pel teu backend), sdk (enviat a través del canal del dispositiu) o server (derivat per Didit, com ara received_at i camps de xarxa enriquits). Comprova-ho abans d'actuar sobre una coincidència.
Show child attributes
Show child attributes
session.sequence enviat amb l'esdeveniment.
Promogut des de payload.table_id.
128Promogut des de payload.hand_id.
128Promogut des de payload.match_id.
128Promogut des de payload.market_id.
128Promogut des de payload.side.
64Promogut des de payload.role.
64Promogut des de payload.net_result_amount, com una cadena decimal amb 18 xifres decimals.
"-120.000000000000000000"
Promogut des de payload.payment_fingerprint.
255Promogut des de payload.instrument_reference_hash.
255Promogut des de payload.withdrawal_address_hash (o payload.destination_reference_hash).
255Promogut des de payload.dispute_id.
255Promogut des de payload.chargeback_id.
255Promogut des de payload.changed_field (esdeveniments de canvi de seguretat).
128Promogut des de payload.identity_match_ref (coincidències amb el registre de joc responsable).
255Versió de l'esquema de l'embolcall de l'esdeveniment. Actualment 1.
1
Quan l'esdeveniment caduca segons la seva classe de conservació i s'elimina: occurred_at més el període de la classe (14, 30 o 90 dies per defecte, ajustable per aplicació). Null per a esdeveniments monetary_or_compliance, que segueixen la conservació de transaccions.
Nombre de regles d'esdeveniment avaluades per a aquest esdeveniment.
x >= 0Totes les regles que han coincidit amb l'esdeveniment, de la més recent a la més antiga.
Show child attributes
Show child attributes
Enriquiment de l'adreça IP de l'esdeveniment, o null quan l'adreça no s'ha enriquit. Consulta Enriquiment d'IP.
Show child attributes
Show child attributes
Senyals de risc de correu electrònic i telèfon del subjecte emmagatzemats a la memòria cau, o null quan no existeix cap perfil per al subjecte.
Show child attributes
Show child attributes
Noms de les etiquetes adjuntades a l'esdeveniment (accions add_tags de la regla).