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/?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 monitoramento: API da Didit
Liste eventos de monitoramento da Didit por categoria, status, sujeito, dispositivo, IP, referência de pagamento e período, recentes primeiro.
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 mudar.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 consulta
Número máximo de eventos por página. O padrão é 50. Valores acima de 1000000 retornam 400; um valor não numérico, zero ou negativo volta para 50.
1 <= x <= 1000000Número de eventos a pular. O padrão é 0. Prefira seguir a URL next da resposta.
0 <= x <= 1000000Somente eventos nestas categorias. Repita o parâmetro para vários valores (?event_category=payment&event_category=dispute); um evento que corresponda a qualquer um deles é retornado.
auth, session, gameplay, bonus, affiliate, payment, dispute, security, responsible_gambling, custom Somente eventos com estes tipos de ação (exatos, diferenciando maiúsculas de minúsculas). Repita para vários valores.
Somente eventos com estes status. Repita para vários valores.
ACCEPTED, APPROVED, IN_REVIEW, DECLINED Somente eventos nestas classes de retenção. Repita para vários valores.
low_value, standard, risk_relevant, monetary_or_compliance Correspondência exata no vendor_data do titular. O mesmo id pode identificar uma pessoa física e uma empresa; adicione subject_entity_type para escolher uma delas ou use GET /v3/events/subjects/{vendor_data}/.
company retorna apenas eventos de titulares do tipo empresa; qualquer outro valor não vazio (por exemplo, individual) retorna apenas eventos de pessoas físicas. Omita-o para retornar ambos.
individual, company Correspondência exata no business.vendor_data enviado com o evento.
Correspondência exata em session.session_id.
Correspondência exata em device_context.fingerprint.
Correspondência exata no endereço IP do evento.
Correspondência exata no game_id promovido.
Correspondência exata no round_id promovido.
Correspondência exata no affiliate_code promovido.
Correspondência exata na referência de pagamento (de transaction_context.payment_reference_id ou payload.payment_reference_id).
Correspondência exata no counterparty_vendor_data promovido.
true (também 1 ou yes, sem diferenciar maiúsculas de minúsculas) retorna apenas os eventos aos quais pelo menos uma regra correspondeu (rules_matched_count acima de 0). Qualquer outro valor é ignorado.
Somente eventos com occurred_at neste instante ou depois dele (inclusive). Envie um valor ISO 8601: 2026-10-01T00:00:00Z, um deslocamento explícito com o + codificado em percentual (2026-10-01T02:00:00%2B02:00; um + não codificado é decodificado como espaço e o valor deixa de ser interpretado) ou apenas uma data (2026-10-01), que significa 00:00:00 UTC desse dia. Um valor sem deslocamento é lido como UTC. Valores em qualquer outro formato não são aceitos.
Somente eventos com occurred_at neste instante ou antes dele (inclusive). Apenas uma data significa o início desse dia, então occurred_to=2026-10-15 exclui o restante de 15 de outubro; envie 2026-10-15T23:59:59Z para incluí-lo. Envie um valor ISO 8601: 2026-10-01T00:00:00Z, um deslocamento explícito com o + codificado em percentual (2026-10-01T02:00:00%2B02:00; um + não codificado é decodificado como espaço e o valor deixa de ser interpretado) ou apenas uma data (2026-10-01), que significa 00:00:00 UTC desse dia. Um valor sem deslocamento é lido como UTC. Valores em qualquer outro formato não são aceitos.
Correspondência de substring sem distinção entre maiúsculas e minúsculas em event_id, action_type, subject_vendor_data ou counterparty_vendor_data.
Resposta
Uma página de resumos de eventos.
Uma página de eventos de monitoramento, do occurred_at mais recente para o mais antigo.
Número de eventos correspondentes, exato até 100 e limitado a 100 acima disso. Não calcule o número de páginas a partir dele; siga next até que seja nulo.
URL da próxima página, ou null na última página.
URL da página anterior, ou null na primeira página.
Show child attributes
Show child attributes