> ## 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 одобрения
> Didit: одобрите или отклоните подтверждение владения кошельком по скриншоту. Одобрение верифицирует кошелёк и привязывает его к переводу.
Промпт для Decide Wallet Proof API
Скопировать промпт в буфер обмена
\`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.\`
Вставьте в
## OpenAPI
````yaml ru/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 верификации личности. Аутентификация выполняется с помощью заголовка
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: Одобрить или отклонить скриншот-подтверждение кошелька
description: >-
Принять решение по подтверждению скриншотом из вашей очереди на
проверку. approve верифицирует подтверждение и запись в адресной книге и
применяет структуру владения к переводу, для которого была создана
сессия виджета, в точности как подтверждённая подпись. Скриншот никогда
не подтверждает перевод, отправленный другим клиентом Didit по каналу
INTERNAL: для этого требуется подписанное сообщение или тестовый
депозит. reject закрывает подтверждение со статусом REJECTED и причиной
failure_reason REVIEW_REJECTED; конечный пользователь может запустить
новое подтверждение из виджета. Заметка сохраняется вместе с
подтверждением.
operationId: decideTravelRuleWalletProof
parameters:
- name: proof_uuid
in: path
required: true
description: proof_id из очереди на проверку.
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: Документ, по которому принято решение.
content:
application/json:
schema:
$ref: '#/components/schemas/TravelRuleWalletProofReview'
'400':
description: Недопустимое решение или заметка длиннее 512 символов.
'401':
description: Отсутствует или недействителен x-api-key.
'403':
description: >-
У вызывающей стороны отсутствует разрешение для работы с
транзакциями.
'404':
description: >-
Отправленное подтверждение в виде скриншота с этим id не найдено в
вашем приложении.
'409':
description: >-
По подтверждению уже принято решение (тело ответа содержит его
статус) или возвращен код OWNERSHIP_CHANGED: владелец кошелька
сменился либо кошелек был удален после создания сессии виджета,
поэтому подтверждение закрыто и текущему владельцу требуется новое.
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: >-
Необязательно. Сохраняется вместе с подтверждением и возвращается
как 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: Канонический идентификатор сети, например ETH, BTC, SOL, TRX.
holder_name:
type: string
is_ownership_verified:
type: boolean
description: >-
Подтверждено ли владение записью в адресной книге с помощью этого
или другого подтверждения.
transaction_id:
type: string
format: uuid
nullable: true
description: >-
Транзакция, для перевода Travel Rule которой была создана сессия
виджета. Null для сессии, созданной без transaction_id.
file_name:
type: string
nullable: true
content_type:
type: string
nullable: true
screenshot_url:
type: string
nullable: true
description: >-
Ссылка с ограниченным сроком действия на загруженный скриншот.
Запросите список очереди повторно, чтобы обновить ссылку.
attempts:
type: integer
description: >-
Сколько файлов загрузил конечный пользователь для этого
подтверждения.
failure_reason:
allOf:
- $ref: '#/components/schemas/TravelRuleWalletProofFailureReason'
description: >-
REVIEW_REJECTED после отклонения, OWNERSHIP_CHANGED при смене
владельца кошелька или его удалении до принятия решения. В остальных
случаях пусто.
method_chosen_at:
type: string
format: date-time
nullable: true
description: Когда конечный пользователь выбрал метод создания снимка экрана.
decided_at:
type: string
format: date-time
nullable: true
decided_by:
type: string
description: >-
Кто закрыл подтверждение: review: для проверяющего
из консоли, review для решения по API-ключу, widget или sweeper,
если Didit закрыл его автоматически. Пусто, пока статус PENDING.
review_note:
type: string
description: >-
Заметка, отправленная вместе с решением. Пусто, если заметка
отсутствует.
created_at:
type: string
format: date-time
TravelRuleWidgetProofError:
type: object
properties:
detail:
type: string
description: Понятное сообщение на английском языке.
code:
allOf:
- $ref: '#/components/schemas/TravelRuleWalletProofFailureReason'
description: >-
Машиночитаемая причина, позволяющая клиенту отобразить собственное
переведённое сообщение.
status:
type: string
enum:
- PENDING
- VERIFIED
- REJECTED
- EXPIRED
description: >-
Присутствует, когда подтверждение закрыто: REJECTED только что
отправленным депозитом (400), либо REJECTED или EXPIRED, когда
доказательство отправлено для уже закрытого подтверждения (409).
proof_id:
type: string
format: uuid
description: 'Присутствует со статусом: закрытое подтверждение.'
method:
type: string
enum:
- MESSAGE_SIGNING
- SATOSHI_TEST
- SCREENSHOT
- SELF_DECLARATION
description: 'Присутствует со статусом: метод закрытого подтверждения.'
max_attempts:
type: integer
description: >-
Присутствует со статусом: отклонённые подтверждения кошелька,
разрешённые в этой сессии.
attempts_used:
type: integer
description: >-
Присутствует со статусом: отклонённые подтверждения на данный
момент.
attempts_remaining:
type: integer
description: >-
Присутствует со статусом: когда значение равно 0, запуск другого
подтверждения возвращает 409 и вам нужно выпустить новую сессию
виджета.
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: >-
Причина, по которой подтверждение владения кошельком или его последняя
попытка не получили статус VERIFIED. Пусто, если сбоев не было. Статус
PENDING может содержать причину: последняя попытка не удалась, и
конечный пользователь может попробовать снова. Значения
DEPOSIT_MISMATCH, DEPOSIT_STALE, TXID_REUSED и REVIEW_REJECTED переводят
подтверждение в статус REJECTED. SIGNATURE_INVALID: подпись не
соответствует кошельку и запросу (вызов). SIGNATURE_UNSUPPORTED_SCHEME:
кошелёк подписал данные в формате, который Didit не проверяет.
DEPOSIT_NOT_FOUND, DEPOSIT_UNCONFIRMED, DEPOSIT_LOOKUP_FAILED: тестовый
депозит не удаётся прочитать или он ещё не подтверждён; Didit продолжает
проверку до закрытия окна тестирования. DEPOSIT_MISMATCH: транзакция не
отправляет ожидаемую сумму с кошелька на адрес депозита. DEPOSIT_STALE:
транзакция была совершена до вызова. TXID_REUSED: транзакция уже
использовалась для подтверждения другого кошелька. CHAIN_UNSUPPORTED:
метод недоступен в этом блокчейне. WINDOW_EXPIRED: окно тестирования
истекло. OWNERSHIP_CHANGED: владелец кошелька изменился или кошелёк был
удалён из адресной книги после создания сессии виджета. METHOD_SWITCHED:
конечный пользователь выбрал другой метод до завершения текущего.
REVIEW_REJECTED: проверяющий отклонил скриншот. ABANDONED: время сессии
виджета истекло до завершения конечным пользователем.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: >-
API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в
Business Console. Основной ключ имеет полный доступ. Именованный ключ
может иметь ограниченную область действия: без доступа, чтение или
запись для каждого ресурса, ограничение определенными сценариями или
одобренными сессиями, списком IP-адресов и сроком действия. 401
означает, что ключ неверен, отозван или его срок действия истек; 403
означает, что ключ не был передан, у ключа нет доступа к этому ресурсу
или действию, либо запрос поступил с адреса вне его списка IP-адресов;
404 на маршруте сессии означает, что сессия не входит в сценарии или
статусы ключа. Ключ без доступа к медиа получает URL изображений, видео
и PDF как null, а ключ без прав на запись сессий получает ссылки на
сессии и токены как null. См. https://docs.didit.me/console/api-keys.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.