> ## 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 のレビューキューにあるスクリーンショットによるウォレット所有証明を承認または却下します。承認するとウォレットが検証済みとなり、所有権が紐づく送金に適用されます。
ウォレット証明判定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 ja/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はプルーフをfailure_reason
REVIEW_REJECTEDでREJECTEDとしてクローズします。エンドユーザーはウィジェットから新しいプルーフを開始できます。noteはプルーフとともに保持されます。
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: >-
ウィジェットセッションの発行対象となったトラベルルール送金の取引。transaction_idなしで発行されたセッションの場合はnullです。
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:、APIキーによる判定の場合はreview、Diditが自動的にクローズした場合はwidgetまたはsweeperです。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: statusとともに含まれます。クローズされた証明です。
method:
type: string
enum:
- MESSAGE_SIGNING
- SATOSHI_TEST
- SCREENSHOT
- SELF_DECLARATION
description: statusとともに含まれます。クローズされた証明の方法です。
max_attempts:
type: integer
description: statusとともに含まれます。このセッションで許容されるウォレット証明の却下回数です。
attempts_used:
type: integer
description: statusとともに含まれます。これまでに却下された証明の数です。
attempts_remaining:
type: integer
description: statusとともに含まれます。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キーです。Business ConsoleのDevelopers -> API
keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権（なし、読み取り、書き込み）、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください:
https://docs.didit.me/console/api-keys
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.