메인 콘텐츠로 건너뛰기
GET
추가 인증(step-up) 조회
인증은 새로 추가된 기능입니다. 이 엔드포인트는 https://<name>.auth.didit.me와 같은 애플리케이션의 발급자가 제공하며, Didit API 키를 절대 사용하지 않습니다.
스텝업은 이를 생성한 세션에 속합니다. 다른 세션의 액세스 토큰으로 요청하면 404를 받습니다. pending 상태의 스텝업은 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가 아닌 값은 JSON이 아닌 404 페이지를 반환합니다.

응답

추가 인증(step-up)입니다.

작업 전에 해당 사용자가 통과해야 하는 인증입니다.

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분입니다. 스텝업을 조회할 때 먼저 인증이 도달한 결과를 수집하므로 이 시간이 지난 후에도 approved, review 또는 declined로 표시될 수 있습니다. 여전히 pending 상태인 경우 expired로 표시됩니다.

예시:

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

마지막 수정일 2026년 11월 7일