メインコンテンツへスキップ
GET
ステップアップを取得
Authenticationは新機能です。これらのエンドポイントは、https://<name>.auth.didit.meなどのアプリケーションのissuerから提供され、DiditのAPIキーは受け付けません。
ステップアップは、それを作成したセッションに属します。別のセッションのアクセストークンを使うと404が返されます。pendingのステップアップは、30分が経過するとexpiredになります。

承認

Authorization
string
header
必須

POST /token/から取得したこの人物のアクセストークンです。ヘッダーがtyp: at+jwtのES256 JWTで、有効期間は最長5分です。DiditのAPIキーではありません。

パスパラメータ

step_up_id
string<uuid>
必須

POST /step-up/から返されるidで、return_toに付くstep_upクエリパラメーターでもあります。UUIDではない値の場合、JSONではなく404ページが返されます。

レスポンス

ステップアップ。

アクションの前に本人が合格する必要がある認証。

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
必須

支払額(小数点以下2桁)。

例:

"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分後。ステップアップを読み取ると、まずその検証で得られた結果が取得されるため、この時間を過ぎてもapproved、review、declinedと読み取られる場合があります。まだpendingのものはexpiredと読み取られます。

例:

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

最終更新日 2026年11月1日