Transaktionsrisiko-Scoring: Formel & Schwellenwerte

Jede Transaktion erhält einen Score, eine Ganzzahl, die ihr Risiko zusammenfasst. Der Score bestimmt den Status der Transaktion (APPROVED, IN_REVIEW, DECLINED) und ob ein Alert erstellt, ein Fall eröffnet oder eine Korrektur durch den Benutzer verlangt wird.

Die Formel

score = Σ(score_delta of every matched rule)

Basiswert: 0.
Jede zutreffende Regel trägt ihren konfigurierten score_delta bei (typischerweise 25–35).
Eine Transaktion ohne zutreffende Regeln erhält einen Score von 0.

Schwellenwerte und Status

Die Score-Schwellenwerte werden pro Anwendung unter Transactions → Settings konfiguriert.

Einstellung	Standard	Bedeutung
`preferred_review_score_threshold`	75	Scores ab diesem Wert gehen in `IN_REVIEW`
`preferred_decline_score_threshold`	500	Scores ab diesem Wert gehen in `DECLINED`. Der Standard- und Maximalwert (`500`) bedeutet „nie nach Score ablehnen“. Senken Sie ihn, um nach Score abzulehnen.

Statuszuweisung:

if decline_threshold < 500 and score >= decline_threshold: status = DECLINED
else if score >= review_threshold: status = IN_REVIEW
else: status = APPROVED

Einzelne Regelaktionen können dies überschreiben, z. B. lehnt eine Regel mit action: change_status → DECLINED die Transaktion unabhängig vom Score ab.

Regelbeiträge: Beispiel

Angenommen, für eine einzelne Transaktion greifen diese Regeln:

Regel	`score_delta`
Hochwertige ausgehende Transaktion (>$10,000)	30
Gegenpartei in einer Hochrisikojurisdiktion	35
Strukturierungsmuster erkannt	35

Gesamt-Score = 30 + 35 + 35 = 100. Bei einer Prüfschwelle von 60 und einer Ablehnungs-Schwelle von 85 wird diese Transaktion DECLINED. Mit den Standardwerten (75 für die Prüfung, 500 für die Ablehnung) wird sie IN_REVIEW, weil der Standardwert nie nach Score ablehnt.

Überschreibungen durch Aktionen

Regeln können den Status auch direkt setzen und dabei Score-Schwellenwerte umgehen:

Regelaktion	Wirkung
`change_status → DECLINED`	Transaktion unabhängig vom Score abgelehnt
`change_status → IN_REVIEW`	Transaktion geht unabhängig vom Score in die Prüfung
`change_status → AWAITING_USER`	Transaktion wartet auf die Korrektur durch den Benutzer. Es gilt der Workflow der Regelaktion; Bibliotheksregeln greifen auf Ihre Einstellungsauswahl zurück, dann auf Ihren Workflow für biometrische Authentifizierung (gespeichertes Gesicht erforderlich), dann auf Ihren Standard-Workflow.
`add_score(n)`	Trägt nur zum Score bei; kein erzwungener Status
`add_tags([...])`	Fügt Tags für die Filterung in der Konsole hinzu; keine Auswirkung auf den Score
`add_to_list(...)`	Fügt einen Identifier einer Sperrliste hinzu

Eine einzelne Regel kann mehrere Aktionen haben, z. B. add_score(35) + add_tags(["structuring"]) + add_note("Auto-tagged by structuring preset").

Warum Scores harten Regeln überlegen sind

Ein reiner Schwellenwert (z. B. „jede Transaktion über $100k ablehnen“) erfasst sowohl legitime hochwertige Transaktionen als auch tatsächliche Risiken. Wenn Sie mehrere moderate score_delta-Regeln mit einer Prüf- und einer Ablehnungsschwelle kombinieren, erhalten Sie:

Mehrstufige Bewertung: Keine einzelne Regel führt zu einer Ablehnung; mehrere Signale müssen übereinstimmen.
Anpassbare Empfindlichkeit: Sie können Schwellenwerte anheben oder senken, ohne die Regeldefinitionen zu ändern.
Abstufung des Schweregrads: Eine Transaktion mit Score 65 geht in die Prüfung (lohnt einen Blick), Score 90 führt zur Ablehnung (schwerwiegend).

