Zum Hauptinhalt springen
POST
curl

Autorisierungen

x-api-key
string
header
erforderlich

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.

Body

application/json
transaction_id
string
erforderlich

Ihre eindeutige Kennung für diese Transaktion (maximal 128 Zeichen).

Beispiel:

"your-txn-2026-05-17-001"

transaction_category
enum<string>
erforderlich

Kategorie der Transaktion. CamelCase-Aliase (travelRule, userPlatformEvent, gamblingBet, …) werden ebenfalls akzeptiert; der gespeicherte/zurückgegebene Wert ist camelCase für mehrteilige Kategorien.

Verfügbare Optionen:
finance,
kyc,
travel_rule,
user_event,
audit_trail_event,
gambling_bet,
gambling_limit_change,
gambling_bonus_change,
travelRule
Beispiel:

"finance"

transaction_details
object
erforderlich

Wesentliche Finanzdaten der Transaktion.

subject
object
erforderlich

Das Subjekt (der Antragsteller) der Transaktion.

transaction_at
string<date-time>

Wann die Transaktion stattgefunden hat. Standardmäßig jetzt, falls weggelassen.

time_zone
string

IANA-Zeitzonenkennung, z. B. Europe/Madrid.

counterparty
object

Die Gegenpartei der Transaktion (optional).

custom_properties
object

Beliebige Schlüssel-Wert-Paare, die an die Transaktion angehängt sind. Jeder Schlüssel kann in Regelbedingungen mit dem Feldpfad custom_values.<key> referenziert werden.

Beispiel:
travel_rule_details
object

Travel Rule-Daten. Wenn Travel Rule aktiviert ist und transaction_category travel_rule ist, führt Didit den Austausch selbst durch: status, protocol, required und obligations_count werden ignoriert, und originator_data, beneficiary_data sowie metadata werden verwendet. Andernfalls speichert Didit diese Werte als passiven Travel Rule-Datensatz. Während Travel Rule aktiviert ist, muss ein ausgehender Transfer ab Ihrem Schwellenwert die Vorgaben des jeweiligen Regelwerks enthalten (EU TFR oder FATF-Empfehlung 16), geprüft für die von Ihnen übermittelten Seiten: Ein fehlendes Feld führt zu einer 400-Antwort unter travel_rule_details.originator_data oder travel_rule_details.beneficiary_data, beispielsweise "EU TFR requires the originator name."

network_snapshot
object

Vorberechneter Snapshot des Netzwerkgraphen.

include_crypto_screening
boolean | null

Transaktionsbezogene Überschreibung für das Krypto-Blockchain-Analyse-Screening. Wenn true, wird das Krypto-Screening unabhängig vom Standardwert der Anwendung durchgeführt. Wenn false, wird das Krypto-Screening übersprungen, selbst wenn es in den Anwendungseinstellungen aktiviert ist. Wenn weggelassen oder null, wird der in der Konsole konfigurierte Standardwert auf Anwendungsebene verwendet. Das Krypto-Screening erfordert transaction_details.direction, currency_kind: "crypto", eine Chain/Währung und die durch die Richtung ausgewählte Wallet-Adresse: Eingehendes Pre-Transfer-Screening verwendet counterparty.payment_method.account_id, eingehendes Transaktions-Hash-Screening verwendet subject.payment_method.account_id und ausgehendes Screening verwendet counterparty.payment_method.account_id. Wenn transaction_details.payment_reference_id einen Blockchain-Transaktions-Hash enthält, führt Didit ein Transaktions-Screening durch und gibt eine Transaktionszusammenfassungs-Anreicherung zurück, sofern verfügbar.

Antwort

Transaktion übermittelt und überwacht. Der Body enthält die vollständigen Transaktionsdetails (gleiche Struktur wie bei GET /v3/transactions/{transaction_id}/), die alle bereits angewendeten Regelergebnisse widerspiegeln.

Vollständiger Überwachungsdatensatz für eine Transaktion, wie von GET /v3/transactions/{transaction_id}/ und POST /v3/transactions/ zurückgegeben.

uuid
string<uuid>

Stabiler Transaktionsbezeichner von Didit. Als {transaction_id} für Folgeaufrufe verwenden.

