跳转到主要内容
GET
获取升级验证
认证功能是新功能。这些端点由您应用的颁发方提供服务,例如 https://<name>.auth.didit.me,绝不接受您的 Didit API 密钥。
step-up 验证属于创建它的会话:另一个会话的访问令牌将收到 404。pending 状态的 step-up 在 30 分钟后会显示为 expired。

授权

Authorization
string
header
必填

来自 POST /token/ 的该人员访问 token:请求头带有 typ: at+jwt 的 ES256 JWT,有效期最多 5 分钟。并非您的 Didit API 密钥。

路径参数

step_up_id
string<uuid>
必填

来自 POST /step-up/ 的 id,也是您 return_to 中的 step_up 查询参数。非 UUID 值将返回 404 页面,而非 JSON。

响应

升级验证。

该人员在执行该操作前必须通过的验证。

id
string<uuid>
必填
示例:

"94efc2c3-ca84-42fe-900b-6fb61669a7a1"

rule
enum<string>
必填

请求该操作的规则。当有多条规则适用时,为采用最强方法的那条规则。

可用选项:
payout,
device,
bank,
contact
示例:

"payout"

method
enum<string>
必填

该人员执行的操作:liveness、selfie(活体检测并与 Didit 已保存的人脸进行比对)或 full_id(证件和自拍照)。当 Didit 尚未保存该人员的人脸时,一旦其打开 verification_url,selfie 将转为 full_id。

可用选项:
liveness,
selfie,
full_id
示例:

"selfie"

status
enum<string>
必填

仅对 approved 采取操作。review 等待您的团队进行审核。当 verification_url 有效时,declined 并不是最终状态:用户可以重试,并且追加验证将恢复为 pending。superseded 表示另一项核验接管了其验证,或者该结果不属于此次追加验证:请创建一个新的验证。

可用选项:
pending,
review,
approved,
declined,
expired,
superseded
示例:

"pending"

level
enum<string> | null
必填

验证一旦通过所达到的级别。

可用选项:
liveness,
liveness_face_match,
full_id,
null
示例:

null

amount
string | null
必填

付款金额,保留两位小数。

示例:

"900.00"

currency
string | null
必填
示例:

"USD"

created_at
string<date-time>
必填
示例:

"2026-10-17T10:41:14.894632Z"

completed_at
string<date-time> | null
必填
示例:

null

expires_at
string<date-time>
必填

创建后 30 分钟。读取 step-up 会先收集其验证达到的任何结果,因此在此时间之后仍可读取到 approved、review 或 declined;仍为 pending 的将读取为 expired。

示例:

"2026-10-17T11:11:14.894581Z"

最后修改于 2026年11月7日