> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.
# Screenshot-Wallet-Nachweis genehmigen oder ablehnen (API)
> Genehmigen oder ablehnen Sie in Didit Screenshot-Wallet-Nachweise. Genehmigung verifiziert die Wallet und ordnet sie der Transaktion zu.
API-Prompt zur Entscheidung über den Wallet-Nachweis
Prompt in die Zwischenablage kopieren
\`Approve or reject a screenshot wallet-ownership proof from my review queue.
Endpoint:
POST [https://verification.didit.me/v3/travel-rule/wallet-proofs/\{proof\_uuid}/decision/](https://verification.didit.me/v3/travel-rule/wallet-proofs/\{proof_uuid}/decision/)
Authentication:
Use the x-api-key header with my Didit API key.
Body:
* decision - "approve" or "reject".
* note - optional, up to 512 characters, kept with the proof and returned as review\_note.
Behavior:
* approve verifies the proof and the wallet address book entry, and applies the ownership to the transfer the widget session was minted for, exactly as a verified signature does.
* A screenshot never confirms a transfer another Didit customer sent over the INTERNAL rail: that needs a signed message or a test deposit.
* reject closes the proof as REJECTED with failure\_reason REVIEW\_REJECTED. It uses one of the widget session's attempts; the end user can start a new proof from the widget while attempts remain. Your note is never shown to the end user.
* Returns the decided proof, in the same shape as the review queue.
Failure modes:
* 404 - no submitted screenshot proof with this id in my application.
* 409 - already decided (the body carries its status), or code OWNERSHIP\_CHANGED when the wallet's holder changed or the wallet was deleted after the widget session was minted; ask the current holder for a new proof.
* 400 - invalid decision or a note that is too long.
* 401 - missing or malformed x-api-key.
Full guide: /transaction-monitoring/wallet-ownership-widget#what-it-proves.\`
Einfügen in
## OpenAPI
````yaml de/openapi-25.json POST /v3/travel-rule/wallet-proofs/{proof_uuid}/decision/
openapi: 3.0.0
info:
version: 3.0.0
title: Didit Verification API
description: API für Ausweisverifizierung. Authentifizierung über den x-api-key-Header.
servers:
- url: https://verification.didit.me
security: []
tags: []
paths:
/v3/travel-rule/wallet-proofs/{proof_uuid}/decision/:
post:
tags:
- Travel Rule
summary: Einen Screenshot-Wallet-Nachweis genehmigen oder ablehnen
description: >-
Entscheiden Sie über einen Screenshot-Nachweis aus Ihrer
Prüfwarteschlange. approve verifiziert den Nachweis sowie den
Adressbucheintrag und wendet die Eigentümerstruktur auf den Transfer an,
für den die Widget-Sitzung erstellt wurde, genau wie eine verifizierte
Signatur. Ein Screenshot bestätigt niemals einen Transfer, den ein
anderer Didit-Kunde über die INTERNAL-Schiene gesendet hat: Dies
erfordert eine signierte Nachricht oder eine Testeinzahlung. reject
schließt den Nachweis als REJECTED mit dem failure_reason
REVIEW_REJECTED ab; der Endbenutzer kann einen neuen Nachweis über das
Widget starten. Die Notiz verbleibt beim Nachweis.
operationId: decideTravelRuleWalletProof
parameters:
- name: proof_uuid
in: path
required: true
description: proof_id aus der Prüfungs-Warteschlange.
schema:
type: string
format: uuid
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/TravelRuleWalletProofDecision'
example:
decision: approve
note: Address matches the wallet app.
responses:
'200':
description: Der festgelegte Nachweis.
content:
application/json:
schema:
$ref: '#/components/schemas/TravelRuleWalletProofReview'
'400':
description: >-
Ungültige Entscheidung oder eine Notiz, die länger als 512 Zeichen
ist.
'401':
description: Fehlender oder ungültiger x-api-key.
'403':
description: Dem Aufrufer fehlt die Berechtigung für Transaktionen.
'404':
description: >-
Kein übermittelter Screenshot-Nachweis mit dieser ID in Ihrer
Anwendung.
'409':
description: >-
Über den Nachweis wurde bereits entschieden (der Body enthält seinen
Status) oder Code OWNERSHIP_CHANGED: Der Inhaber der Wallet hat sich
geändert oder die Wallet wurde nach dem Erstellen der Widget-Sitzung
gelöscht, sodass der Nachweis geschlossen ist und der aktuelle
Inhaber einen neuen benötigt.
content:
application/json:
schema:
$ref: '#/components/schemas/TravelRuleWidgetProofError'
security:
- ApiKeyAuth: []
x-codeSamples:
- lang: curl
label: curl
source: >-
curl -X POST
https://verification.didit.me/v3/travel-rule/wallet-proofs/{proof_uuid}/decision/
\
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"decision": "approve", "note": "Address matches the wallet app."}'
- lang: python
label: Python
source: |-
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.travel_rule.wallet_proofs.decide(
"11111111-2222-3333-4444-555555555555",
decision="approve",
note="Address matches the wallet app.",
)
print(result)
- lang: javascript
label: Node.js
source: >-
import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await
didit.travelRule.walletProofs.decide("11111111-2222-3333-4444-555555555555",
{
decision: "approve",
note: "Address matches the wallet app.",
});
console.log(result);
- lang: java
label: Java
source: >-
import me.didit.Didit;
import me.didit.types.TravelRuleWalletProofDecision;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result =
client.travelRule().walletProofs().decide("11111111-2222-3333-4444-555555555555",
TravelRuleWalletProofDecision.builder()
.decision(TravelRuleWalletProofDecision.Decision.of("approve"))
.note("Address matches the wallet app.")
.build());
System.out.println(result);
- lang: php
label: PHP
source: >-
travelRule->walletProofs->decide('11111111-2222-3333-4444-555555555555',
[
'decision' => 'approve',
'note' => 'Address matches the wallet app.',
]);
print_r($result->toArray());
- lang: ruby
label: Ruby
source: |-
require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.travel_rule.wallet_proofs.decide(
"11111111-2222-3333-4444-555555555555",
decision: "approve",
note: "Address matches the wallet app."
)
puts result.to_h
- lang: csharp
label: .NET
source: >-
using System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await
client.TravelRule.WalletProofs.DecideAsync("11111111-2222-3333-4444-555555555555",
new TravelRuleWalletProofDecision
{
Decision = "approve",
Note = "Address matches the wallet app.",
});
Console.WriteLine(JsonSerializer.Serialize(result));
components:
schemas:
TravelRuleWalletProofDecision:
type: object
required:
- decision
properties:
decision:
type: string
enum:
- approve
- reject
note:
type: string
maxLength: 512
description: >-
Optional. Wird zusammen mit dem Nachweis gespeichert und als
review_note zurückgegeben.
TravelRuleWalletProofReview:
type: object
properties:
proof_id:
type: string
format: uuid
method:
type: string
enum:
- SCREENSHOT
status:
type: string
enum:
- PENDING
- VERIFIED
- REJECTED
- EXPIRED
wallet_address:
type: string
chain:
type: string
description: Kanonischer Chain-Identifikator, z. B. ETH, BTC, SOL, TRX.
holder_name:
type: string
is_ownership_verified:
type: boolean
description: >-
Gibt an, ob die Inhaberschaft des Adressbucheintrags verifiziert
ist, durch diesen oder einen anderen Nachweis.
transaction_id:
type: string
format: uuid
nullable: true
description: >-
Die Transaktion, für deren Travel-Rule-Transfer die Widget-Sitzung
erstellt wurde. Null für eine Sitzung, die ohne transaction_id
erstellt wurde.
file_name:
type: string
nullable: true
content_type:
type: string
nullable: true
screenshot_url:
type: string
nullable: true
description: >-
Zeitlich begrenzter Link zum hochgeladenen Screenshot. Rufen Sie die
Warteschlange erneut ab, um einen neuen Link zu erhalten.
attempts:
type: integer
description: >-
Wie viele Dateien der Endbenutzer für diesen Nachweis hochgeladen
hat.
failure_reason:
allOf:
- $ref: '#/components/schemas/TravelRuleWalletProofFailureReason'
description: >-
REVIEW_REJECTED nach einer Ablehnung, OWNERSHIP_CHANGED, wenn die
Wallet vor einer Entscheidung den Inhaber gewechselt hat oder
gelöscht wurde. Andernfalls leer.
method_chosen_at:
type: string
format: date-time
nullable: true
description: Wann der Endbenutzer die Screenshot-Methode ausgewählt hat.
decided_at:
type: string
format: date-time
nullable: true
decided_by:
type: string
description: >-
Wer den Nachweis geschlossen hat: review: für einen
Prüfer in der Konsole, review für eine Entscheidung per
API-Schlüssel, widget oder sweeper, wenn Didit ihn automatisch
geschlossen hat. Leer, solange PENDING.
review_note:
type: string
description: >-
Die mit der Entscheidung gesendete Notiz. Leer, wenn keine vorhanden
ist.
created_at:
type: string
format: date-time
TravelRuleWidgetProofError:
type: object
properties:
detail:
type: string
description: Lesbare Nachricht auf Englisch.
code:
allOf:
- $ref: '#/components/schemas/TravelRuleWalletProofFailureReason'
description: >-
Maschinenlesbarer Grund, damit ein Client seine eigene übersetzte
Nachricht anzeigen kann.
status:
type: string
enum:
- PENDING
- VERIFIED
- REJECTED
- EXPIRED
description: >-
Vorhanden, wenn der Nachweis abgeschlossen ist: REJECTED durch die
gerade übermittelte Einzahlung (400), oder REJECTED bzw. EXPIRED,
wenn Nachweise an einen bereits geschlossenen Nachweis gesendet
werden (409).
proof_id:
type: string
format: uuid
description: 'Vorhanden bei Status: der geschlossene Nachweis.'
method:
type: string
enum:
- MESSAGE_SIGNING
- SATOSHI_TEST
- SCREENSHOT
- SELF_DECLARATION
description: 'Vorhanden bei Status: Methode des geschlossenen Nachweises.'
max_attempts:
type: integer
description: >-
Vorhanden bei Status: abgelehnte Wallet-Nachweise, die diese Sitzung
zulässt.
attempts_used:
type: integer
description: 'Vorhanden bei Status: bisher abgelehnte Nachweise.'
attempts_remaining:
type: integer
description: >-
Vorhanden bei Status: Wenn der Wert 0 ist, führt das Starten eines
weiteren Nachweises zu einer 409-Antwort und Sie erstellen eine neue
Widget-Sitzung.
TravelRuleWalletProofFailureReason:
type: string
enum:
- ''
- SIGNATURE_INVALID
- SIGNATURE_UNSUPPORTED_SCHEME
- DEPOSIT_NOT_FOUND
- DEPOSIT_UNCONFIRMED
- DEPOSIT_LOOKUP_FAILED
- DEPOSIT_MISMATCH
- DEPOSIT_STALE
- TXID_REUSED
- CHAIN_UNSUPPORTED
- WINDOW_EXPIRED
- OWNERSHIP_CHANGED
- METHOD_SWITCHED
- REVIEW_REJECTED
- ABANDONED
description: >-
Warum ein Wallet-Eigentumsnachweis oder dessen letzter Versuch VERIFIED
verfehlt hat. Leer, wenn kein Fehler aufgetreten ist. Ein
PENDING-Nachweis kann einen Grund enthalten: Der letzte Versuch ist
fehlgeschlagen und der Endbenutzer kann es erneut versuchen.
DEPOSIT_MISMATCH, DEPOSIT_STALE, TXID_REUSED und REVIEW_REJECTED
schließen den Nachweis als REJECTED ab. SIGNATURE_INVALID: Die Signatur
stimmt nicht mit der Wallet und der Challenge überein.
SIGNATURE_UNSUPPORTED_SCHEME: Die Wallet hat in einem Format signiert,
das Didit nicht verifiziert. DEPOSIT_NOT_FOUND, DEPOSIT_UNCONFIRMED,
DEPOSIT_LOOKUP_FAILED: Die Testeinzahlung ist noch nicht lesbar oder
noch nicht bestätigt; Didit prüft dies weiter, bis das Testfenster
schließt. DEPOSIT_MISMATCH: Die Transaktion sendet nicht den erwarteten
Betrag von der Wallet an die Einzahlungsadresse. DEPOSIT_STALE: Die
Transaktion liegt zeitlich vor der Challenge. TXID_REUSED: Die
Transaktion hat bereits eine andere Wallet nachgewiesen.
CHAIN_UNSUPPORTED: Die Methode ist auf dieser Chain nicht verfügbar.
WINDOW_EXPIRED: Das Testfenster ist abgelaufen. OWNERSHIP_CHANGED: Der
Inhaber der Wallet hat sich geändert oder die Wallet wurde nach dem
Erstellen der Widget-Sitzung aus Ihrem Adressbuch gelöscht.
METHOD_SWITCHED: Der Endbenutzer hat eine andere Methode gewählt, bevor
diese abgeschlossen war. REVIEW_REJECTED: Ihr Prüfer hat den Screenshot
abgelehnt. ABANDONED: Die Widget-Sitzung ist abgelaufen, bevor der
Endbenutzer fertig war.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: >-
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.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.