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
chain
string
erforderlich

Chain, auf der die Einzahlung abgewickelt wurde, zum Beispiel ETH. Wird in Kleinbuchstaben gespeichert und ohne Berücksichtigung von Groß-/Kleinschreibung mit den Einträgen Ihres Wallet-Adressbuchs verglichen; verwenden Sie dort denselben Chain-Token.

Maximum string length: 32
txid
string
erforderlich

On-Chain-Transaktions-Hash. Zusammen mit wallet_address dedupliziert.

Maximum string length: 128
wallet_address
string
erforderlich

Die Ziel-Wallet, auf der Sie die Einzahlung erhalten haben. Eine XRP-X-Adresse wird in ihre klassische Adresse und ihr Tag aufgeteilt.

Maximum string length: 128
amount
string
erforderlich

Einzahlungsbetrag als Dezimalstring, null oder größer, mit bis zu 18 Nachkommastellen.

currency
string
erforderlich

Einzahlungs-Asset, z. B. „USDC“.

Maximum string length: 16
originator_data
object

Details zum Auftraggeber vom sendenden VASP, falls bekannt, als flaches Objekt wie {"name": "..."}. Didit liest daraus name (oder full_name), first_name, last_name und vendor_data.

beneficiary_data
object

Angaben zum Begünstigten (Ihr Kunde) als flaches Objekt wie {"name": "..."}. Didit gleicht den Namen mit dem holder_name des passenden Adressbucheintrags ab und setzt wallet_address sowie chain aus der Anfrage.

originating_vasp
object

Optionale Beschreibung des sendenden VASP. Sie verbleibt nur bei diesem Transfer (metadata.originating_vasp und der Auftraggeber-VASP des Transfers in GET /v3/travel-rule/transfers/); sie erstellt, bearbeitet oder verknüpft niemals einen gemeinsamen VASP-Verzeichniseintrag.

memo
string

Optional. Das Destination-Tag oder Memo der Einzahlung in einem Memo-Netzwerk: Bei einer geteilten Einzahlungsadresse dient es dazu, Ihre Kunden voneinander zu unterscheiden, und der Adressbucheintrag für dieses Memo wird abgeglichen. XRP: ein Destination-Tag, eine Ganzzahl von 0 bis 4294967295 (eine JSON-Zahl wird akzeptiert). XLM: ein Text-Memo von bis zu 28 Bytes, eine 64-Bit-ID oder ein 32-Byte-Hash in Hex. EOS: bis zu 256 Bytes. ATOM: bis zu 256 Zeichen. HBAR: bis zu 100 Bytes. Bitcoin-, EVM-, Solana-, Tron-, Litecoin-, Bitcoin Cash-, Dogecoin- und Lightning-Wallets unterstützen kein Memo: die Angabe eines Memos führt dort zu 400. Alias: destinationTag oder destination_tag.

Maximum string length: 256
utxo
object

Optional, nur UTXO-Chains. Die Inputs und Outputs der Einzahlungstransaktion: Die Wallet des Senders ist die deklarierte originator_data.wallet_address, andernfalls der größte Input.

Antwort

Ein Transfer für diese txid und wallet_address war bereits registriert; der bestehende wird unverändert zurückgegeben (created ist false).

transaction_id
string<uuid>

Didit-Transaktions-UUID für die eingehende Einzahlung.

txn_id
string

txn_id der eingehenden Transaktion: Von Didit generiert, wenn Didit die Transaktion erstellt hat, oder Ihre eigene, wenn eine nicht beanspruchte Einzahlung wiederverwendet wurde.

created
boolean

true, wenn dieser Aufruf den Transfer registriert hat (HTTP 201); false, wenn bereits ein Transfer für dieselbe txid und wallet_address existierte (HTTP 200).

travel_rule
object

Vollständiges Transfer-Objekt, das von den Endpoints zur Eigentümerbestätigung und zum Abschließen/Abbrechen zurückgegeben wird. Solange das Wallet-Eigentum eines eingehenden Transfers unbestätigt ist, werden originator_data und beneficiary_data der Gegenpartei maskiert zurückgegeben (der erste Buchstabe jedes Wortes bleibt erhalten; Wallet, Chain und VASP-Routing bleiben lesbar) und data_masked ist true.

Zuletzt geändert am 7. November 2026