Zum Hauptinhalt springen
POST
curl
Didit stellt über die Travel-Rule-API für Endbenutzer-Links einen Link bereit, mit dem der Endbenutzer seine Wallet- oder Gegenpartei-Auswahl abschließen kann. Der Link kann an die hinterlegte E-Mail-Adresse gesendet werden. Senden Sie {"channel": "link"}, um einen Link zu kopieren, oder {"channel": "email"}, um zusätzlich einen E-Mail-Versand zu versuchen. Wenn Sie channel weglassen, ist der Standardwert link. Für den E-Mail-Versand werden die im Didit-Datensatz des Endbenutzers hinterlegte Adresse und, sofern verfügbar, die Sprache der Verifizierungssitzung verwendet. Sie können keinen beliebigen Empfänger angeben. Die API erfordert Schreibzugriff auf Transaktionen sowie einen ausgehenden Transfer im Status AWAITING_COUNTERPARTY, COUNTERPARTY_VASP_NOT_FOUND, COUNTERPARTY_VASP_NOT_REACHABLE, UNCONFIRMED_OWNERSHIP oder ON_HOLD. Bei anderen Status gibt die API 409 zurück. Eine unbekannte Transaktion oder ein fehlender Transfer führt zu 404. Die Antwort enthält end_user_link, expires_at, emailed_to und email_available. Ein neuer Link widerruft alle zuvor erstellten, noch offenen Endbenutzer-Links für diesen Transfer. Geben Sie den Link nur an den vorgesehenen Endbenutzer weiter. Wenn keine hinterlegte E-Mail-Adresse vorhanden ist, gibt channel: email den Fehler 409 mit code: end_user_email_missing zurück. Verwenden Sie in diesem Fall stattdessen channel: link. Schlägt der Versand fehl, gibt die API trotzdem einen verwendbaren Link zurück, und emailed_to ist leer. email_available bedeutet, dass eine Adresse vorhanden ist, nicht dass die Zustellung erfolgreich war. Zur ausdrücklichen Auswahl des Benutzers bei der Erstellung finden Sie Informationen unter Transaktion erstellen und im Travel-Rule-Leitfaden. Zu Transfer-Aktionen finden Sie Informationen unter Transfer aktualisieren.

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.

Pfadparameter

transaction_id
string<uuid>
erforderlich

Stabile Transaktions-UUID von Didit, zu der der Transfer gehört.

Body

application/json
channel
enum<string>
Standard:link

link gibt einen neuen Link zurück; email versucht außerdem, ihn an die E-Mail-Adresse des Endbenutzers im Didit-Datensatz zu senden.

Verfügbare Optionen:
link,
email

Antwort

Erfolgreiche Antwort.

Neuer Link für Endbenutzer. Bisherige offene Links für diese Transaktion werden widerrufen.

expires_at
string<date-time>
erforderlich

Ablaufdatum des Links.

emailed_to
string
erforderlich

Empfänger, wenn der Versand erfolgreich war, andernfalls eine leere Zeichenfolge. Ein Fehler beim E-Mail-Versand liefert trotzdem einen verwendbaren Link.

email_available
boolean
erforderlich

Ob der Endbenutzer eine E-Mail-Adresse in seinem Didit-Datensatz hat.

Zuletzt geändert am 12. November 2026