Zum Hauptinhalt springen
POST
curl

Autorisierungen

X-Transaction-Token
string
header
erforderlich

Kurzlebiger berechtigungseingeschränkter Token, der von Ihrem Backend über POST /v3/transactions/sdk-token/ generiert wird. Wird von den Didit-SDKs auf den geräteseitigen /v1/transactions/-Endpoints verwendet.

Body

application/json
txnId
string
erforderlich

Ihre eindeutige Kennung für diese Transaktion (wird auf transaction_id gemappt, maximal 128 Zeichen).

Beispiel:

"wd-2026-07-07-0042"

type
string
erforderlich

Transaktionskategorie (wird auf transaction_category abgebildet), z. B. finance, kyc, travelRule, userPlatformEvent, gamblingBet.

Beispiel:

"travelRule"

info
object
erforderlich

Wesentliche Finanzdaten der Transaktion (wird auf transaction_details abgebildet).

subject
object
erforderlich

Das Subjekt (der Antragsteller) der Transaktion. externalUserId wird hier ignoriert: Die Identität des Subjekts wird immer anhand der vendor_data des Tokens erzwungen.

txnDate
string<date-time>

Wann die Transaktion stattgefunden hat (entspricht transaction_at). Standardmäßig jetzt, falls weggelassen.

zoneId
string

IANA-Zeitzonenkennung (wird auf time_zone gemappt), z. B. Europe/Madrid.

counterparty
object

Die Gegenpartei der Transaktion (optional). Dieselbe Struktur wie subject; externalUserId ist hier von Bedeutung.

props
object

Benutzerdefinierte Schlüssel-Wert-Paare (werden custom_properties zugeordnet). Jeder Schlüssel kann in Regelbedingungen als custom_values.<key> referenziert werden.

travelRule
object

Travel Rule-Details (wird travel_rule_details zugeordnet). Wenn Travel Rule für die Anwendung aktiviert ist, ignoriert Didit jeden von Ihnen gesendeten status und führt den Austausch selbst durch.

includeCryptoScreening
boolean | null

Transaktionsbezogene Überschreibung für das Krypto-Blockchain-Analyse-Screening (entspricht include_crypto_screening).

fingerprint_v2
object

Die didit-fp-v2-Gerätefingerabdruck-Payload. Wird von den SDKs automatisch eingefügt; nur relevant, wenn die Wire-API direkt aufgerufen wird.

Antwort

Transaktion übermittelt und überwacht. Gleiche Detailstruktur wie bei GET /v3/transactions/{transaction_id}/, einschließlich des Blocks action_required, wenn der Endbenutzer eine Folgeaktion ausführen muss (die SDKs starten diese standardmäßig automatisch).

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