> ## 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.
# Aprovar ou rejeitar prova de carteira por captura de tela
> Aprove ou rejeite na Didit provas de carteira por captura de tela da fila de revisão. Aprovar verifica a carteira e a vincula à transferência.
Prompt da API de decisão sobre comprovação de carteira
Copiar o prompt para a área de transferência
\`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.\`
Colar em
## OpenAPI
````yaml pt-br/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 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/{proof_uuid}/decision/:
post:
tags:
- Travel Rule
summary: Aprovar ou rejeitar um comprovante de carteira por captura de tela
description: >-
Decida sobre uma prova por captura de tela a partir da sua fila de
revisão. approve verifica a prova e a entrada do catálogo de endereços e
aplica a propriedade à transferência para a qual a sessão do widget foi
criada, exatamente como uma assinatura verificada faz. Uma captura de
tela nunca confirma uma transferência que outro cliente da Didit enviou
pelo trilho INTERNAL: isso exige uma mensagem assinada ou um depósito de
teste. reject encerra a prova como REJECTED com failure_reason
REVIEW_REJECTED; o usuário final pode iniciar uma nova prova pelo
widget. A nota é mantida junto com a prova.
operationId: decideTravelRuleWalletProof
parameters:
- name: proof_uuid
in: path
required: true
description: proof_id da fila de revisão.
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: O comprovante decidido.
content:
application/json:
schema:
$ref: '#/components/schemas/TravelRuleWalletProofReview'
'400':
description: Decisão inválida ou uma nota com mais de 512 caracteres.
'401':
description: x-api-key ausente ou inválido.
'403':
description: O chamador não tem a permissão de transações.
'404':
description: >-
Não existe nenhum comprovante por captura de tela enviado com este
id na sua aplicação.
'409':
description: >-
A comprovação já foi decidida (o corpo traz o status dela), ou
código OWNERSHIP_CHANGED: o titular da carteira mudou ou a carteira
foi excluída depois que a sessão do widget foi criada; por isso, a
comprovação está encerrada e o titular atual precisa de uma nova.
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: >-
Opcional. Mantido junto com a comprovação e retornado como
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: >-
Identificador canônico da blockchain, por exemplo, ETH, BTC, SOL,
TRX.
holder_name:
type: string
is_ownership_verified:
type: boolean
description: >-
Se a entrada do catálogo de endereços tem a propriedade verificada,
por esta prova ou por outra.
transaction_id:
type: string
format: uuid
nullable: true
description: >-
A transação para cuja transferência da Travel Rule a sessão do
widget foi criada. Null para uma sessão criada sem um
transaction_id.
file_name:
type: string
nullable: true
content_type:
type: string
nullable: true
screenshot_url:
type: string
nullable: true
description: >-
Link com tempo limitado para a captura de tela enviada. Liste a fila
novamente para obter um link novo.
attempts:
type: integer
description: Quantos arquivos o usuário final enviou para esta comprovação.
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 excluída antes de uma decisão.
Vazio nos demais casos.
method_chosen_at:
type: string
format: date-time
nullable: true
description: Quando o usuário final escolheu o método de captura de tela.
decided_at:
type: string
format: date-time
nullable: true
decided_by:
type: string
description: >-
Quem encerrou o comprovante: review: para um
revisor do console, review para uma decisão via chave de API, widget
ou sweeper quando a Didit o encerrou automaticamente. Vazio enquanto
PENDING.
review_note:
type: string
description: A nota enviada com a decisão. Vazia quando não há nenhuma.
created_at:
type: string
format: date-time
TravelRuleWidgetProofError:
type: object
properties:
detail:
type: string
description: Mensagem legível em inglês.
code:
allOf:
- $ref: '#/components/schemas/TravelRuleWalletProofFailureReason'
description: >-
Motivo legível por máquina, para que um cliente possa exibir sua
própria mensagem traduzida.
status:
type: string
enum:
- PENDING
- VERIFIED
- REJECTED
- EXPIRED
description: >-
Presente quando a prova está encerrada: REJECTED pelo depósito que
acabou de ser enviado (400), ou REJECTED ou EXPIRED quando
evidências são enviadas para uma prova que já está encerrada (409).
proof_id:
type: string
format: uuid
description: 'Presente com status: a prova encerrada.'
method:
type: string
enum:
- MESSAGE_SIGNING
- SATOSHI_TEST
- SCREENSHOT
- SELF_DECLARATION
description: 'Presente com status: o método da prova encerrada.'
max_attempts:
type: integer
description: >-
Presente com status: provas de carteira recusadas que esta sessão
permite.
attempts_used:
type: integer
description: 'Presente com status: provas recusadas até o momento.'
attempts_remaining:
type: integer
description: >-
Presente com status: quando for 0, iniciar outra prova retorna 409 e
você gera uma nova sessão do 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: >-
Por que uma prova de propriedade de carteira, ou sua última tentativa,
não chegou a VERIFIED. Vazio quando nada falhou. Uma prova PENDING pode
ter um motivo: a última tentativa falhou e o usuário 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 em um formato que a
Didit não verifica. DEPOSIT_NOT_FOUND, DEPOSIT_UNCONFIRMED,
DEPOSIT_LOOKUP_FAILED: o depósito de teste não pode ser lido ou ainda
não foi confirmado; a Didit continua verificando-o até a janela de teste
fechar. DEPOSIT_MISMATCH: a transação não envia o valor 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 fechou. OWNERSHIP_CHANGED:
o titular da carteira mudou, ou a carteira foi excluída do seu catálogo
de endereços, depois que a sessão do widget foi criada. METHOD_SWITCHED:
o usuário final escolheu outro método antes de concluir este.
REVIEW_REJECTED: seu revisor rejeitou a captura de tela. ABANDONED: a
sessão do widget expirou antes de o usuário final concluir.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: >-
Chave de API da sua aplicação, em Developers -> API keys no Business
Console. A chave principal tem acesso total. Uma chave nomeada pode ter
escopo restrito: nenhum acesso, 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á errada, 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 a requisição veio de um
endereço fora da sua lista de IPs; 404 em uma rota de sessão significa
que a sessão está fora dos fluxos ou status da chave. Uma chave sem
acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave
sem permissão de escrita em sessões recebe links e tokens de sessão como
null. Consulte https://docs.didit.me/console/api-keys.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.