跳转到主要内容
POST
curl

路径参数

token
string
必填

生成 widget 会话时返回的不透明会话 token。

请求体

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:终端用户选择了此方式,证明尚未作出决策。签名失败或测试充值尚无法读取或确认会使证明保持 PENDING 状态并附带 failure_reason,以便终端用户重试;提交的 SATOSHI_TEST 充值会在其窗口关闭前自动重新检查,提交的 SCREENSHOT 等待您的审核。VERIFIED:所有权已证明。REJECTED:测试充值确实有误(发送方不符、转入充值地址的金额不符、早于挑战,或该交易已用于证明另一个钱包)或您的审核员拒绝了屏幕截图;failure_reason 会说明具体原因。被拒绝的证明为最终状态,并会消耗会话的一次尝试次数。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 test)窗口截止时间。仅在 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月7日