> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # API per eventi di monitoraggio in batch > Con Didit invia fino a 500 eventi di monitoraggio in una richiesta, con esito per ogni elemento: un evento errato non blocca gli altri. Prompt dell'API Batch per la creazione di eventi di monitoraggio Copia il prompt negli appunti \

\`Send up to 500 monitoring events to Didit in one request from my backend, and handle the per-item outcomes.

Endpoint:
POST https://verification.didit.me/v3/events/batch/

Authentication:
Use the x-api-key header with my Didit API key, from my backend only. A scoped key needs transactions: write.

Goal:
\- Flush a queue of events (logins, gameplay rounds, payment steps, chargebacks) in as few requests as possible, without one bad event blocking the others.

Request body (application/json):
\{
"events": [ { ...one event, same envelope as POST /v3/events/... }, ... ]   // 1 to 500 events
}
A bare JSON array of events is also accepted.

Behavior:
\- Each item is validated, stored and evaluated on its own, exactly like POST /v3/events/. A rejected item never rolls back the others.
\- HTTP 201 when no item was rejected, 207 when at least one was. Treat both as success and read results[].
\- results[] has one entry per item in request order, with index pointing into my events array and outcome accepted, replayed or rejected.
\- accepted and replayed items carry the same fields as the single-event response (event_uuid, status, score, rule_matches, correlation_pending, retention_class, expires_at, idempotent_replay).
\- rejected items carry errors keyed by field, in the same shape as the 400 of POST /v3/events/. A reused event_id with different content is reported as a string under errors.event_id. Send event_id in snake_case so a rejected item's results[].event_id is filled.
\- Retry only the rejected items after fixing them. Resending an accepted item is safe: it comes back as replayed.
\- occurred_at must still be within 7 days in the past and 5 minutes in the future for every item.

Example call:
curl -X POST "https://verification.didit.me/v3/events/batch/" \
-H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"events":[{"event_id":"login-2026-10-17-000001","event_category":"auth","action_type":"login","occurred_at":"2026-10-17T09:15:02.481Z","subject":{"vendor_data":"user-42"}}]}'

What to read from the response:
\- accepted_count, replayed_count, rejected_count.
\- results[].index and results[].outcome.
\- results[].errors for rejected items.
\- results[].event_uuid and results[].status for stored items.

Failure modes:
\- 400 - events missing, not an array, empty, or longer than 500 items ({ "events": "" }). Nothing is stored; split the batch.
\- 429 - more than 600 ingestion requests per minute for this API key (event and transaction ingestion share this budget, apart from the 300 of every other write); honor Retry-After.
\- 401 - the API key has expired.
\- 403 - missing API key (a wrong, revoked or expired key gets 401), a scoped key without transactions: write, or code event_monitoring_disabled (event ingestion is not switched on; nothing is stored).

Side effects: stores every valid item, may create subjects, and applies the actions of matched active rules.

For the full integration shape, see /integration/integration-prompt.`