environment
enum<string>

Umgebung der Anwendung, zu der die Transaktion gehört. Eine sandbox-Transaktion wird gespeichert, aber niemals ausgewertet, gescreent, benachrichtigt oder abgerechnet, sodass ihre leeren rule_runs „nicht ausgewertet“ bedeuten.

Verfügbare Optionen:
live,
sandbox
transaction_number
integer

Fortlaufende Transaktionsnummer innerhalb der Anwendung, wie in der Console angezeigt (z. B. 4123).

txn_id
string

Die transaction_id, die Sie bei der Erstellung angegeben haben (max. 128 Zeichen). Eindeutig pro Anwendung.

txn_date
string<date-time>

Wann die Transaktion stattgefunden hat (aus transaction_at; standardmäßig der Übermittlungszeitpunkt).

zone_id
string | null

Beim Erstellen angegebene IANA-Zeitzonenkennung.

transaction_type
string

Kategorie auf oberster Ebene wie gespeichert: finance, kyc, travelRule, userPlatformEvent, gamblingBet, gamblingLimitChange, gamblingBonusChange, auditTrailEvent. Beachten Sie, dass mehrteilige Werte in camelCase zurückgegeben werden, selbst wenn sie in snake_case übermittelt wurden.

action_type
string

Untertyp innerhalb der Kategorie (z. B. deposit, withdrawal, transfer). Standardmäßig die Kategorie, falls nicht angegeben.

direction
enum<string>

Richtung relativ zur betreffenden Entität. Wird unabhängig von der übermittelten Schreibweise in Großbuchstaben gespeichert (bei der Eingabe werden in/out/inbound/outbound akzeptiert).

Verfügbare Optionen:
INBOUND,
OUTBOUND
status
enum<string>

Aktuelles Überwachungsergebnis. Transaktionen werden als APPROVED erstellt; Regeln können sie synchron auf IN_REVIEW/DECLINED umstellen.

Verfügbare Optionen:
APPROVED,
IN_REVIEW,
DECLINED,
AWAITING_USER
source
enum<string>

Wie der Datensatz entstanden ist: LIVE für Transaktionen, die über die API oder das SDK übermittelt wurden, IMPORTED für Transaktionen, die über den Import in der Konsole geladen wurden.

Verfügbare Optionen:
LIVE,
IMPORTED
amount
string

Transaktionsbetrag als Dezimalstring ohne nachgestellte Nullen (z. B. "1500", "0.5", "0.123456789012345678"). Bis zu 18 Dezimalstellen.

currency
string

Währungscode von amount. Jeder alphabetische ISO-4217-Code wird akzeptiert (z. B. EUR, USD, NGN), ebenso wie ein Krypto-Asset-Symbol (z. B. BTC). Bevorzugen Sie einen aktuell im Umlauf befindlichen Code. Nicht jeder akzeptierte Code verfügt über einen Wechselkurs: Wenn für den Code keiner verfügbar ist (beispielsweise die ISO-Verrechnungseinheit XSU oder ein Krypto-Symbol, für das Didit keine Kurse bereitstellt), schlägt die automatische Konvertierung fehl und preferred_currency_amount wird als null zurückgegeben, es sei denn, die Anfrage enthielt einen vorkonvertierten Wert für amount_in_default_currency.

currency_type
string | null

fiat oder crypto, wie in currency_kind übermittelt.

amount_in_default_currency
string | null

Von Ihnen übermittelter, vorab umgerechneter Betrag als Dezimal-String ohne nachgestellte Nullen.

default_currency_code
string | null
preferred_currency_amount
string | null

amount umgerechnet in die bevorzugte Währung der Anwendung, sofern verfügbar.

preferred_currency_code
string | null
payment_details
string | null

Freitext-Zahlungsreferenz oder -Verwendungszweck aus der Übermittlung.

payment_txn_id
string | null

Externe Zahlungssystem-Referenz (z. B. Blockchain-Transaktions-Hash) aus payment_reference_id.

score
integer

Durch Regeln kumulierter Risiko-Score (typischerweise 0–100). Höher = riskanter.

severity
enum<string> | null

