Primeiros passos
Integração / SDKs
Verificação de usuários
Verificação de empresas
Monitoramento de transações
Registro de alteraçõescurl -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"
]
}Obter evento de monitoramento via API
A API da Didit retorna um evento de monitoramento com payload, dispositivo, enriquecimento de IP, sinais do titular, tags e evidências de regras.
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"
]
}Autorizações
Chave de API da sua aplicação, em Developers -> API keys no Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter escopo restrito: nenhum acesso, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está errada, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que a requisição veio de um endereço fora da sua lista de IPs; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status da chave. Uma chave sem acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave sem permissão de escrita em sessões recebe links e tokens de sessão como null. Consulte https://docs.didit.me/console/api-keys.
Parâmetros de caminho
Identificador da Didit para o evento (event_uuid da resposta de criação, lote, listagem ou linha do tempo), não o seu próprio event_id.
Resposta
O evento com suas evidências.
Um evento de monitoramento com seu envelope completo, enriquecimento e evidências das regras. Todos os campos de MonitoringEvent, além dos campos abaixo.
Identificador da Didit para o evento. Use-o como {event_uuid} nas chamadas de consulta e exclusão.
Seu próprio identificador, a chave de idempotência que você enviou.
128Categoria do evento.
auth, session, gameplay, bonus, affiliate, payment, dispute, security, responsible_gambling, custom O que aconteceu dentro da categoria, como você enviou.
128Quando o evento ocorreu do seu lado.
Quando a Didit aceitou o evento.
ACCEPTED: armazenado, nenhuma regra correspondente alterou sua situação (a resposta normal para a maioria dos eventos, e sempre a resposta em uma aplicação de sandbox, onde nenhuma regra é executada). APPROVED: uma regra correspondeu e a pontuação ficou abaixo do seu limiar de revisão. IN_REVIEW: uma regra elevou a pontuação acima do limiar de revisão ou definiu o status. DECLINED: uma regra o recusou ou a pontuação ultrapassou seu limiar de recusa.
ACCEPTED, APPROVED, IN_REVIEW, DECLINED Pontuação acumulada das regras. Começa em 0; as ações add_score das regras a alteram (variações negativas são permitidas).
subject.vendor_data do evento: o seu id para o usuário ou a empresa.
255individual ou company: o tipo de titular identificado por subject_vendor_data.
"individual"
UUID do usuário (pessoa física) ou da empresa ao qual o evento foi associado, ou null quando esse registro não existe mais.
O outro jogador de um evento P2P (promovido a partir de payload.counterparty_vendor_data).
255session.session_id enviado com o evento.
255device_context.fingerprint enviado com o evento.
255Endereço IP do evento. No canal do servidor, é o device_context.network_context.ip_address exatamente como você o enviou; no canal do dispositivo, é o IP da requisição.
64Código do país de ip_address obtido pelo enriquecimento de IP, ou null quando o endereço não foi enriquecido (ausente, privado ou telemetria de baixo valor cujo endereço ainda não era conhecido).
"ES"
Valor como string decimal com 18 casas decimais, obtido de transaction_context.amount, payload.amount ou payload.stake_amount, nessa ordem.
"250.000000000000000000"
Moeda de transaction_context.currency ou payload.currency.
10Promovido a partir de payload.game_id.
128Promovido de payload.round_id.
128Promovido a partir de payload.bonus_id.
128Promovido a partir de payload.affiliate_code.
128Referência de pagamento obtida de transaction_context.payment_reference_id ou payload.payment_reference_id.
255Classe de retenção. Eventos de pagamento e de disputa são monetary_or_compliance; eventos de segurança e de jogo responsável são risk_relevant; session.page_view, session.sdk_heartbeat, session.sdk_loaded, session.device_seen, session.bot_signal_observed, bonus.promotion_viewed e affiliate.referral_clicked são low_value; todo o resto é standard. Um evento correspondido por uma regra ativa é promovido para risk_relevant (nunca rebaixado).
low_value, standard, risk_relevant, monetary_or_compliance Número de regras que corresponderam ao evento, incluindo regras no modo TEST (que registram evidências, mas não aplicam nenhuma ação).
x >= 0true enquanto uma regra assíncrona (correlação entre sujeitos, ou uma sequência com mais de 24 horas) ainda precisa ser executada para este evento. Ela é resolvida em minutos, e status, score e rules_matched_count são atualizados no próprio registro.
Indica se um SDK sob contrapressão pode descartar eventos deste tipo. false para todo evento security, payment, dispute e responsible_gambling e para gameplay.bet_placed, gameplay.bet_settled e gameplay.p2p_settlement.
Os campos da categoria que você enviou em payload.
Os custom_values escalares que você enviou. A Didit adiciona vpn_or_proxy_detected: true ou is_data_center: true quando o enriquecimento de IP sinaliza o endereço e você não os definiu.
O contexto do dispositivo conforme armazenado: seu device_context (incluindo fingerprint, persistent_device_id e bot_score quando enviados) com network_context completado pelo enriquecimento de IP (ip_country, ip_country_code, ip_city, asn_number, asn_organization, is_vpn_or_tor, is_data_center, proxy_type, connection_type) nas chaves que você deixou vazias.
Caminho do campo até a procedência: customer (enviado pelo seu backend), sdk (enviado pelo canal do dispositivo) ou server (derivado pela Didit, como received_at e campos de rede enriquecidos). Verifique-o antes de agir com base em uma correspondência.
Show child attributes
Show child attributes
session.sequence enviado com o evento.
Promovido de payload.table_id.
128Promovido a partir de payload.hand_id.
128Promovido de payload.match_id.
128Promovido de payload.market_id.
128Promovido de payload.side.
64Promovido de payload.role.
64Promovido de payload.net_result_amount, como string decimal com 18 casas decimais.
"-120.000000000000000000"
Promovido de payload.payment_fingerprint.
255Promovido de payload.instrument_reference_hash.
255Promovido de payload.withdrawal_address_hash (ou payload.destination_reference_hash).
255Promovido a partir de payload.dispute_id.
255Promovido a partir de payload.chargeback_id.
255Promovido a partir de payload.changed_field (eventos de alteração de segurança).
128Promovido a partir de payload.identity_match_ref (correspondências em registros de jogo responsável).
255Versão do esquema do envelope do evento. Atualmente 1.
1
Quando o evento expira conforme sua classe de retenção e é excluído: occurred_at mais o período da classe (14, 30 ou 90 dias por padrão, ajustável por aplicação). Nulo para eventos monetary_or_compliance, que seguem a retenção de transações.
Número de regras de evento avaliadas para este evento.
x >= 0Todas as regras que corresponderam ao evento, da mais recente para a mais antiga.
Show child attributes
Show child attributes
Enriquecimento do endereço IP do evento, ou null quando o endereço não foi enriquecido. Consulte Enriquecimento de IP.
Show child attributes
Show child attributes
Sinais de risco de e-mail e telefone do titular armazenados em cache, ou null quando não existe perfil para o titular.
Show child attributes
Show child attributes
Nomes das tags anexadas ao evento (ações add_tags de regras).