メインコンテンツへスキップ
POST
curl

パスパラメータ

token
string
必須

ウィジェットセッションの発行時に返される不透明なセッショントークンです。

ボディ

application/json
method
enum<string>
必須

エンドユーザーが選択した証明方法です。コンテキストのallowed_methodsのいずれかである必要があります。

利用可能なオプション:
MESSAGE_SIGNING,
SATOSHI_TEST,
SCREENSHOT,
SELF_DECLARATION
wallet_address
string

デフォルトはセッションのwallet_addressです。セッションが送金に紐付いている場合は、送金のウォレットと一致している必要があります。

Maximum string length: 128
chain
string

デフォルトはセッションのチェーンです。

Maximum string length: 32

レスポンス

この方法ですでに開かれている証明を再開したものです。

proof_id
string<uuid>
method
enum<string>
利用可能なオプション:
MESSAGE_SIGNING,
SATOSHI_TEST,
SCREENSHOT,
SELF_DECLARATION
status
enum<string>

PENDING: エンドユーザーがこの方法を選択し、証明がまだ判定されていない状態です。署名に失敗した場合や、テスト入金がまだ読み取れないか確認されていない場合、証明はfailure_reasonを伴ってPENDINGのままとなり、エンドユーザーは再試行できます。送信済みのSATOSHI_TEST入金は期間が終了するまで自動的に再確認され、送信済みのSCREENSHOTはお客様のレビューを待ちます。VERIFIED: ウォレットの所有権が証明されています。REJECTED: テスト入金が実際に誤っている場合(別の送金人からの入金、入金アドレスへの想定金額ではない入金、チャレンジより古い入金、またはすでに別のウォレットを証明した取引)か、お客様のレビュアーがスクリーンショットを却下した場合です。failure_reasonにその理由が示されます。却下された証明は確定であり、セッションの試行回数を1回消費します。EXPIRED: 証明をこれ以上判定できない状態です(期間の終了、エンドユーザーによる方法の切り替え、ウィジェットセッションの失効、またはウォレットの保有者の変更)。failure_reasonにその理由が示されます。

利用可能なオプション:
PENDING,
VERIFIED,
REJECTED,
EXPIRED
wallet_address
string
chain
string

証明の対象となるアドレス帳エントリの正規チェーン識別子(例:ETH、BTC、SOL、TRX)。

deposit_address
string | null

顧客がSatoshiテスト金額を送金する必要がある入金アドレス。SATOSHI_TEST証明の場合にのみ含まれます。

expected_amount
string | null

Satoshiテスト入金が一致しなければならない、入金のネイティブ通貨建ての正確なオンチェーン金額です。SATOSHI_TESTの証明にのみ含まれます。

expires_at
string<date-time> | null

このプルーフ自体のSatoshiテスト期間の期限。SATOSHI_TESTのプルーフにのみ含まれます。SATOSHI_TESTが提示される場合、ウィジェットセッション自体のexpires_atはこの期限をカバーするよう延長されます。

challenge
string | null

顧客が自身のウォレットで署名する、Diditが発行したメッセージです。MESSAGE_SIGNINGの証明の場合にのみ含まれます。

rejection_reason
string

証明が却下された理由。エンドユーザー向けの英文で示されます。statusがREJECTEDの場合にのみ含まれます。レビュアーがスクリーンショットを却下した場合は空です(メモは貴社側にのみ保持されます)。

created_at
string<date-time>
attempts
integer

この証明のために証拠が提出された回数(署名、取引ID、アップロード)。

failure_reason
enum<string>

前回の試行が基準に達しなかった理由、または証明がクローズされた理由。失敗がない場合は空です。

利用可能なオプション:
,
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
最終更新日 2026年11月1日