Primers passos
Integració / SDK
Verificació d'usuaris
Verificació d'empreses
Monitoratge de transaccions
Registre de canviscurl -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
}
]
}Llistar esdeveniments de monitoratge API
Llista els esdeveniments de monitoratge de Didit filtrats per categoria, estat, subjecte, dispositiu, IP i referència de pagament, del més recent.
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.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 consulta
Nombre màxim d'esdeveniments per pàgina. Per defecte és 50. Els valors superiors a 1000000 retornen 400; un valor no numèric, zero o negatiu torna al valor predeterminat de 50.
1 <= x <= 1000000Nombre d'esdeveniments que cal ometre. Per defecte és 0. És preferible seguir l'URL next de la resposta.
0 <= x <= 1000000Només esdeveniments en aquestes categories. Repeteix el paràmetre per a diversos valors (?event_category=payment&event_category=dispute); es retorna un esdeveniment que coincideixi amb qualsevol d'ells.
auth, session, gameplay, bonus, affiliate, payment, dispute, security, responsible_gambling, custom Només esdeveniments amb aquests tipus d'acció (exactes i que distingeixen entre majúscules i minúscules). Repeteix per a diversos valors.
Només esdeveniments amb aquests estats. Repeteix per a diversos valors.
ACCEPTED, APPROVED, IN_REVIEW, DECLINED Només esdeveniments en aquestes classes de conservació. Repeteix per a diversos valors.
low_value, standard, risk_relevant, monetary_or_compliance Coincidència exacta amb el vendor_data del subjecte. El mateix id pot anomenar una persona física i una empresa; afegeix subject_entity_type per triar-ne una, o utilitza GET /v3/events/subjects/{vendor_data}/.
company només retorna esdeveniments de subjectes d'empresa; qualsevol altre valor no buit (per exemple individual) només retorna esdeveniments de particulars. Omet-lo per retornar tots dos.
individual, company Coincidència exacta amb el business.vendor_data enviat amb l'esdeveniment.
Coincidència exacta amb session.session_id.
Coincidència exacta amb device_context.fingerprint.
Coincidència exacta amb l'adreça IP de l'esdeveniment.
Coincidència exacta amb el game_id promocionat.
Coincidència exacta amb el round_id promocionat.
Coincidència exacta amb l'affiliate_code promocionat.
Coincidència exacta amb la referència de pagament (de transaction_context.payment_reference_id o payload.payment_reference_id).
Coincidència exacta amb el counterparty_vendor_data promocionat.
true (també 1 o yes, no distingeix majúscules de minúscules) només retorna esdeveniments en què ha coincidit almenys una regla (rules_matched_count superior a 0). Qualsevol altre valor s'ignora.
Només esdeveniments amb occurred_at en aquest instant o després (inclusiu). Envia un valor ISO 8601: 2026-10-01T00:00:00Z, un desplaçament explícit amb el + codificat en percentatge (2026-10-01T02:00:00%2B02:00; un + sense codificar es descodifica com un espai i el valor deixa de processar-se correctament), o només una data (2026-10-01), que significa les 00:00:00 UTC d'aquell dia. Un valor sense desplaçament s'interpreta com a UTC. No s'accepten valors en cap altre format.
Només esdeveniments amb occurred_at en aquest instant o abans (inclusiu). Només una data significa l'inici d'aquell dia, de manera que occurred_to=2026-10-15 exclou la resta del 15 d'octubre; envia 2026-10-15T23:59:59Z per incloure-ho. Envia un valor ISO 8601: 2026-10-01T00:00:00Z, un desplaçament explícit amb el + codificat en percentatge (2026-10-01T02:00:00%2B02:00; un + sense codificar es descodifica com un espai i el valor deixa de processar-se correctament), o només una data (2026-10-01), que significa les 00:00:00 UTC d'aquell dia. Un valor sense desplaçament s'interpreta com a UTC. No s'accepten valors en cap altre format.
Coincidència de subcadena que no distingeix majúscules de minúscules a event_id, action_type, subject_vendor_data o counterparty_vendor_data.
Resposta
Una pàgina de resums d'esdeveniments.
Una pàgina d'esdeveniments de monitoratge, amb el occurred_at més recent primer.
Nombre d'esdeveniments coincidents, exacte fins a 100 i limitat a 100 per sobre d'aquest valor. No calculis el nombre de pàgines a partir d'aquest valor; segueix next fins que sigui nul.
URL de la pàgina següent, o null a l'última pàgina.
URL de la pàgina anterior, o null a la primera pàgina.
Show child attributes
Show child attributes