메인 콘텐츠로 건너뛰기
POST
curl
사용자가 아직 플로우를 진행하는 중에 defer_until_flow_finishes: true로 단계를 오버라이드하면, 해당 오버라이드는 대기하다가 플로우가 끝나면 적용됩니다. 더 이상 적용하지 않으려면 여기에서 취소하세요. 검사는 현재 상태를 유지합니다. 취소 내역은 FEATURE_OVERRIDE_CANCELLED로 세션 활동에 기록되며, webhook은 전송되지 않습니다. 응답은 state: cancelled와 cancel_reason: cancelled_by_reviewer가 포함된 오버라이드입니다.

오버라이드 ID 찾기

기능 상태 업데이트에서 반환된 override 객체의 id를 사용하거나, 기능 오버라이드 목록 조회로 세션의 오버라이드를 나열한 뒤 state가 pending_until_flow_finishes인 항목을 선택하세요.

취소에 실패하는 경우

이미 적용되었거나 취소된 오버라이드에 대해서는 409와 함께 feature_override_not_pending 코드가 반환됩니다. 오버라이드가 적용된 후 검사를 변경하려면 대신 새로운 기능 상태 업데이트 요청을 보내세요.

관련 문서

인증

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>
필수

인증 세션의 UUID입니다. 사용자(KYC) 및 기업(KYB) 세션 ID를 모두 지원합니다.

예시:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

overrideId
string<uuid>
필수

취소할 오버라이드의 id입니다.

예시:

"9b2f4c1e-8d3a-4e5f-a6b7-c8d9e0f1a2b3"

응답

오버라이드가 취소되었으며 앞으로 절대 적용되지 않습니다.

PATCH /v3/session/{sessionId}/features/{nodeId}/update-status/로 수행된 검사(기능) 상태의 재정의 항목 하나입니다. 변경 내용, 적용 여부 또는 사용자가 플로우를 완료할 때까지 대기 중인지 여부, 요청한 주체 및 사유를 포함합니다.

id
string<uuid>
필수

재정의 식별자입니다. 취소 endpoint에 전달하십시오.

예시:

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

node_id
string
필수

요청에 지정된 워크플로 노드(노드가 없는 단계의 경우 default).

예시:

"feature_ocr_1"

feature_type
string
필수

요청이 전달한 feature_type이며, 전달하지 않은 경우 빈 문자열입니다.

예시:

""

feature_model
string
필수

재정의된 검사 종류입니다(예: KYC, Face, AML 또는 GeolocationCheck).

예시:

"KYC"

previous_status
enum<string>
필수

재정의가 요청되었을 때의 검사 상태입니다.

사용 가능한 옵션:
Not Finished,
Approved,
Declined,
In Review,
Resub Requested
예시:

"In Review"

new_status
enum<string>
필수

재정의를 통해 설정된 상태입니다.

사용 가능한 옵션:
Approved,
Declined,
In Review
예시:

"Approved"

state
enum<string>
필수

applied: 검사에 새 상태가 적용되었습니다. pending_until_flow_finishes: 재지정 사항이 대기 상태를 유지하다가 사용자가 흐름을 완료하면 적용됩니다. cancelled: 대기 상태였으나 적용되지 않았습니다(cancel_reason 참조).

사용 가능한 옵션:
applied,
pending_until_flow_finishes,
cancelled
예시:

"applied"

forced
boolean
필수

사용자가 플로우에 머무르는 동안 오버라이드가 즉시 적용된 경우 true입니다.

예시:

false

reason
string | null
필수

요청과 함께 전송된 comment 또는 null입니다.

예시:

"Document manually verified by compliance."

requested_by
object | null
필수

누가 재정의를 요청했는지 나타내며, 알 수 없는 경우 null입니다.

requested_at
string<date-time>
필수

재정의가 요청된 시점입니다.

예시:

"2026-10-13T09:15:00Z"

applied_at
string<date-time> | null
필수

검사가 새 상태로 변경된 시점이며, 대기 중이거나 취소된 후에는 null입니다.

예시:

"2026-10-13T09:15:00Z"

cancelled_at
string<date-time> | null
필수

대기 중인 오버라이드가 취소된 시점 또는 null입니다.

예시:

null

cancel_reason
enum<string> | null
필수

대기 중인 오버라이드가 적용되지 않은 이유 또는 null입니다. cancelled_by_reviewer: 취소 endpoint로 취소됨. replaced: 동일한 검사에 대한 최신 오버라이드로 대체됨. check_changed: 사용자가 흐름을 완료하기 전에 검사를 다시 수행함. session_closed: 사용자가 흐름을 완료하기 전에 세션을 벗어남(중단됨, 만료됨 또는 흐름 도중 결정됨).

사용 가능한 옵션:
cancelled_by_reviewer,
replaced,
check_changed,
session_closed,
null
예시:

null

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