> ## 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.
# Comprovativos de carteira para revisão: API Travel Rule
> Liste no Didit os comprovativos de carteira à espera de revisão, do mais antigo para o mais recente, com imagem, carteira, transação e histórico.
Prompt da API para listar comprovativos de carteira
Copiar o prompt para a área de transferência
\`List the screenshot wallet-ownership proofs my end users uploaded from the wallet-ownership widget, so my compliance team can review them.
Endpoint:
GET [https://verification.didit.me/v3/travel-rule/wallet-proofs/](https://verification.didit.me/v3/travel-rule/wallet-proofs/)
Authentication:
Use the x-api-key header with my Didit API key.
Query parameters:
* status - PENDING (default, the proofs still to decide), VERIFIED, REJECTED or EXPIRED.
* limit, offset - pagination.
What to read from each result:
* proof\_id - pass it to POST /v3/travel-rule/wallet-proofs/{proof_uuid}/decision/ to approve or reject.
* screenshot\_url - time-limited link to the uploaded image; list again for a fresh link.
* wallet\_address, chain (canonical, e.g. ETH, BTC, SOL, TRX), holder\_name, is\_ownership\_verified.
* transaction\_id - the transaction the widget session was minted for, null when none.
* attempts, failure\_reason, method\_chosen\_at, decided\_at, decided\_by, review\_note.
Behavior:
* Oldest first, so the proof that has waited longest comes first.
* Only uploaded screenshots appear. A proof on a wallet I deleted from my address book never appears: Didit closes it as OWNERSHIP\_CHANGED.
Failure modes:
* 400 - unknown status.
* 401 - missing or malformed x-api-key.
Full guide: /transaction-monitoring/wallet-ownership-widget#what-it-proves.\`
Colar em
## OpenAPI
````yaml pt/openapi-25.json GET /v3/travel-rule/wallet-proofs/
openapi: 3.0.0
info:
version: 3.0.0
title: Didit Verification API
description: API de Verificação de identidade. Autentique-se com o cabeçalho x-api-key.
servers:
- url: https://verification.didit.me
security: []
tags: []
paths:
/v3/travel-rule/wallet-proofs/:
get:
tags:
- Travel Rule
summary: Listar comprovativos de carteira através de capturas de ecrã para rever
description: >-
A sua fila de revisão para comprovativos de propriedade da carteira por
captura de ecrã. Uma captura de ecrã é o único comprovativo que a Didit
não consegue verificar autonomamente: assim que o utilizador final a
envia a partir do widget, aguarda em PENDING até que aprove ou recuse
com POST /v3/travel-rule/wallet-proofs/{proof_uuid}/decision/. Do mais
antigo para o mais recente, para que a fila seja processada a partir do
comprovativo que aguarda há mais tempo. Apenas aparecem capturas de ecrã
enviadas, nunca um comprovativo cujo utilizador final ainda não tenha
enviado um ficheiro, e nunca um relativo a uma carteira que tenha
eliminado do seu livro de endereços (a Didit fecha esses como
OWNERSHIP_CHANGED).
operationId: listTravelRuleWalletProofs
parameters:
- name: status
in: query
description: >-
Quais os comprovativos a listar. A predefinição é PENDING, aqueles
que ainda estão por decidir.
schema:
type: string
enum:
- PENDING
- VERIFIED
- REJECTED
- EXPIRED
default: PENDING
- name: limit
in: query
schema:
type: integer
default: 50
minimum: 1
- name: offset
in: query
schema:
type: integer
default: 0
minimum: 0
responses:
'200':
description: >-
Comprovativos por captura de ecrã paginados. count é exato até 100 e
limitado a 100 acima desse valor.
content:
application/json:
schema:
type: object
properties:
count:
type: integer
next:
type: string
nullable: true
previous:
type: string
nullable: true
results:
type: array
items:
$ref: '#/components/schemas/TravelRuleWalletProofReview'
'400':
description: Estado desconhecido.
'401':
description: x-api-key em falta ou inválido.
'403':
description: O chamador não possui a permissão de transações.
security:
- ApiKeyAuth: []
x-codeSamples:
- lang: curl
label: curl
source: >-
curl
https://verification.didit.me/v3/travel-rule/wallet-proofs/?status=PENDING
\
-H 'x-api-key: YOUR_API_KEY'
- lang: python
label: Python
source: |-
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
for item in client.travel_rule.wallet_proofs.list():
print(item)
- lang: javascript
label: Node.js
source: |-
import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
for await (const item of didit.travelRule.walletProofs.list()) {
console.log(item);
}
- lang: java
label: Java
source: |-
import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
for (var item : client.travelRule().walletProofs().list()) {
System.out.println(item);
}
- lang: php
label: PHP
source: |-
travelRule->walletProofs->list() as $item) {
print_r($item->toArray());
}
- lang: ruby
label: Ruby
source: |-
require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
didit.travel_rule.wallet_proofs.list.auto_paging_each do |item|
puts item.to_h
end
- lang: csharp
label: .NET
source: >-
using System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
await foreach (var item in await
client.TravelRule.WalletProofs.ListAsync())
{
Console.WriteLine(JsonSerializer.Serialize(item));
}
components:
schemas:
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: >-
Identificador canónico da blockchain, por exemplo, ETH, BTC, SOL,
TRX.
holder_name:
type: string
is_ownership_verified:
type: boolean
description: >-
Indica se a propriedade da entrada do livro de endereços está
verificada, por este ou por outro comprovativo.
transaction_id:
type: string
format: uuid
nullable: true
description: >-
A transação para cuja transferência de Travel Rule a sessão do
widget foi gerada. Nulo para uma sessão gerada sem um
transaction_id.
file_name:
type: string
nullable: true
content_type:
type: string
nullable: true
screenshot_url:
type: string
nullable: true
description: >-
Ligação com limite de tempo para a captura de ecrã carregada. Liste
a fila novamente para obter uma ligação nova.
attempts:
type: integer
description: >-
Quantos ficheiros o utilizador final carregou para este
comprovativo.
failure_reason:
allOf:
- $ref: '#/components/schemas/TravelRuleWalletProofFailureReason'
description: >-
REVIEW_REJECTED após uma rejeição, OWNERSHIP_CHANGED quando a
carteira mudou de titular ou foi eliminada antes de uma decisão.
Vazio caso contrário.
method_chosen_at:
type: string
format: date-time
nullable: true
description: Quando o utilizador final escolheu o método de captura de ecrã.
decided_at:
type: string
format: date-time
nullable: true
decided_by:
type: string
description: >-
Quem fechou o comprovativo: review: para um revisor
da consola, review para uma decisão por chave de API, widget ou
sweeper quando a Didit o fechou automaticamente. Vazio enquanto
PENDING.
review_note:
type: string
description: A nota enviada com a decisão. Vazia se não existir nenhuma.
created_at:
type: string
format: date-time
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: >-
O motivo pelo qual uma prova de propriedade da carteira, ou a sua última
tentativa, não alcançou o estado VERIFIED. Vazio quando nada falhou. Uma
prova PENDING pode conter um motivo: a última tentativa falhou e o
utilizador final pode tentar novamente. DEPOSIT_MISMATCH, DEPOSIT_STALE,
TXID_REUSED e REVIEW_REJECTED encerram a prova como REJECTED.
SIGNATURE_INVALID: a assinatura não corresponde à carteira e ao desafio.
SIGNATURE_UNSUPPORTED_SCHEME: a carteira assinou num formato que a Didit
não verifica. DEPOSIT_NOT_FOUND, DEPOSIT_UNCONFIRMED,
DEPOSIT_LOOKUP_FAILED: o depósito de teste não está legível ou ainda não
foi confirmado; a Didit continua a verificá-lo até que a janela de teste
termine. DEPOSIT_MISMATCH: a transação não envia o montante esperado da
carteira para o endereço de depósito. DEPOSIT_STALE: a transação é
anterior ao desafio. TXID_REUSED: a transação já comprovou outra
carteira. CHAIN_UNSUPPORTED: o método não está disponível nesta
blockchain. WINDOW_EXPIRED: a janela de teste terminou.
OWNERSHIP_CHANGED: o titular da carteira mudou, ou a carteira foi
eliminada do seu livro de endereços, após a criação da sessão do widget.
METHOD_SWITCHED: o utilizador final escolheu outro método antes de
concluir este. REVIEW_REJECTED: o seu revisor rejeitou a captura de
ecrã. ABANDONED: a sessão do widget expirou antes de o utilizador final
concluir.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: >-
A chave de API da sua aplicação, a partir de Programadores -> Chaves de
API na Business Console. A chave principal tem acesso total. Uma chave
nomeada pode ter o âmbito definido: nenhum, leitura ou escrita por
recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de
endereços IP e a uma data de validade. 401 significa que a chave está
incorreta, revogada ou expirada; 403 significa que nenhuma chave foi
enviada, que a chave não tem acesso a este recurso ou ação, ou que o
pedido veio de um endereço fora da sua lista de IP; 404 numa rota de
sessão significa que a sessão está fora dos fluxos ou estados da chave.
Uma chave sem acesso a multimédia recebe URLs de imagens, vídeos e PDFs
como nulos, e uma chave sem permissão de escrita em sessões recebe
ligações de sessão e tokens como nulos. Consulte
https://docs.didit.me/console/api-keys.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.