Wallet-Eigentumsnachweis (Travel Rule) – Didit Widget

​

Wann Didit die Sitzung für Sie erstellt

• Die Transaktion befindet sich im Status UNCONFIRMED_OWNERSHIP, weil die Gegenpartei-Wallet bei der Einreichung als selbstverwahrt deklariert wurde.
• Die Transaktion ist ausgehend und befindet sich im Status COUNTERPARTY_VASP_NOT_FOUND. Es konnte kein VASP der Gegenpartei ermittelt werden, daher ist der Eigentumsnachweis der verbleibende Weg zum Abschluss.

​

Was es belegt

​

Vertragsprüfung bei Nachrichtensignierung

​

Vertragsprüfung beim Satoshi-Test

​

Ablauf

​

Widget-Sitzung erstellen

curl -X POST https://verification.didit.me/v3/travel-rule/widget-session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_address": "0xd3b62acb76fb27a7f8961ec40fa11746b113aca9",
    "chain": "ETH",
    "holder_name": "Jane Doe",
    "vendor_data": "user-042",
    "transaction_id": "99999999-aaaa-bbbb-cccc-dddddddddddd",
    "satoshi_deposit_address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
    "callback_url": "https://yourapp.example/wallet-verified",
    "expires_in_minutes": 60
  }'

{
  "widget_session_id": "77777777-8888-9999-aaaa-bbbbbbbbbbbb",
  "token": "3s9x...urlsafe",
  "url": "https://verify.didit.me/wallet-ownership/3s9x...urlsafe",
  "expires_at": "2026-07-07T13:00:00Z"
}

​

Die zurückgegebene URL öffnen

​

Abschluss erkennen

curl https://verification.didit.me/v3/travel-rule/widget/{token}/

{
  "vasp_name": "Origin CASP SL",
  "wallet_address": "0xd3b62acb76fb27a7f8961ec40fa11746b113aca9",
  "chain": "ETH",
  "holder_name": "Jane Doe",
  "allowed_methods": ["MESSAGE_SIGNING", "SCREENSHOT", "SATOSHI_TEST", "SELF_DECLARATION"],
  "transfer_status": "UNCONFIRMED_OWNERSHIP",
  "callback_url": "https://yourapp.example/wallet-verified",
  "expires_at": "2026-07-07T13:00:00Z",
  "completed_at": null,
  "proofs": [
    {
      "proof_id": "88888888-9999-aaaa-bbbb-cccccccccccc",
      "method": "SATOSHI_TEST",
      "status": "PENDING",
      "wallet_address": "0xd3b62acb76fb27a7f8961ec40fa11746b113aca9",
      "chain": "ETH",
      "deposit_address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
      "expected_amount": "0.000042817305521963",
      "expires_at": "2026-07-07T13:05:00.412731+00:00",
      "created_at": "2026-07-06T13:05:00.412731Z"
    }
  ],
  "customization": null
}

• completed_at ist nicht mehr null, sobald ein Nachweis verifiziert wurde.
• Jeder Eintrag in proofs enthält die Felder, die seine Methode benötigt: Ein SATOSHI_TEST-Nachweis ergänzt deposit_address, expected_amount und sein eigenes expires_at. Ein MESSAGE_SIGNING-Nachweis ergänzt challenge, die Zeichenfolge, die der Kunde signiert.
• Ein SATOSHI_TEST-Nachweis kann den Status status: "PENDING" haben, während seine Einzahlung On-Chain erkannt, aber noch nicht bestätigt ist. Dafür müssen weder Sie noch der Kunde etwas tun. Siehe oben den Verifizierungsvertrag für den Satoshi-Test.
• Wurde die Sitzung mit einer transaction_id erstellt, schreitet die verknüpfte Transaktion voran, sobald der Nachweis verifiziert ist. In einer Live-Anwendung wird außerdem der Webhook travel_rule.status.updated ausgelöst. Bevorzugen Sie den Webhook gegenüber Polling. Eine eingehende TRP-Anfrage wird genehmigt und an den Absender zurückgesendet und wechselt zu COMPLETED, sobald diese Freigabe zugestellt ist. Jede andere Transaktion in UNCONFIRMED_OWNERSHIP (oder eine eingehende Transaktion in ON_HOLD) wechselt zu COMPLETED. Stimmt der Name des Begünstigten nicht mit dem Wallet-Inhaber überein, wechselt sie stattdessen zu COUNTERPARTY_MISMATCHED_DATA. Eine abgewickelte Sunrise-Einzahlung, die abgeschlossen wird, wechselt zu FINISHED. Eine ausgehende Transaktion in COUNTERPARTY_VASP_NOT_FOUND wechselt zu COMPLETED.
• Ein SCREENSHOT-Nachweis behält in diesem Kontext den Status status: "PENDING", auch nachdem Sie den Besitz bestätigt haben. Sie genehmigen ihn mit POST .../travel-rule/ownership/. Dieser Endpoint akzeptiert nur eine Transaktion, die auf die Bestätigung des Besitzes wartet. Ein Screenshot hat daher keinen Genehmigungsweg in einer Sitzung ohne verknüpfte Transaktion oder in einer Sitzung mit einer ausgehenden Transaktion in COUNTERPARTY_VASP_NOT_FOUND. Deaktivieren Sie allow_screenshot_proof, wenn solche Sitzungen diesen Nachweistyp nicht anbieten dürfen.
• Nach einem abgelehnten Nachweis erhält die Sitzung einen neuen Versuch, solange noch Versuche übrig sind. max_attempts, attempts_used und attempts_remaining geben die Anzahl an. Ein abgelehnter Nachweis enthält rejection_reason. Ist attempts_remaining gleich 0, liefert der Start eines weiteren Nachweises die Antwort 409, und Sie erstellen eine neue Sitzung.
• Der Kontext-Endpoint liefert 404 für ein unbekanntes Token und 410, sobald die Sitzung abgelaufen ist, ohne abgeschlossen worden zu sein.

​

Lokalisierung und Branding

​

Nächste Schritte