Kategorische Risikoschwere, festgelegt durch Regeln/Anbieter (UNKNOWN, LOW, MEDIUM, HIGH, CRITICAL). null, bis ein Wert festgelegt wird.

Verfügbare Optionen:
UNKNOWN,
LOW,
MEDIUM,
HIGH,
CRITICAL
decision_reason_code
string | null

Maschinenlesbarer Grund für den aktuellen status.

decision_reason_label
string | null

Lesbare Bezeichnung für decision_reason_code.

vendor_data
string | null

Bequemlichkeitskopie der vendor_data des Antragstellers.

metadata
object

Snapshot der Payloads von subject und counterparty, wie sie zum Zeitpunkt der Erstellung übermittelt wurden.

props
object

Die custom_properties, die Sie bei der Erstellung angegeben haben. Jeder Schlüssel kann in Regelbedingungen als custom_values.<key> adressiert werden.

tags
object[]

An die Transaktion angehängte Tags (manuell oder durch Regeln).

parties
object[]

Transaktionsparteien (Antragsteller, Gegenpartei).

payment_methods
object[]

Mit der Transaktion verknüpfte Zahlungsmethoden.

documents
object[]

Dateien, die der Transaktion über die Konsole angehängt wurden. [], wenn keine vorhanden sind.

activities
object[]

Einträge im Aktivitätsprotokoll (Erstellung, Notizen, manuelle Prüfungen, Statusänderungen).

alerts
object[]

Aktuell immer leer. Ein offener Alert ist eine Transaktion mit dem Status IN_REVIEW oder AWAITING_USER.

rule_runs
object[]

Ausführungsergebnisse pro Regel – welche Regel ausgelöst wurde und mit welcher Auswirkung auf den Score.

provider_results
object[]

Unverarbeitete Provider-Payloads (AML-Screening, Blockchain-Analysen usw.).

travel_rule
object | null

Travel Rule-Transfer oder -Prüfung. Wird ausgefüllt, wenn travel_rule_details übermittelt wurde, sowie wenn Travel Rule aktiviert ist und die Transaktion mit transaction_category: travelRule erstellt wurde (Didit initiiert den Austausch selbst, auch ohne travel_rule_details). null, wenn kein Transfer oder keine Prüfung existiert. Bei einem eingehenden Transfer bleiben originator_data und beneficiary_data der Gegenpartei maskiert (data_masked: true), bis die Wallet-Inhaberschaft bestätigt ist.

network_snapshot
object | null

Graph-Snapshot verknüpfter Transaktionen/Parteien, der von der Regel-Engine verwendet wird. Entweder der mit der Transaktion übermittelte network_snapshot oder der Graph, den Didit aus einem erfolgreichen AML-Wallet-Screening erstellt (der einen übermittelten ersetzt). null, wenn keines von beiden existiert.

remediation
object | null

Korrektursitzung, die dem Benutzer angeboten wird, wenn eine erneute Verifizierung erforderlich ist. Abgelöst durch action_required, den kanonischen Block; aus Gründen der Abwärtskompatibilität beibehalten.

action_required
Verification session · object

Ausstehende Endbenutzer-Aktion, die zum Abschluss dieser Transaktion erforderlich ist, oder null, wenn keine vorhanden ist. Die Didit-SDKs starten die Aktion standardmäßig automatisch und aktualisieren die Transaktion nach deren Abschluss. Zwei Varianten, unterschieden durch type: verification_session (eine gehostete Verifizierungssitzung, die durch eine Regelaktion erstellt wurde) und wallet_ownership (eine Sitzung des Wallet-Ownership-Widgets, die für einen Travel-Rule-Transfer automatisch erstellt wurde, der einen Nachweis der Wallet-Kontrolle benötigt, gesteuert durch die Travel-Rule-Einstellung auto_wallet_verification). Wenn beide zutreffen könnten, hat wallet_ownership Vorrang, da sie den Travel-Rule-Austausch blockiert.

cost_breakdown
object | null

Kosten dieser Transaktion: total_price und items, eine pro Belastung, jeweils mit usage_type, price, details und created_at. Eine erneute Überprüfung derselben Transaktion ist ein neues Element.

Zuletzt geändert am 7. November 2026