Schwellenwerte konfigurieren

Unter Transactions → Settings:

Prüfschwelle: Erhöhen Sie sie, wenn Ihre Prüfwarteschlange überlaufen ist. Senken Sie sie, um mehr Grenzfälle zu erfassen.
Ablehnungs-Schwelle: Erhöhen Sie sie, um Ablehnungen bei falsch positiven Ergebnissen zu reduzieren. Senken Sie sie, um aggressiver zu blockieren. Setzen Sie sie auf den Maximalwert (500), um hohe Scores in die Prüfung statt in eine automatische Ablehnung zu leiten.

Änderungen gelten nur für neue Transaktionen. Historische Transaktionen behalten ihren zum Zeitpunkt der Bewertung ermittelten Status.

Testmodus für Regeln

Regeln können im TEST-Modus laufen:

Die Regel bewertet Transaktionen, trägt aber weder zum Score noch zum Status bei.
Es werden TransactionRuleRun-Datensätze mit is_test = true erstellt.
Sie können so die Trennschärfe einer Regel prüfen, ohne Ablehnungen im Produktivbetrieb zu riskieren.

Wechseln Sie in den Modus ACTIVE, sobald Sie mit der Trennschärfe zufrieden sind.

Schweregrad und veraltete Felder

Das Feld severity bei Transaction und TransactionAlert ist nullfähig und veraltet. Neue Regelauswertungen setzen es nicht. Verwenden Sie score als primäres Risikosignal.

Scores prüfen

Über die API

Jede Antwort zu einer Transaktion enthält score und ein Array rule_runs[] mit einem Eintrag pro zutreffender Regel (alle Felder finden Sie im Antwortschema):

{
  "txn_id": "tx-0002",
  "status": "IN_REVIEW",
  "score": 65,
  "rule_runs": [
    {
      "rule_title": "High-value outbound",
      "matched": true,
      "score_delta": 30,
      "severity": null,
      "status_target": null,
      "action_summary": "score +30"
    },
    {
      "rule_title": "High-risk jurisdiction counterparty",
      "matched": true,
      "score_delta": 35,
      "severity": "HIGH",
      "status_target": "IN_REVIEW",
      "action_summary": "score +35; add_tag:high_risk_country"
    }
  ]
}

In der Konsole

Auf der Detailseite der Transaktion zeigt der Tab Score die Aufschlüsselung des Beitrags jeder zutreffenden Regel sowie die resultierende Statuszuordnung. Fahren Sie mit der Maus über das Score-Badge, um die bei der Bewertung verwendeten Schwellenwerte anzuzeigen.

Nächste Schritte

Regeln

Aufbau und Auswertung von Regeln.

Alerts

Was passiert, wenn eine Regel greift.

Einstellungen

Schwellenwerte konfigurieren.

Erste Schritte

Funktionen

Referenz

Konsole

Transaktionsrisiko-Scoring: Formel & Schwellenwerte

Die Formel

Schwellenwerte und Status

Regelbeiträge: Beispiel

Überschreibungen durch Aktionen

Warum Scores harten Regeln überlegen sind

Schwellenwerte konfigurieren

Testmodus für Regeln

Schweregrad und veraltete Felder

Scores prüfen

Über die API

In der Konsole

Nächste Schritte

Regeln

Alerts

Einstellungen

​Die Formel

​Schwellenwerte und Status

​Regelbeiträge: Beispiel

​Überschreibungen durch Aktionen

​Warum Scores harten Regeln überlegen sind

​Schwellenwerte konfigurieren

​Testmodus für Regeln

​Schweregrad und veraltete Felder

​Scores prüfen

​Über die API

​In der Konsole

​Nächste Schritte

Regeln

Alerts

Einstellungen

Die Formel

Schwellenwerte und Status

Regelbeiträge: Beispiel

Überschreibungen durch Aktionen

Warum Scores harten Regeln überlegen sind

Schwellenwerte konfigurieren

Testmodus für Regeln

Schweregrad und veraltete Felder

Scores prüfen

Über die API

In der Konsole

Nächste Schritte