메인 콘텐츠로 건너뛰기
POST
curl
이전 링크가 더 이상 작동하지 않을 때 이 기능을 사용합니다. 세션이 삭제되었거나, 사람이 세션을 시작하기 전에 만료된 경우가 해당합니다. 사람이 이미 인증을 시작했거나 완료한 경우에도 세션이 삭제되었다면 재생성 대상이 됩니다. 가져온 세션은 만료로는 대상이 되지 않으며, 반드시 삭제되어 있어야 합니다. 삭제되지 않았고 사람이 이미 시작한 세션은 만료를 이유로 재생성할 수 없습니다. 새 세션은 같은 당사자에 연결되므로, 원래 세션과 마찬가지로 그 결과가 Key People 검사에 반영됩니다. 링크의 유효 기간은 기업 세션이 아니라 해당 세션을 실행하는 KYC 워크플로의 세션 만료 시간(1시간에서 4주)을 따릅니다. 당사자와 그 하위 세션은 기업 세션 결정에서 확인하십시오. 해당 사람을 인증하지 않아야 한다면 대신 당사자를 건너뛰십시오. 당사자와 해당 당사자의 인증이 작동하는 방식은 Key People을 참조하십시오.

인증

x-api-key
string
header
필수

Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며 특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된 IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write 권한이 없는 키는 세션 링크와 token을 null로 수신합니다. https://docs.didit.me/console/api-keys 를 참고하십시오.

경로 매개변수

sessionId
string<uuid>
필수

상위 기업 확인(KYB) 세션의 UUID입니다.

예시:

"33333333-4444-5555-6666-777777777777"

partyUuid
string<uuid>
필수

주요 인물(Key People) 당사자의 UUID(기업 세션 결정의 key_people_checks[].submitted.parties[].uuid)입니다. sessionId로 참조되는 세션에 속해 있어야 합니다.

예시:

"0a3f1e2c-7c2f-4a1b-9d55-2f8d2a5d6b41"

응답

새 KYC 세션이 생성되었습니다. 업데이트된 당사자와 해당 KYC 워크플로의 세션 만료 시간 이후 만료되는 새 하위 세션을 반환합니다.

하위 인증을 포함하는 기업 확인(KYB) 세션의 주요 인물 당사자입니다. 동일한 당사자가 기업 세션 결정의 key_people_checks[].submitted.parties[]에 나타납니다.

uuid
string<uuid>
필수

당사자 식별자입니다.

entity_type
enum<string>
필수

해당 당사자가 개인인지 기업인지 여부입니다.

사용 가능한 옵션:
person,
company
source
enum<string>
필수

REGISTRY: 법인 등기부에서 가져옴. USER: 주요 인물 화면에서 입력함.

사용 가능한 옵션:
REGISTRY,
USER
name
string
필수

당사자의 표시 이름입니다.

is_active
boolean
필수

해당 당사자가 활성 상태인지 여부입니다.

is_skipped
boolean
필수

해당 당사자가 인증 면제 대상인지 여부입니다. 재생성하면 초기화됩니다.

requires_verification
boolean
필수

역할 및 소유 구조 규칙에 따라 이 당사자에 대한 인증이 필요한지 여부입니다.

roles
object[]
필수

해당 당사자가 회사에서 보유한 역할.

kyc_session_deleted
boolean
필수

하위 KYC 세션이 삭제되어 완료될 수 없습니다.

kyb_sub_session_deleted
boolean
필수

kyc_session_deleted에 대응하는 기업 당사자 이벤트입니다.

first_name
string | null

이름(개인).

last_name
string | null

성(개인).

company_name
string | null

기업명(기업 당사자).

registration_number
string | null

기업 등록번호(기업 당사자).

email
string<email> | null

인증 링크가 전송되는 이메일입니다.

nationality
string | null

개인의 경우 국적, 기업의 경우 법인 설립 국가입니다.

phone_number
string | null

해당 주체에 대해 수집된 전화번호입니다.

date_of_birth
string<date> | null

생년월일(개인)입니다.

position
string | null

자유 형식 직함입니다(개인).

custom_fields
object

당사자에 대해 수집된 워크플로 정의 커스텀 필드이며, 필드 키를 키로 사용합니다.

kyc_session_id
string<uuid> | null

하위 개인 KYC 세션(개인)입니다.

kyc_session_status
enum<string> | null

하위 KYC 세션의 상태입니다. 삭제된 세션은 삭제 당시의 상태를 유지합니다.

사용 가능한 옵션:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User,
null
kyc_session_url
string<uri> | null

하위 KYC 세션의 호스팅 링크입니다. 세션이 없거나 삭제된 경우, 그리고 sessions: write 권한이 없는 범위 지정 API 키의 경우 null입니다.

kyb_sub_session_id
string<uuid> | null

하위 KYB 세션(법인 당사자)입니다.

kyb_sub_session_status
enum<string> | null

하위 KYB 세션의 상태입니다.

사용 가능한 옵션:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User,
null
kyb_sub_session_url
string<uri> | null

하위 KYB 세션의 호스팅 링크이며, kyc_session_url과 동일한 null 규칙이 적용됩니다.

verification_workflow_type
enum<string> | null

하위 세션이 실행하는 워크플로 유형입니다.

사용 가능한 옵션:
kyc,
kyb,
adaptive_age_verification,
biometric_authentication,
address_verification,
questionnaire_verification,
email_verification,
phone_verification,
null
verification_workflow_id
string<uuid> | null

하위 세션이 실행하는 워크플로입니다.

verification_workflow_label
string | null

해당 워크플로의 라벨입니다.

verification_workflow_features
object[] | null

현재 상태가 포함된 하위 세션 워크플로의 기능입니다.

didit_internal_id
string<uuid> | null

인증된 인물이 확인된 경우 해당 인물에 대한 Didit의 식별자입니다.

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