> ## 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.
# API per approvare o rifiutare prova wallet screenshot
> Approva o rifiuta in Didit una prova di proprietà del wallet con screenshot. L'approvazione verifica il wallet e lo collega alla transazione.
Prompt API per decidere la prova del wallet
Copia il prompt negli appunti
\`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.\`
Incolla in
## OpenAPI
````yaml it/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 di verifica dell'identità. Autenticati con l'intestazione x-api-key.
servers:
- url: https://verification.didit.me
security: []
tags: []
paths:
/v3/travel-rule/wallet-proofs/{proof_uuid}/decision/:
post:
tags:
- Travel Rule
summary: Approva o rifiuta una prova del wallet tramite screenshot
description: >-
Prendi una decisione su una prova tramite screenshot dalla tua coda di
revisione. approve verifica la prova e la voce della rubrica e applica
l'assetto proprietario al trasferimento per cui la sessione del widget è
stata creata, esattamente come fa una firma verificata. Uno screenshot
non conferma mai un trasferimento inviato da un altro cliente Didit
tramite il canale INTERNAL: per questo è necessario un messaggio firmato
o un deposito di prova. reject chiude la prova come REJECTED con
failure_reason REVIEW_REJECTED; l'utente finale può avviare una nuova
prova dal widget. La nota viene conservata con la prova.
operationId: decideTravelRuleWalletProof
parameters:
- name: proof_uuid
in: path
required: true
description: proof_id dalla coda di revisione.
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: La prova determinata.
content:
application/json:
schema:
$ref: '#/components/schemas/TravelRuleWalletProofReview'
'400':
description: Decisione non valida o nota più lunga di 512 caratteri.
'401':
description: x-api-key mancante o non valida.
'403':
description: Il chiamante non dispone dell'autorizzazione per le transazioni.
'404':
description: >-
Nessuna prova con screenshot inviata con questo id nella tua
applicazione.
'409':
description: >-
La prova ha già una decisione (il corpo ne riporta lo stato) o il
codice OWNERSHIP_CHANGED: il titolare del wallet è cambiato o il
wallet è stato eliminato dopo la creazione della sessione del
widget, quindi la prova è chiusa e l'attuale titolare ne necessita
una nuova.
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: Opzionale. Conservato con la prova e restituito come review_note.
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: >-
Identificatore canonico della rete blockchain, ad es. ETH, BTC, SOL,
TRX.
holder_name:
type: string
is_ownership_verified:
type: boolean
description: >-
Indica se la voce della rubrica ha la titolarità verificata, tramite
questa prova o un'altra.
transaction_id:
type: string
format: uuid
nullable: true
description: >-
La transazione per il cui trasferimento Travel Rule è stata generata
la sessione del widget. Null per una sessione generata senza
transaction_id.
file_name:
type: string
nullable: true
content_type:
type: string
nullable: true
screenshot_url:
type: string
nullable: true
description: >-
Link a tempo allo screenshot caricato. Elenca nuovamente la coda per
ottenere un link aggiornato.
attempts:
type: integer
description: Quanti file l'utente finale ha caricato per questa prova.
failure_reason:
allOf:
- $ref: '#/components/schemas/TravelRuleWalletProofFailureReason'
description: >-
REVIEW_REJECTED dopo un rifiuto, OWNERSHIP_CHANGED quando il wallet
ha cambiato titolare o è stato eliminato prima di una decisione.
Vuoto altrimenti.
method_chosen_at:
type: string
format: date-time
nullable: true
description: >-
Data e ora in cui l'utente finale ha scelto il metodo dello
screenshot.
decided_at:
type: string
format: date-time
nullable: true
decided_by:
type: string
description: >-
Chi ha chiuso la prova: review: per un
revisore della console, review per una decisione tramite chiave API,
widget o sweeper quando Didit l'ha chiusa automaticamente. Vuoto
finché è PENDING.
review_note:
type: string
description: La nota inviata con la decisione. Vuota se assente.
created_at:
type: string
format: date-time
TravelRuleWidgetProofError:
type: object
properties:
detail:
type: string
description: Messaggio di facile lettura in inglese.
code:
allOf:
- $ref: '#/components/schemas/TravelRuleWalletProofFailureReason'
description: >-
Motivo leggibile dalla macchina, che consente a un client di
mostrare il proprio messaggio tradotto.
status:
type: string
enum:
- PENDING
- VERIFIED
- REJECTED
- EXPIRED
description: >-
Presente quando la prova è chiusa: REJECTED dal deposito appena
inviato (400), oppure REJECTED o EXPIRED quando viene inviata
un'evidenza a una prova già chiusa (409).
proof_id:
type: string
format: uuid
description: 'Presente con status: la prova chiusa.'
method:
type: string
enum:
- MESSAGE_SIGNING
- SATOSHI_TEST
- SCREENSHOT
- SELF_DECLARATION
description: 'Presente con status: il metodo della prova chiusa.'
max_attempts:
type: integer
description: >-
Presente con status: prove del wallet rifiutate consentite da questa
sessione.
attempts_used:
type: integer
description: 'Presente con status: prove rifiutate finora.'
attempts_remaining:
type: integer
description: >-
Presente con status: quando è 0, l'avvio di un'altra prova
restituisce 409 e crei una nuova sessione del widget.
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: >-
Il motivo per cui una prova di titolarità del wallet, o il suo ultimo
tentativo, non ha raggiunto lo stato VERIFIED. Vuoto se non si è
verificato alcun errore. Una prova PENDING può contenerne uno: l'ultimo
tentativo è fallito e l'utente finale può riprovare. DEPOSIT_MISMATCH,
DEPOSIT_STALE, TXID_REUSED e REVIEW_REJECTED chiudono la prova come
REJECTED. SIGNATURE_INVALID: la firma non corrisponde al wallet e alla
challenge. SIGNATURE_UNSUPPORTED_SCHEME: il wallet ha firmato in un
formato non verificato da Didit. DEPOSIT_NOT_FOUND, DEPOSIT_UNCONFIRMED,
DEPOSIT_LOOKUP_FAILED: il deposito di prova non è leggibile o non è
ancora confermato; Didit continua a verificarlo fino alla chiusura della
finestra di prova. DEPOSIT_MISMATCH: la transazione non invia l'importo
previsto dal wallet all'indirizzo di deposito. DEPOSIT_STALE: la
transazione è antecedente alla challenge. TXID_REUSED: la transazione ha
già dimostrato la titolarità di un altro wallet. CHAIN_UNSUPPORTED: il
metodo non è disponibile su questa blockchain. WINDOW_EXPIRED: la
finestra di prova si è chiusa. OWNERSHIP_CHANGED: il titolare del wallet
è cambiato, oppure il wallet è stato eliminato dalla tua rubrica, dopo
la generazione della sessione del widget. METHOD_SWITCHED: l'utente
finale ha scelto un altro metodo prima di completare questo.
REVIEW_REJECTED: il tuo revisore ha rifiutato lo screenshot. ABANDONED:
la sessione del widget è scaduta prima che l'utente finale terminasse.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: >-
La chiave API della tua applicazione, da Developers -> API keys nella
Business Console. La chiave primaria ha accesso completo. Una chiave con
nome può avere un ambito definito: nessuno, lettura o scrittura per
risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco
di indirizzi IP e a una data di scadenza. 401 indica che la chiave è
errata, revocata o scaduta; 403 indica che non è stata inviata alcuna
chiave, che la chiave non ha accesso a questa risorsa o azione, oppure
che la richiesta proviene da un indirizzo non incluso nel suo elenco IP;
404 su una route di sessione indica che la sessione non rientra nei
workflow o negli stati previsti dalla chiave. Una chiave senza accesso
ai media riceve gli URL di immagini, video e PDF come null, e una chiave
senza permessi di scrittura sulle sessioni riceve link e token di
sessione come null. Consulta https://docs.didit.me/console/api-keys.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.