\
Incolla in Vedi [i batch](https://docs.didit.me/it/transaction-monitoring/events.md#batch) nella guida all'ingestione degli eventi. Il canale del dispositivo presenta gli stessi esiti per elemento delle operazioni di flush dell'SDK: vedi [Invio degli eventi SDK](https://docs.didit.me/it/transaction-monitoring/sdk-event-submission.md#batch). ## OpenAPI ````yaml it/openapi-25.json POST /v3/events/batch/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API di verifica dell'identità. Autenticati con l'intestazione x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/events/batch/: post: tags: - Monitoring Events summary: Crea eventi di monitoraggio in batch description: >- Invia da 1 a 500 eventi in un'unica richiesta, ciascuno nello stesso involucro di `POST /v3/events/`. Ogni elemento viene validato, memorizzato e valutato singolarmente e riceve il proprio esito (`accepted`, `replayed` o `rejected`), quindi un evento non valido non annulla mai gli altri: la risposta è `201` quando nessun elemento è stato rifiutato e `207` quando almeno uno lo è stato, ed entrambi indicano che la richiesta è stata elaborata. Invia `{"events": [...]}`; viene accettato anche un semplice array JSON di eventi. L'ingestione degli eventi deve essere abilitata per l'applicazione, altrimenti l'intera richiesta restituisce `403` con `code: event_monitoring_disabled` e non viene memorizzato nulla. Una chiave API con restrizioni di ambito richiede `transactions: write`. Consulta [Lotti](https://docs.didit.me/it/transaction-monitoring/events#batch). operationId: create_monitoring_events_batch requestBody: required: true content: application/json: schema: type: object required: - events properties: events: type: array minItems: 1 maxItems: 500 description: >- Da 1 a 500 eventi. Ciascun elemento segue `MonitoringEventCreateRequest`, inclusa la finestra di 7 giorni nel passato e 5 minuti nel futuro su `occurred_at`. items: $ref: '#/components/schemas/MonitoringEventCreateRequest' example: events: - event_id: login-2026-10-17-000001 event_category: auth action_type: login occurred_at: '2026-10-17T09:15:02.481Z' subject: vendor_data: user-42 - event_id: deposit-2026-10-17-000002 event_category: payment action_type: deposit_completed occurred_at: '2026-10-17T09:16:40Z' subject: vendor_data: user-42 transaction_context: amount: '100.00' currency: EUR payment_reference_id: dep_736 payload: payment_method: card status: completed responses: '201': description: >- Nessun elemento è stato rifiutato: ogni elemento è `accepted` o `replayed`. content: application/json: schema: type: object required: - accepted_count - replayed_count - rejected_count - results properties: accepted_count: type: integer minimum: 0 description: Elementi memorizzati e valutati. replayed_count: type: integer minimum: 0 description: Elementi già memorizzati con lo stesso contenuto. rejected_count: type: integer minimum: 0 description: Elementi non memorizzati. results: type: array description: Una voce per elemento, nell'ordine della richiesta. items: type: object description: >- Esito di un elemento. Gli elementi accettati e ripetuti includono anche ogni campo di `MonitoringEventIngestResult`; gli elementi rifiutati contengono invece `event_id` ed `errors`. required: - index - outcome properties: index: type: integer minimum: 0 description: Posizione dell'elemento nel tuo array `events`. outcome: type: string enum: - accepted - replayed - rejected description: >- `accepted`: memorizzato e valutato. `replayed`: già memorizzato con lo stesso contenuto. `rejected`: non memorizzato; vedi `errors`. event_id: type: string nullable: true description: >- Il tuo `event_id`. Sugli elementi rifiutati dalla validazione viene letto dalla chiave snake_case `event_id` dell'elemento, quindi è null quando l'elemento lo ha omesso o ha inviato l'alias `eventId`. errors: type: object additionalProperties: true description: >- Solo elementi rifiutati. Errori di validazione indicizzati per campo, nello stesso formato del `400` di `POST /v3/events/`; un `event_id` riutilizzato con contenuto diverso viene segnalato come stringa sotto `errors.event_id`. event_uuid: type: string format: uuid description: Solo elementi accettati e rieseguiti. status: type: string enum: - ACCEPTED - APPROVED - IN_REVIEW - DECLINED description: Solo elementi accettati e rieseguiti. score: type: integer description: Solo elementi accettati e rieseguiti. rules_evaluated_count: type: integer description: Solo elementi accettati e rieseguiti. rules_matched_count: type: integer description: Solo elementi accettati e rieseguiti. correlation_pending: type: boolean description: Solo elementi accettati e rieseguiti. retention_class: type: string enum: - low_value - standard - risk_relevant - monetary_or_compliance description: Solo elementi accettati e rieseguiti. expires_at: type: string format: date-time nullable: true description: Solo elementi accettati e rieseguiti. idempotent_replay: type: boolean description: Solo elementi accettati e rieseguiti. rule_matches: type: array description: Solo elementi accettati e rieseguiti. items: type: object required: - rule_id - library_key - mode - is_async properties: rule_id: type: string format: uuid description: UUID della regola. library_key: type: string nullable: true description: >- Chiave della libreria se la regola è stata installata dalla libreria di regole, altrimenti null. mode: type: string enum: - ACTIVE - TEST description: >- Le regole `TEST` registrano la corrispondenza ma non applicano alcuna azione. is_async: type: boolean description: >- `true` quando la corrispondenza proviene dal passaggio asincrono. examples: All landed: value: accepted_count: 1 replayed_count: 1 rejected_count: 0 results: - index: 0 outcome: accepted event_uuid: 33333333-4444-5555-6666-777777777777 event_id: login-2026-10-17-000001 status: ACCEPTED score: 0 rules_evaluated_count: 6 rules_matched_count: 0 correlation_pending: false retention_class: standard expires_at: '2026-11-16T09:15:02.481000Z' idempotent_replay: false rule_matches: [] - index: 1 outcome: replayed event_uuid: 11111111-2222-3333-4444-555555555555 event_id: deposit-2026-10-17-000002 status: ACCEPTED score: 0 rules_evaluated_count: 6 rules_matched_count: 0 correlation_pending: false retention_class: monetary_or_compliance expires_at: null idempotent_replay: true rule_matches: [] '207': description: >- Almeno un elemento è stato rifiutato. Gli altri elementi sono stati memorizzati; correggi e invia nuovamente solo quelli rifiutati (inviare nuovamente un elemento accettato è sicuro, restituisce `replayed`). content: application/json: schema: type: object required: - accepted_count - replayed_count - rejected_count - results properties: accepted_count: type: integer minimum: 0 description: Elementi memorizzati e valutati. replayed_count: type: integer minimum: 0 description: Elementi già memorizzati con lo stesso contenuto. rejected_count: type: integer minimum: 0 description: Elementi non memorizzati. results: type: array description: Una voce per elemento, nell'ordine della richiesta. items: type: object description: >- Esito di un elemento. Gli elementi accettati e ripetuti includono anche ogni campo di `MonitoringEventIngestResult`; gli elementi rifiutati contengono invece `event_id` ed `errors`. required: - index - outcome properties: index: type: integer minimum: 0 description: Posizione dell'elemento nel tuo array `events`. outcome: type: string enum: - accepted - replayed - rejected description: >- `accepted`: memorizzato e valutato. `replayed`: già memorizzato con lo stesso contenuto. `rejected`: non memorizzato; vedi `errors`. event_id: type: string nullable: true description: >- Il tuo `event_id`. Sugli elementi rifiutati dalla validazione viene letto dalla chiave snake_case `event_id` dell'elemento, quindi è null quando l'elemento lo ha omesso o ha inviato l'alias `eventId`. errors: type: object additionalProperties: true description: >- Solo elementi rifiutati. Errori di validazione indicizzati per campo, nello stesso formato del `400` di `POST /v3/events/`; un `event_id` riutilizzato con contenuto diverso viene segnalato come stringa sotto `errors.event_id`. event_uuid: type: string format: uuid description: Solo elementi accettati e rieseguiti. status: type: string enum: - ACCEPTED - APPROVED - IN_REVIEW - DECLINED description: Solo elementi accettati e rieseguiti. score: type: integer description: Solo elementi accettati e rieseguiti. rules_evaluated_count: type: integer description: Solo elementi accettati e rieseguiti. rules_matched_count: type: integer description: Solo elementi accettati e rieseguiti. correlation_pending: type: boolean description: Solo elementi accettati e rieseguiti. retention_class: type: string enum: - low_value - standard - risk_relevant - monetary_or_compliance description: Solo elementi accettati e rieseguiti. expires_at: type: string format: date-time nullable: true description: Solo elementi accettati e rieseguiti. idempotent_replay: type: boolean description: Solo elementi accettati e rieseguiti. rule_matches: type: array description: Solo elementi accettati e rieseguiti. items: type: object required: - rule_id - library_key - mode - is_async properties: rule_id: type: string format: uuid description: UUID della regola. library_key: type: string nullable: true description: >- Chiave della libreria se la regola è stata installata dalla libreria di regole, altrimenti null. mode: type: string enum: - ACTIVE - TEST description: >- Le regole `TEST` registrano la corrispondenza ma non applicano alcuna azione. is_async: type: boolean description: >- `true` quando la corrispondenza proviene dal passaggio asincrono. examples: Partial success: value: accepted_count: 1 replayed_count: 0 rejected_count: 2 results: - index: 0 outcome: accepted event_uuid: 33333333-4444-5555-6666-777777777777 event_id: login-2026-10-17-000001 status: ACCEPTED score: 0 rules_evaluated_count: 6 rules_matched_count: 0 correlation_pending: false retention_class: standard expires_at: '2026-11-16T09:15:02.481000Z' idempotent_replay: false rule_matches: [] - index: 1 event_id: deposit-2026-10-17-000002 outcome: rejected errors: payload: - >- payment.deposit_completed requires: payment_method, status. - index: 2 event_id: login-2026-10-16-000777 outcome: rejected errors: event_id: >- event_id 'login-2026-10-16-000777' already exists with a different payload. '400': description: >- Il batch stesso non è valido: `events` è mancante o non è un array, è vuoto o contiene più di 500 elementi. Non viene memorizzato nulla; dividi i batch di grandi dimensioni. content: application/json: examples: Not a list: value: events: Expected a list of events. Empty: value: events: At least one event is required. Too many: value: events: A batch accepts at most 500 events; received 612. '401': description: >- La chiave API con ambito è scaduta. Solo una chiave scaduta riceve `401`; una chiave mancante o non valida riceve `403`. content: application/json: examples: Expired key: value: detail: This API key has expired. '403': description: >- Intestazione `x-api-key` mancante (una chiave errata, revocata o scaduta restituisce `401`), una chiave con ambito priva di `transactions: write`, una chiave limitata ad alcuni workflow o a sessioni approvate (tale chiave non accede mai ai dati di monitoraggio delle transazioni), oppure una richiesta proveniente dall'esterno dell'allowlist IP della chiave. Restituito anche con `code: event_monitoring_disabled` quando l'ingestione degli eventi è disattivata per l'applicazione; in tal caso nulla viene memorizzato e il controllo viene eseguito prima della validazione del corpo. content: application/json: examples: Event monitoring disabled: value: detail: >- Event monitoring is not enabled for this application. Turn on event ingestion in the transaction monitoring settings before submitting events. code: event_monitoring_disabled Missing or invalid API key: value: detail: You do not have permission to perform this action. Scoped key without access: value: detail: This API key has no write access to transactions. Key limited to workflows or approved sessions: value: detail: >- This API key only reaches sessions inside its workflow or status limits, so it can't use this endpoint. IP not allowed: value: detail: This API key can't be used from this IP address. '429': description: >- Limite di frequenza superato: le creazioni di transazioni e l'ingestione di eventi (`POST /v3/transactions/`, `POST /v3/events/`, `POST /v3/events/batch/`) condividono un budget di 600 richieste al minuto per chiave API, separato dalle 300 condivise da tutte le altre richieste di scrittura. Attendi `Retry-After` secondi, quindi riprova. headers: Retry-After: description: >- Secondi da attendere prima di riprovare, arrotondati per eccesso in modo che il nuovo tentativo rientri nella finestra successiva. schema: type: integer minimum: 1 example: 30 content: application/json: examples: Throttled: value: detail: >- Ingestion rate limit exceeded. You can make up to 600 requests per minute. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: |- curl -X POST 'https://verification.didit.me/v3/events/batch/' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "events": [ {"event_id": "login-2026-10-17-000001", "event_category": "auth", "action_type": "login", "occurred_at": "2026-10-17T09:15:02.481Z", "subject": {"vendor_data": "user-42"}}, {"event_id": "deposit-2026-10-17-000002", "event_category": "payment", "action_type": "deposit_completed", "occurred_at": "2026-10-17T09:16:40.000Z", "subject": {"vendor_data": "user-42"}, "transaction_context": {"amount": "100.00", "currency": "EUR", "payment_reference_id": "dep_736"}, "payload": {"payment_method": "card", "status": "completed"}} ] }' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.monitoring_events.create_batch( events=[{ "event_id": "login-2026-10-17-000001", "event_category": "auth", "action_type": "login", "occurred_at": "2026-10-17T09:15:02.481Z", "subject": { "vendor_data": "user-42", }, }, { "event_id": "deposit-2026-10-17-000002", "event_category": "payment", "action_type": "deposit_completed", "occurred_at": "2026-10-17T09:16:40Z", "subject": { "vendor_data": "user-42", }, "transaction_context": { "amount": "100.00", "currency": "EUR", "payment_reference_id": "dep_736", }, "payload": {"payment_method": "card", "status": "completed"}, }], ) print(result) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.monitoringEvents.createBatch({ events: [{ event_id: "login-2026-10-17-000001", event_category: "auth", action_type: "login", occurred_at: "2026-10-17T09:15:02.481Z", subject: { vendor_data: "user-42", }, }, { event_id: "deposit-2026-10-17-000002", event_category: "payment", action_type: "deposit_completed", occurred_at: "2026-10-17T09:16:40Z", subject: { vendor_data: "user-42", }, transaction_context: { amount: "100.00", currency: "EUR", payment_reference_id: "dep_736", }, payload: { payment_method: "card", status: "completed" }, }], }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.MonitoringEvents.CreateBatch(ctx, didit.MonitoringEventsCreateBatchParams{\n\tEvents: []didit.MonitoringEventCreateRequest{{\n\t\tEventID: \"login-2026-10-17-000001\",\n\t\tEventCategory: \"auth\",\n\t\tActionType: \"login\",\n\t\tOccurredAt: time.Date(2026, 10, 17, 9, 15, 2, 0, time.UTC),\n\t\tSubject: didit.MonitoringEventCreateRequestSubject{\n\t\t\tVendorData: \"user-42\",\n\t\t},\n\t}, {\n\t\tEventID: \"deposit-2026-10-17-000002\",\n\t\tEventCategory: \"payment\",\n\t\tActionType: \"deposit_completed\",\n\t\tOccurredAt: time.Date(2026, 10, 17, 9, 16, 40, 0, time.UTC),\n\t\tSubject: didit.MonitoringEventCreateRequestSubject{\n\t\t\tVendorData: \"user-42\",\n\t\t},\n\t\tTransactionContext: didit.Some(didit.MonitoringEventCreateRequestTransactionContext{\n\t\t\tAmount: didit.String(\"100.00\"),\n\t\t\tCurrency: didit.String(\"EUR\"),\n\t\t\tPaymentReferenceID: didit.String(\"dep_736\"),\n\t\t}),\n\t\tPayload: didit.Some(map[string]any{\"payment_method\": \"card\", \"status\": \"completed\"}),\n\t}},\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import java.time.OffsetDateTime; import java.util.List; import java.util.Map; import me.didit.Didit; import me.didit.types.MonitoringEventCreateRequest; import me.didit.types.MonitoringEventsCreateBatchParams; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.monitoringEvents().createBatch(MonitoringEventsCreateBatchParams.builder() .events(List.of( MonitoringEventCreateRequest.builder() .eventId("login-2026-10-17-000001") .eventCategory(MonitoringEventCreateRequest.EventCategory.of("auth")) .actionType("login") .occurredAt(OffsetDateTime.parse("2026-10-17T09:15:02.481Z")) .subject(MonitoringEventCreateRequest.Subject.builder() .vendorData("user-42") .build()) .build(), MonitoringEventCreateRequest.builder() .eventId("deposit-2026-10-17-000002") .eventCategory(MonitoringEventCreateRequest.EventCategory.of("payment")) .actionType("deposit_completed") .occurredAt(OffsetDateTime.parse("2026-10-17T09:16:40Z")) .subject(MonitoringEventCreateRequest.Subject.builder() .vendorData("user-42") .build()) .transactionContext(MonitoringEventCreateRequest.TransactionContext.builder() .amount("100.00") .currency("EUR") .paymentReferenceId("dep_736") .build()) .payload(Map.of("payment_method", "card", "status", "completed")) .build())) .build()); System.out.println(result); - lang: php label: PHP source: |- monitoringEvents->createBatch([ 'events' => [[ 'event_id' => 'login-2026-10-17-000001', 'event_category' => 'auth', 'action_type' => 'login', 'occurred_at' => '2026-10-17T09:15:02.481Z', 'subject' => [ 'vendor_data' => 'user-42', ], ], [ 'event_id' => 'deposit-2026-10-17-000002', 'event_category' => 'payment', 'action_type' => 'deposit_completed', 'occurred_at' => '2026-10-17T09:16:40Z', 'subject' => [ 'vendor_data' => 'user-42', ], 'transaction_context' => [ 'amount' => '100.00', 'currency' => 'EUR', 'payment_reference_id' => 'dep_736', ], 'payload' => ['payment_method' => 'card', 'status' => 'completed'], ]], ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.monitoring_events.create_batch( events: [{ event_id: "login-2026-10-17-000001", event_category: "auth", action_type: "login", occurred_at: "2026-10-17T09:15:02.481Z", subject: { vendor_data: "user-42", }, }, { event_id: "deposit-2026-10-17-000002", event_category: "payment", action_type: "deposit_completed", occurred_at: "2026-10-17T09:16:40Z", subject: { vendor_data: "user-42", }, transaction_context: { amount: "100.00", currency: "EUR", payment_reference_id: "dep_736", }, payload: { payment_method: "card", status: "completed" }, }] ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Collections.Generic; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.MonitoringEvents.CreateBatchAsync(new MonitoringEventsCreateBatchParams { Events = new MonitoringEventCreateRequest[] { new() { EventId = "login-2026-10-17-000001", EventCategory = "auth", ActionType = "login", OccurredAt = DateTimeOffset.Parse("2026-10-17T09:15:02.481Z"), Subject = new() { VendorData = "user-42", }, }, new() { EventId = "deposit-2026-10-17-000002", EventCategory = "payment", ActionType = "deposit_completed", OccurredAt = DateTimeOffset.Parse("2026-10-17T09:16:40Z"), Subject = new() { VendorData = "user-42", }, TransactionContext = new MonitoringEventCreateRequestTransactionContext { Amount = "100.00", Currency = "EUR", PaymentReferenceId = "dep_736", }, Payload = new Dictionary { ["payment_method"] = "card", ["status"] = "completed" }, }, }, }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: MonitoringEventCreateRequest: type: object description: >- L'envelope dell'evento, lo stesso per ogni categoria. Sono accettati gli alias in camelCase: `eventId`, `eventCategory` (o `category`), `actionType`, `occurredAt`, `timeZone` (o `zoneId`), `deviceContext` (o `device`), `transactionContext`, `customValues` (o `props`); all'interno di `subject`: `vendorData`, `entityType`, `fullName`; all'interno di `session`: `sessionId`, `pageUrl`; all'interno di `transaction_context`: `paymentReferenceId`. required: - event_id - event_category - action_type - occurred_at - subject properties: event_id: type: string maxLength: 128 description: >- Il tuo identificatore per l'evento, univoco per applicazione. È la chiave di idempotenza: il reinvio, con questo identificatore, degli stessi valori di `event_category`, `action_type`, `occurred_at`, `subject.vendor_data` e `payload` costituisce un replay, qualsiasi elemento differente genera un conflitto. example: login-2026-10-17-000001 event_category: type: string enum: - auth - session - gameplay - bonus - affiliate - payment - dispute - security - responsible_gambling - custom description: Categoria dell'evento. example: auth action_type: type: string minLength: 1 maxLength: 128 description: >- Cosa è successo all'interno della categoria. Vocabolario aperto; le azioni gestite elencate in [Event ingestion](https://docs.didit.me/it/transaction-monitoring/events) (ad esempio `login`, `deposit_completed`, `chargeback_opened`) sbloccano la convalida tipizzata e i campi delle regole gestite. Gli spazi vuoti iniziali e finali vengono rimossi. example: login occurred_at: type: string format: date-time description: >- Data e ora in cui l'evento si è verificato nel tuo sistema, ISO 8601 (un valore senza offset viene interpretato come UTC). Non deve essere antecedente a più di 7 giorni nel passato né può essere più di 5 minuti nel futuro. example: '2026-10-17T09:15:02.481Z' time_zone: type: string nullable: true maxLength: 64 description: >- Fuso orario dell'evento dal tuo lato, ad esempio `Europe/Madrid`. Memorizzato con l'evento; non restituito dagli endpoint di lettura. subject: type: object description: >- L'utente o l'azienda a cui appartiene l'evento. Si risolve nell'utente (o azienda) con questo `vendor_data` nella tua applicazione; ne viene creato uno se non ne esiste alcuno. required: - vendor_data properties: vendor_data: type: string minLength: 1 maxLength: 255 description: Il tuo ID per il soggetto. example: user-42 entity_type: type: string maxLength: 32 default: individual description: >- `company` risolve il soggetto in un'azienda; qualsiasi altro valore (predefinito `individual`) lo risolve in una persona fisica. Lo stesso `vendor_data` può indicare uno per ciascun tipo. example: individual full_name: type: string nullable: true maxLength: 512 description: >- Nome visualizzato, utilizzato solo quando questo evento crea l'utente o l'azienda. email: type: string format: email nullable: true description: Validato come indirizzo email; non memorizzato sull'evento. phone: type: string nullable: true maxLength: 32 description: Validato; non memorizzato sull'evento. country: type: string nullable: true maxLength: 3 description: Validato; non memorizzato sull'evento. business: type: object description: >- L'azienda a cui appartiene l'evento, quando differisce dal soggetto. Viene letto solo `vendor_data`. additionalProperties: true properties: vendor_data: type: string maxLength: 255 description: Il tuo ID per l'azienda. Filtrabile come `business_vendor_data`. example: merchant-7 session: type: object description: Il contesto della tua sessione per l'evento. properties: session_id: type: string nullable: true maxLength: 255 description: >- Il tuo identificatore di sessione. Filtrabile e restituito come `session_id`. sequence: type: integer nullable: true description: >- Posizione dell'evento all'interno della sessione. Restituita come `session_sequence`. page_url: type: string nullable: true maxLength: 2048 description: Validato; non memorizzato sull'evento. referrer: type: string nullable: true maxLength: 2048 description: Validato; non memorizzato sull'evento. device_context: type: object additionalProperties: true description: >- Contesto del dispositivo e di rete, memorizzato così come inviato e restituito da `GET /v3/events/{event_uuid}/`. In questo canale server Didit non vede la connessione dell'utente finale, quindi l'IP arricchito e utilizzato dalle regole è `network_context.ip_address` esattamente come inviato. properties: fingerprint: type: string maxLength: 255 description: >- Fingerprint del dispositivo. Filtrabile come `device_fingerprint`. persistent_device_id: type: string maxLength: 255 description: Il tuo identificatore persistente del dispositivo. bot_score: type: integer description: >- Punteggio bot dal tuo sistema di rilevamento, come numero intero. network_context: type: object additionalProperties: true properties: ip_address: type: string maxLength: 64 description: >- Indirizzo IP dell'utente finale. Gli indirizzi pubblici vengono arricchiti una sola volta per ciascun indirizzo univoco. example: 203.0.113.42 transaction_context: type: object description: >- Contesto monetario. I valori non vuoti qui presenti soddisfano anche le chiavi obbligatorie del payload dell'azione. properties: amount: type: string nullable: true description: Importo come stringa decimale (è accettato anche un numero). example: '1000.00' currency: type: string nullable: true maxLength: 10 description: Codice valuta. direction: type: string nullable: true maxLength: 16 description: >- Direzione del movimento di denaro, ad esempio `inbound` o `outbound`. payment_reference_id: type: string nullable: true maxLength: 255 description: >- Il tuo riferimento di pagamento. Filtrabile come `payment_reference_id`. payload: type: object additionalProperties: true description: >- I campi di dominio della categoria, massimo 16384 byte una volta codificati in JSON. Alcune azioni richiedono chiavi (in `payload` o in `transaction_context`): `gameplay.p2p_settlement` richiede `game_id`, `counterparty_vendor_data`, `stake_amount`, `net_result_amount`, `role` e uno tra `hand_id`, `round_id`, `match_id`; `gameplay.bet_placed` e `gameplay.bet_settled` richiedono `game_id`; `payment.deposit_initiated`, `payment.deposit_completed`, `payment.withdrawal_requested` e `payment.withdrawal_completed` richiedono `payment_reference_id`, `amount`, `currency`, `payment_method`, `status`; `payment.withdrawal_address_changed` richiede `withdrawal_address_hash`; `dispute.chargeback_opened`, `dispute.chargeback_won` e `dispute.chargeback_lost` richiedono `payment_reference_id` e uno tra `dispute_id`, `chargeback_id`; `session.bot_signal_observed` richiede `telemetry_schema_version` e uno tra `bot_score`, `actions_per_minute`, `timing_variance_ms`, `pointer_entropy`, `keystroke_entropy`, `reaction_time_ms_p50`; `responsible_gambling.self_exclusion_match` richiede `registry_source`, `exclusion_status`, `identity_match_ref`. Ogni azione `security` che termina con `_changed` richiede `changed_field`, oltre a `previous_reference_hash` o `new_reference_hash` quando il campo è `password`, `mfa_method`, `mfa`, `email`, `phone`, `withdrawal_address`, `payout_method` o `api_key`. Invia hash e riferimenti, mai un numero di carta, un indirizzo di prelievo completo, un hash della password o un segreto MFA. custom_values: type: object description: >- Fino a 100 chiavi personalizzate, indirizzabili dalle regole come `custom_values.`. I valori devono essere scalari (stringa, numero, booleano o null); oggetti e array annidati vengono rifiutati. additionalProperties: nullable: true oneOf: - type: string - type: number - type: boolean example: event_id: login-2026-10-17-000001 event_category: auth action_type: login occurred_at: '2026-10-17T09:15:02.481Z' time_zone: Europe/Madrid subject: vendor_data: user-42 entity_type: individual session: session_id: web-session-abc sequence: 142 device_context: fingerprint: fp-a8c1 network_context: ip_address: 203.0.113.42 payload: method: password custom_values: vip_tier: gold securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.