> ## 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. # Monitoring-Events im Batch erstellen: Batch-API > Mit Didit bis zu 500 Monitoring-Events in einer Anfrage senden, mit Ergebnis pro Eintrag. Ein fehlerhaftes Event blockiert nie den Rest. Prompt zur Batch-API zum Erstellen von Monitoring-Events Prompt in die Zwischenablage kopieren \

\`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.`

\
Einfügen in Siehe [Batches](https://docs.didit.me/de/transaction-monitoring/events.md#batches) im Leitfaden zur Event-Erfassung. Der Gerätekanal liefert für das Senden gepufferter SDK-Events dieselben Ergebnisse je Eintrag: siehe [Übermittlung von SDK-Events](https://docs.didit.me/de/transaction-monitoring/sdk-event-submission.md#batching). ## OpenAPI ````yaml de/openapi-25.json POST /v3/events/batch/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API für Ausweisverifizierung. Authentifizierung über den x-api-key-Header. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/events/batch/: post: tags: - Monitoring Events summary: Monitoring-Ereignisse im Batch erstellen description: >- Übermitteln Sie 1 bis 500 Ereignisse in einer Anfrage, jeweils im selben Envelope wie `POST /v3/events/`. Jedes Element wird einzeln validiert, gespeichert und ausgewertet und erhält ein eigenes Ergebnis (`accepted`, `replayed` oder `rejected`), sodass ein fehlerhaftes Ereignis niemals die anderen zurückrollt: Die Antwort ist `201`, wenn kein Element abgelehnt wurde, und `207`, wenn mindestens eines abgelehnt wurde; beides bedeutet, dass die Anfrage verarbeitet wurde. Senden Sie `{"events": [...]}`; ein einfaches JSON-Array von Ereignissen wird ebenfalls akzeptiert. Die Ereigniserfassung muss für die Anwendung aktiviert sein, andernfalls gibt die gesamte Anfrage `403` mit `code: event_monitoring_disabled` zurück und es wird nichts gespeichert. Ein berechtigter API-Schlüssel erfordert `transactions: write`. Siehe [Batches](https://docs.didit.me/de/transaction-monitoring/events#batches). 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: >- 1 bis 500 Ereignisse. Jeder Eintrag entspricht `MonitoringEventCreateRequest`, einschließlich des Fensters von 7 Tagen in der Vergangenheit und 5 Minuten in der Zukunft für `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: >- Kein Element wurde abgelehnt: Jedes Element ist `accepted` oder `replayed`. content: application/json: schema: type: object required: - accepted_count - replayed_count - rejected_count - results properties: accepted_count: type: integer minimum: 0 description: Elemente gespeichert und ausgewertet. replayed_count: type: integer minimum: 0 description: >- Elemente, die bereits mit demselben Inhalt gespeichert sind. rejected_count: type: integer minimum: 0 description: Elemente nicht gespeichert. results: type: array description: Ein Eintrag pro Element in der Reihenfolge der Anfrage. items: type: object description: >- Ergebnis eines Eintrags. Akzeptierte und wiederholte Einträge enthalten außerdem jedes Feld von `MonitoringEventIngestResult`; abgelehnte Einträge enthalten stattdessen `event_id` und `errors`. required: - index - outcome properties: index: type: integer minimum: 0 description: Position des Eintrags in Ihrem `events`-Array. outcome: type: string enum: - accepted - replayed - rejected description: >- `accepted`: gespeichert und ausgewertet. `replayed`: bereits mit demselben Inhalt gespeichert. `rejected`: nicht gespeichert; siehe `errors`. event_id: type: string nullable: true description: >- Ihre `event_id`. Bei Elementen, die durch die Validierung abgelehnt wurden, wird sie aus dem snake_case-Schlüssel `event_id` des Elements gelesen; sie ist daher null, wenn das Element sie weggelassen oder den Alias `eventId` gesendet hat. errors: type: object additionalProperties: true description: >- Nur abgelehnte Elemente. Validierungsfehler nach Feld aufgeschlüsselt, in derselben Struktur wie die `400`-Antwort von `POST /v3/events/`; eine wiederverwendete `event_id` mit abweichendem Inhalt wird als String unter `errors.event_id` gemeldet. event_uuid: type: string format: uuid description: Nur akzeptierte und erneut abgespielte Elemente. status: type: string enum: - ACCEPTED - APPROVED - IN_REVIEW - DECLINED description: Nur akzeptierte und erneut abgespielte Elemente. score: type: integer description: Nur akzeptierte und erneut abgespielte Elemente. rules_evaluated_count: type: integer description: Nur akzeptierte und erneut abgespielte Elemente. rules_matched_count: type: integer description: Nur akzeptierte und erneut abgespielte Elemente. correlation_pending: type: boolean description: Nur akzeptierte und erneut abgespielte Elemente. retention_class: type: string enum: - low_value - standard - risk_relevant - monetary_or_compliance description: Nur akzeptierte und erneut abgespielte Elemente. expires_at: type: string format: date-time nullable: true description: Nur akzeptierte und erneut abgespielte Elemente. idempotent_replay: type: boolean description: Nur akzeptierte und erneut abgespielte Elemente. rule_matches: type: array description: Nur akzeptierte und erneut abgespielte Elemente. items: type: object required: - rule_id - library_key - mode - is_async properties: rule_id: type: string format: uuid description: UUID der Regel. library_key: type: string nullable: true description: >- Bibliotheksschlüssel, wenn die Regel aus der Regelbibliothek installiert wurde, andernfalls null. mode: type: string enum: - ACTIVE - TEST description: >- `TEST`-Regeln erfassen die Übereinstimmung, wenden aber keine Aktionen an. is_async: type: boolean description: >- `true`, wenn die Übereinstimmung aus dem asynchronen Durchlauf stammt. 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: >- Mindestens ein Element wurde abgelehnt. Die anderen Elemente wurden gespeichert; korrigieren und senden Sie nur die abgelehnten erneut (das erneute Senden eines akzeptierten Elements ist sicher, es wird als `replayed` zurückgegeben). content: application/json: schema: type: object required: - accepted_count - replayed_count - rejected_count - results properties: accepted_count: type: integer minimum: 0 description: Elemente gespeichert und ausgewertet. replayed_count: type: integer minimum: 0 description: >- Elemente, die bereits mit demselben Inhalt gespeichert sind. rejected_count: type: integer minimum: 0 description: Elemente nicht gespeichert. results: type: array description: Ein Eintrag pro Element in der Reihenfolge der Anfrage. items: type: object description: >- Ergebnis eines Eintrags. Akzeptierte und wiederholte Einträge enthalten außerdem jedes Feld von `MonitoringEventIngestResult`; abgelehnte Einträge enthalten stattdessen `event_id` und `errors`. required: - index - outcome properties: index: type: integer minimum: 0 description: Position des Eintrags in Ihrem `events`-Array. outcome: type: string enum: - accepted - replayed - rejected description: >- `accepted`: gespeichert und ausgewertet. `replayed`: bereits mit demselben Inhalt gespeichert. `rejected`: nicht gespeichert; siehe `errors`. event_id: type: string nullable: true description: >- Ihre `event_id`. Bei Elementen, die durch die Validierung abgelehnt wurden, wird sie aus dem snake_case-Schlüssel `event_id` des Elements gelesen; sie ist daher null, wenn das Element sie weggelassen oder den Alias `eventId` gesendet hat. errors: type: object additionalProperties: true description: >- Nur abgelehnte Elemente. Validierungsfehler nach Feld aufgeschlüsselt, in derselben Struktur wie die `400`-Antwort von `POST /v3/events/`; eine wiederverwendete `event_id` mit abweichendem Inhalt wird als String unter `errors.event_id` gemeldet. event_uuid: type: string format: uuid description: Nur akzeptierte und erneut abgespielte Elemente. status: type: string enum: - ACCEPTED - APPROVED - IN_REVIEW - DECLINED description: Nur akzeptierte und erneut abgespielte Elemente. score: type: integer description: Nur akzeptierte und erneut abgespielte Elemente. rules_evaluated_count: type: integer description: Nur akzeptierte und erneut abgespielte Elemente. rules_matched_count: type: integer description: Nur akzeptierte und erneut abgespielte Elemente. correlation_pending: type: boolean description: Nur akzeptierte und erneut abgespielte Elemente. retention_class: type: string enum: - low_value - standard - risk_relevant - monetary_or_compliance description: Nur akzeptierte und erneut abgespielte Elemente. expires_at: type: string format: date-time nullable: true description: Nur akzeptierte und erneut abgespielte Elemente. idempotent_replay: type: boolean description: Nur akzeptierte und erneut abgespielte Elemente. rule_matches: type: array description: Nur akzeptierte und erneut abgespielte Elemente. items: type: object required: - rule_id - library_key - mode - is_async properties: rule_id: type: string format: uuid description: UUID der Regel. library_key: type: string nullable: true description: >- Bibliotheksschlüssel, wenn die Regel aus der Regelbibliothek installiert wurde, andernfalls null. mode: type: string enum: - ACTIVE - TEST description: >- `TEST`-Regeln erfassen die Übereinstimmung, wenden aber keine Aktionen an. is_async: type: boolean description: >- `true`, wenn die Übereinstimmung aus dem asynchronen Durchlauf stammt. 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: >- Der Batch selbst ist fehlerhaft: `events` fehlt, ist kein Array, ist leer oder enthält mehr als 500 Elemente. Es wird nichts gespeichert; teilen Sie große Batches auf. 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: >- Der API-Schlüssel mit eingeschränktem Geltungsbereich ist abgelaufen. Nur ein abgelaufener Schlüssel erhält `401`; ein fehlender oder ungültiger Schlüssel erhält `403`. content: application/json: examples: Expired key: value: detail: This API key has expired. '403': description: >- Ein fehlender `x-api-key` (ein falscher, widerrufener oder abgelaufener Schlüssel erhält `401`), ein berechtigungsbeschränkter Schlüssel ohne `transactions: write`, ein auf bestimmte Workflows oder genehmigte Sitzungen beschränkter Schlüssel (ein solcher Schlüssel erreicht Transaktionsüberwachungsdaten nie) oder eine Anfrage von außerhalb der IP-Allowlist des Schlüssels. Wird auch mit `code: event_monitoring_disabled` zurückgegeben, solange die Ereigniserfassung für die Anwendung deaktiviert ist; in diesem Fall wird nichts gespeichert, und die Prüfung erfolgt vor der Validierung des Bodys. 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: >- Rate-Limit überschritten: Transaktionserstellungen und Ereignis-Ingestion (`POST /v3/transactions/`, `POST /v3/events/`, `POST /v3/events/batch/`) teilen sich ein Kontingent von 600 Anfragen pro Minute pro API-Schlüssel, getrennt von den 300, die sich alle anderen Schreibanfragen teilen. Warten Sie `Retry-After` Sekunden und versuchen Sie es dann erneut. headers: Retry-After: description: >- Anzahl der Sekunden, die vor einem Wiederholungsversuch gewartet werden muss, aufgerundet, damit der Wiederholungsversuch im nächsten Zeitfenster liegt. 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: >- Der Event-Envelope, identisch für jede Kategorie. camelCase-Aliase werden akzeptiert: `eventId`, `eventCategory` (oder `category`), `actionType`, `occurredAt`, `timeZone` (oder `zoneId`), `deviceContext` (oder `device`), `transactionContext`, `customValues` (oder `props`); innerhalb von `subject`: `vendorData`, `entityType`, `fullName`; innerhalb von `session`: `sessionId`, `pageUrl`; innerhalb von `transaction_context`: `paymentReferenceId`. required: - event_id - event_category - action_type - occurred_at - subject properties: event_id: type: string maxLength: 128 description: >- Ihre Kennung für das Ereignis, eindeutig pro Anwendung. Sie ist der Idempotenzschlüssel: Das erneute Senden derselben Werte für `event_category`, `action_type`, `occurred_at`, `subject.vendor_data` und `payload` unter dieser Kennung ist eine Wiederholung, jede Abweichung ist ein Konflikt. example: login-2026-10-17-000001 event_category: type: string enum: - auth - session - gameplay - bonus - affiliate - payment - dispute - security - responsible_gambling - custom description: Ereigniskategorie. example: auth action_type: type: string minLength: 1 maxLength: 128 description: >- Was innerhalb der Kategorie passiert ist. Offenes Vokabular; die in [Ereigniserfassung](https://docs.didit.me/de/transaction-monitoring/events) aufgeführten verwalteten Aktionen (beispielsweise `login`, `deposit_completed`, `chargeback_opened`) schalten eine typisierte Validierung und verwaltete Regelfelder frei. Führende und nachfolgende Leerzeichen werden gekürzt. example: login occurred_at: type: string format: date-time description: >- Wann das Ereignis auf Ihrer Seite stattgefunden hat, ISO 8601 (ein Wert ohne Offset wird als UTC interpretiert). Darf nicht mehr als 7 Tage in der Vergangenheit und nicht mehr als 5 Minuten in der Zukunft liegen. example: '2026-10-17T09:15:02.481Z' time_zone: type: string nullable: true maxLength: 64 description: >- Zeitzone des Ereignisses auf Ihrer Seite, zum Beispiel `Europe/Madrid`. Wird mit dem Ereignis gespeichert; wird von den Lese-Endpoints nicht zurückgegeben. subject: type: object description: >- Der Benutzer oder das Unternehmen, zu dem das Ereignis gehört. Es verweist auf den Benutzer (oder das Unternehmen) mit diesen `vendor_data` in Ihrer Anwendung; falls keines vorhanden ist, wird eines erstellt. required: - vendor_data properties: vendor_data: type: string minLength: 1 maxLength: 255 description: Ihre ID für das Subjekt. example: user-42 entity_type: type: string maxLength: 32 default: individual description: >- `company` löst das Subjekt zu einem Unternehmen auf; jeder andere Wert (Standard `individual`) löst es zu einer Einzelperson auf. Dasselbe `vendor_data` kann jeweils ein Unternehmen und eine Einzelperson benennen. example: individual full_name: type: string nullable: true maxLength: 512 description: >- Anzeigename, der nur verwendet wird, wenn dieses Ereignis den Benutzer oder das Unternehmen erstellt. email: type: string format: email nullable: true description: >- Als E-Mail-Adresse validiert; wird nicht im Ereignis gespeichert. phone: type: string nullable: true maxLength: 32 description: Validiert; wird nicht im Ereignis gespeichert. country: type: string nullable: true maxLength: 3 description: Validiert; wird nicht im Ereignis gespeichert. business: type: object description: >- Das Unternehmen, zu dem das Ereignis gehört, sofern es sich vom Subjekt unterscheidet. Es wird nur `vendor_data` gelesen. additionalProperties: true properties: vendor_data: type: string maxLength: 255 description: >- Ihre ID für das Unternehmen. Filterbar als `business_vendor_data`. example: merchant-7 session: type: object description: Ihr Sitzungskontext für das Ereignis. properties: session_id: type: string nullable: true maxLength: 255 description: >- Ihre Sitzungskennung. Filterbar und als `session_id` zurückgegeben. sequence: type: integer nullable: true description: >- Position des Ereignisses innerhalb der Sitzung. Wird als `session_sequence` zurückgegeben. page_url: type: string nullable: true maxLength: 2048 description: Validiert; wird nicht im Ereignis gespeichert. referrer: type: string nullable: true maxLength: 2048 description: Validiert; wird nicht im Ereignis gespeichert. device_context: type: object additionalProperties: true description: >- Geräte- und Netzwerkkontext, wird so gespeichert, wie er gesendet wird, und von `GET /v3/events/{event_uuid}/` zurückgegeben. Auf dieser Serverstrecke sieht Didit die Verbindung des Endbenutzers nicht, daher ist die IP, die angereichert und von Regeln verwendet wird, `network_context.ip_address`, wie Sie sie übermitteln. properties: fingerprint: type: string maxLength: 255 description: Geräte-Fingerprint. Filterbar als `device_fingerprint`. persistent_device_id: type: string maxLength: 255 description: Ihre persistente Gerätekennung. bot_score: type: integer description: Bot-Score aus Ihrer eigenen Erkennung als Ganzzahl. network_context: type: object additionalProperties: true properties: ip_address: type: string maxLength: 64 description: >- Adresse des Endbenutzers. Öffentliche Adressen werden einmal pro eindeutiger Adresse angereichert. example: 203.0.113.42 transaction_context: type: object description: >- Finanzkontext. Nicht leere Werte hier erfüllen auch die erforderlichen Payload-Schlüssel der Aktion. properties: amount: type: string nullable: true description: Betrag als Dezimal-String (eine Zahl wird ebenfalls akzeptiert). example: '1000.00' currency: type: string nullable: true maxLength: 10 description: Währungscode. direction: type: string nullable: true maxLength: 16 description: >- Richtung der Geldbewegung, zum Beispiel `inbound` oder `outbound`. payment_reference_id: type: string nullable: true maxLength: 255 description: Ihre Zahlungsreferenz. Filterbar als `payment_reference_id`. payload: type: object additionalProperties: true description: >- Die Domänenfelder der Kategorie, nach der JSON-Codierung maximal 16384 Bytes groß. Einige Aktionen erfordern Schlüssel (in `payload` oder `transaction_context`): `gameplay.p2p_settlement` erfordert `game_id`, `counterparty_vendor_data`, `stake_amount`, `net_result_amount`, `role` und eines von `hand_id`, `round_id`, `match_id`; `gameplay.bet_placed` und `gameplay.bet_settled` erfordern `game_id`; `payment.deposit_initiated`, `payment.deposit_completed`, `payment.withdrawal_requested` und `payment.withdrawal_completed` erfordern `payment_reference_id`, `amount`, `currency`, `payment_method`, `status`; `payment.withdrawal_address_changed` erfordert `withdrawal_address_hash`; `dispute.chargeback_opened`, `dispute.chargeback_won` und `dispute.chargeback_lost` erfordern `payment_reference_id` und eines von `dispute_id`, `chargeback_id`; `session.bot_signal_observed` erfordert `telemetry_schema_version` und eines von `bot_score`, `actions_per_minute`, `timing_variance_ms`, `pointer_entropy`, `keystroke_entropy`, `reaction_time_ms_p50`; `responsible_gambling.self_exclusion_match` erfordert `registry_source`, `exclusion_status`, `identity_match_ref`. Jede `security`-Aktion, die auf `_changed` endet, erfordert `changed_field` sowie `previous_reference_hash` oder `new_reference_hash`, wenn das Feld `password`, `mfa_method`, `mfa`, `email`, `phone`, `withdrawal_address`, `payout_method` oder `api_key` ist. Senden Sie Hashes und Referenzen, niemals eine Kartennummer, eine vollständige Auszahlungsadresse, einen Passwort-Hash oder ein MFA-Geheimnis. custom_values: type: object description: >- Bis zu 100 eigene Schlüssel, die aus Regeln als `custom_values.` adressierbar sind. Werte müssen Skalare sein (Zeichenfolge, Zahl, boolescher Wert oder null); verschachtelte Objekte und Arrays werden abgelehnt. 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: >- Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.