시작하기
연동 / SDK
사용자 인증
기업 확인
거래 모니터링
변경 내역curl
curl -X POST \
https://verification.didit.me/v3/sessions/delete/ \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"session_numbers": ["1001", "1002", "1003"]
}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.sessions.batch_delete(
session_numbers=["1001", "1002", "1003"],
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.sessions.batchDelete({
session_numbers: ["1001", "1002", "1003"],
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Sessions.BatchDelete(ctx, didit.SessionsBatchDeleteParams{
SessionNumbers: didit.Some([]string{"1001", "1002", "1003"}),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import java.util.List;
import me.didit.Didit;
import me.didit.types.SessionsBatchDeleteParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.sessions().batchDelete(SessionsBatchDeleteParams.builder()
.sessionNumbers(List.of("1001", "1002", "1003"))
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->sessions->batchDelete([
'session_numbers' => ['1001', '1002', '1003'],
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.sessions.batch_delete(session_numbers: ["1001", "1002", "1003"])
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Sessions.BatchDeleteAsync(new SessionsBatchDeleteParams
{
SessionNumbers = new string[] { "1001", "1002", "1003" },
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"results": [
{
"session_id": "4c5c7f3a-3b1d-4b7e-9c39-2b4f7e6a1d02",
"session_number": 1001,
"face_retention_outcome": "deleted",
"biometric_template_uuid": null,
"biometric_template_expires_at": null,
"deleted_child_verifications": 0
},
{
"session_id": "b8e1d2c3-4f5a-4b6c-8d7e-9f0a1b2c3d4e",
"session_number": 1002,
"face_retention_outcome": "retained_with_user",
"biometric_template_uuid": "9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b",
"biometric_template_expires_at": "2027-10-09T10:15:00Z",
"deleted_child_verifications": 0
},
{
"session_id": "7a1e9c2d-5f4b-4c3a-8e2d-1b0a9f8e7d6c",
"session_number": 1003,
"face_retention_outcome": "ineligible_no_vendor_user",
"biometric_template_uuid": null,
"biometric_template_expires_at": null,
"deleted_child_verifications": 0
},
{
"session_id": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
"session_number": 1004,
"face_retention_outcome": "failed_retryable",
"biometric_template_uuid": null,
"biometric_template_expires_at": null,
"deleted_child_verifications": 0
}
]
}세션 작업
세션 일괄 삭제 API: KYC 정리
세션 번호로 또는 전체를 한 번에 KYC 세션을 삭제합니다. 최대 20개는 세션별 결과를 반환하며, 그 이상은 조회 가능한 삭제 작업으로 실행됩니다. Didit 제공.
POST
/
v3
/
sessions
/
delete
/
curl
curl -X POST \
https://verification.didit.me/v3/sessions/delete/ \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"session_numbers": ["1001", "1002", "1003"]
}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.sessions.batch_delete(
session_numbers=["1001", "1002", "1003"],
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.sessions.batchDelete({
session_numbers: ["1001", "1002", "1003"],
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Sessions.BatchDelete(ctx, didit.SessionsBatchDeleteParams{
SessionNumbers: didit.Some([]string{"1001", "1002", "1003"}),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import java.util.List;
import me.didit.Didit;
import me.didit.types.SessionsBatchDeleteParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.sessions().batchDelete(SessionsBatchDeleteParams.builder()
.sessionNumbers(List.of("1001", "1002", "1003"))
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->sessions->batchDelete([
'session_numbers' => ['1001', '1002', '1003'],
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.sessions.batch_delete(session_numbers: ["1001", "1002", "1003"])
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Sessions.BatchDeleteAsync(new SessionsBatchDeleteParams
{
SessionNumbers = new string[] { "1001", "1002", "1003" },
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"results": [
{
"session_id": "4c5c7f3a-3b1d-4b7e-9c39-2b4f7e6a1d02",
"session_number": 1001,
"face_retention_outcome": "deleted",
"biometric_template_uuid": null,
"biometric_template_expires_at": null,
"deleted_child_verifications": 0
},
{
"session_id": "b8e1d2c3-4f5a-4b6c-8d7e-9f0a1b2c3d4e",
"session_number": 1002,
"face_retention_outcome": "retained_with_user",
"biometric_template_uuid": "9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b",
"biometric_template_expires_at": "2027-10-09T10:15:00Z",
"deleted_child_verifications": 0
},
{
"session_id": "7a1e9c2d-5f4b-4c3a-8e2d-1b0a9f8e7d6c",
"session_number": 1003,
"face_retention_outcome": "ineligible_no_vendor_user",
"biometric_template_uuid": null,
"biometric_template_expires_at": null,
"deleted_child_verifications": 0
},
{
"session_id": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
"session_number": 1004,
"face_retention_outcome": "failed_retryable",
"biometric_template_uuid": null,
"biometric_template_expires_at": null,
"deleted_child_verifications": 0
}
]
}동작 방식
일치하는 각 세션은 세션 삭제와 똑같이 삭제됩니다. 세션, 세션이 보유한 모든 인증 시도, 세션의 결정 및 추출된 데이터, 기능 레코드, 저장된 모든 파일이 삭제되며, 세션은 모든 조회 엔드포인트에서 사라지고 이전에 발급된 미디어 URL은 더 이상 확인(resolve)되지 않습니다. 삭제된 세션에 대해 아직 대기 중인 webhook 전송과 그 재시도는 취소됩니다. 이미 전송된 webhook에는 영향이 없습니다. 삭제는 영구적이며 되돌릴 수 없습니다. 선택한 세션 중 하나라도 확정된 규제 보고서에 포함되어 있으면, 요청 전체가409를 반환하고 아무것도 삭제되지 않습니다. 응답에는 code: in_filed_report가 포함되며 각 보고서가 이름으로 표시됩니다. 각 보고서를 보고서 삭제로 삭제한 다음 요청을 다시 실행하십시오. 보고서를 삭제해도 세션은 삭제되지 않으며, 이 요청을 다시 실행하기 전까지 세션은 그대로 남아 있습니다.
session_numbers로 선택하든 delete_all로 선택하든, 일치하는 세션 수에 따라 요청에 대한 응답이 달라집니다.
| 일치하는 세션 수 | 응답 |
|---|---|
| 최대 20개 | 세션이 삭제되면 200 OK를 반환하며, results에 일치한 세션마다 결과 하나가 포함됩니다. |
| 20개 초과 | 삭제 작업과 함께 202 Accepted를 반환합니다. 세션은 백그라운드에서 삭제되며, 완료될 때까지 세션 삭제 작업 조회를 주기적으로 호출하십시오. |
face_retention_outcome이 failed_retryable인 경우를 제외하고 세션이 삭제되었음을 확인합니다. 이 경우 해당 세션은 삭제되지 않았으며 여전히 남아 있습니다. 따라서 이 결과는 삭제 확인이 아니라 재시도해야 하는 실패로 처리하십시오.
애플리케이션에서 활성 KYC 세션과 일치하지 않는 번호는 건너뛰며, results에 나타나지 않습니다.
delete_all 필터로 범위 좁히기
delete_all: true를 사용하면 세션 목록 조회의 필터를 filter_ 접두사와 함께 사용해 선택 범위를 좁힐 수 있습니다.
필터는 쿼리 파라미터와 같은 값을 사용합니다.
여러 값을 받을 수 있는 필터(status, workflow_id, country, region, document_type, document_name, session_type, warning, organization_name)는 쉼표로 구분된 문자열이나 배열을 받을 수 있습니다.
{
"delete_all": true,
"filter_status": ["Declined"],
"filter_workflow_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"filter_date_from": "2026-09-01",
"filter_date_to": "2026-09-30"
}
- 필터는
delete_all과 함께 사용할 때만 적용됩니다.session_numbers와 함께 사용하면 필터는 검사만 되고 선택 범위는 바뀌지 않습니다. - 그 밖의 모든 필터는 값을 하나만 받습니다.
배열은 쉼표로 구분된 값 하나로 합쳐지므로, 날짜, UUID 또는
api_service값을 여러 개 지정하면400이 반환됩니다. 또한vendor_data,search,screened_full_name텍스트를 여러 개 지정하면 이들은 대체 조건으로 매칭되지 않습니다. - 값이 비어 있는 필터는 무시되므로 선택 범위를 좁히지 않습니다.
- 알 수 없는
filter_*키는400과{"filter_reviewer": "Unknown filter."}를 반환합니다. 값을 읽을 수 없으면 해당filter_*키로400이 반환되며, 예를 들어{"filter_date_from": ["Enter a valid date."]}와 같습니다. 두 경우 모두 아무것도 삭제되지 않으므로, 잘못 입력한 필터가 삭제 범위를 모든 세션으로 넓히는 일은 없습니다. - 삭제 작업에도 같은 필터가 적용되며, 모든
delete_all과 마찬가지로 요청 이전에 생성된 세션만 대상으로 합니다.
보존 및 지시 필드
이 엔드포인트는 단일 세션 엔드포인트와 같은 선택적 필드를 받으며, 이를 일치하는 모든 세션에 적용합니다.| 필드 | 타입 | 설명 |
|---|---|---|
retain_face_embeddings | boolean 또는 null | 이 요청에 대해 애플리케이션의 face_retention_policy를 재정의합니다. |
face_retention_days | integer (1-3650) | 보존되는 템플릿의 유한 보존 기간입니다. 보존할 때 필수이며, 애플리케이션에 face_retention_days가 설정되어 있으면 생략할 수 있습니다. |
face_retention_deadline | datetime (ISO 8601) | 선택 사항인 최종 만료 시점입니다. 반드시 미래 시점이어야 합니다. |
deletion_instruction | operational_session_delete(기본값) 또는 privacy_erasure | privacy_erasure는 세션을 삭제하기 전에 각 세션의 사용자에 대해 보존된 모든 템플릿을 제거하며, retain_face_embeddings: true와 함께 사용할 수 없습니다. |
instruction_id | string (최대 255자) | 이 지시에 대한 지속적인 참조 값입니다. 감사 로그와 보존된 모든 템플릿에 기록됩니다. |
expires_at이 계산되는 방식, 개인정보 삭제 지시의 동작에 대해서는 세션 삭제를 참조하십시오.
세션별 결과
일치하는 세션이 최대 20개인 경우200 OK는 세션마다 결과 하나를 반환합니다.
{
"results": [
{ "session_id": "4c5c7f3a-3b1d-4b7e-9c39-2b4f7e6a1d02", "session_number": 1001, "face_retention_outcome": "deleted", "biometric_template_uuid": null, "biometric_template_expires_at": null, "deleted_child_verifications": 0 },
{ "session_id": "b8e1d2c3-4f5a-4b6c-8d7e-9f0a1b2c3d4e", "session_number": 1002, "face_retention_outcome": "retained_with_user", "biometric_template_uuid": "9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b", "biometric_template_expires_at": "2027-10-09T10:15:00Z", "deleted_child_verifications": 0 },
{ "session_id": "7a1e9c2d-5f4b-4c3a-8e2d-1b0a9f8e7d6c", "session_number": 1003, "face_retention_outcome": "ineligible_no_vendor_user", "biometric_template_uuid": null, "biometric_template_expires_at": null, "deleted_child_verifications": 0 },
{ "session_id": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f", "session_number": 1004, "face_retention_outcome": "failed_retryable", "biometric_template_uuid": null, "biometric_template_expires_at": null, "deleted_child_verifications": 0 }
]
}
biometric_template_expires_at은 보존된 템플릿이 삭제되는 시점이며, 이 엔드포인트는 KYC 세션만 삭제하므로 deleted_child_verifications는 항상 0입니다.
face_retention_outcome | 의미 |
|---|---|
deleted | 세션과 얼굴 임베딩이 삭제됩니다. 기본 동작입니다. |
retained_with_user | 세션은 삭제됩니다. 이미지가 없는 생체 인식 템플릿 하나가 사용자에 연결된 상태로 남으며, 그 ID는 biometric_template_uuid입니다. |
none | 세션에 삭제하거나 보존할 얼굴 임베딩이 없었습니다. |
ineligible_no_vendor_user | 보존이 요청되었지만 세션이 사용자에 연결되어 있지 않아 템플릿을 연결할 대상이 없습니다. 세션과 얼굴 임베딩은 삭제됩니다. |
failed_retryable | 이 세션과 함께 삭제가 시도된 그룹이 삭제되지 못했습니다. 스토리지 서비스, 생체 정보 저장소 또는 모니터링 제공업체를 사용할 수 없었기 때문입니다. 이 세션은 삭제되지 않았으며 여전히 남아 있습니다. 이 세션에 대해 요청을 다시 실행하십시오. 재시도는 하나의 템플릿으로 수렴합니다. |
failed_retryable로 보고됩니다. 다른 그룹에는 영향이 없으며 삭제된 상태를 유지합니다.
대량 선택은 작업으로 실행됩니다
일치하는 세션이 20개를 초과하면 응답은results 대신 삭제 작업을 담은 202 Accepted입니다:
{
"job_id": "5b8f2c1e-7d3a-4f6b-9e2c-1a0d8f7e6c5b",
"status": "PENDING",
"total": 250,
"processed": 0,
"outcomes": { "deleted": 0, "none": 0, "retained_with_user": 0, "ineligible_no_vendor_user": 0, "failed_retryable": 0, "already_deleted": 0 },
"deleted_child_verifications": 0,
"error": null,
"created_at": "2026-10-09T10:15:00Z",
"completed_at": null
}
status가 COMPLETED 또는 FAILED가 될 때까지 몇 초마다 Get Session Deletion Job을 폴링하세요.
- 작업은 각 결과별 세션 수를 보고하며, 어떤 세션을 삭제했는지는 보고하지 않습니다.
delete_all작업은 요청 이전에 생성된 세션만 삭제합니다. 작업이 실행되는 동안 시작된 세션은 삭제되지 않습니다.- 요청의 보존 및 지시 필드는 작업이 삭제하는 모든 세션에 적용됩니다.
- 그룹을 아직 삭제할 수 없으면 작업이 스스로 재시도합니다.
FAILED작업은 원인을error에 설명합니다. 작업이 도달하지 못한 세션은 그대로 남아 있으므로, 요청을 다시 보내 삭제하세요.
예제
- 숫자로 삭제
- 삭제하고 템플릿 보존
- 개인정보 삭제
- 전체 삭제 후 작업 폴링
curl -X POST https://verification.didit.me/v3/sessions/delete/ \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"session_numbers": ["1001", "1002", "1003"]}'
curl -X POST https://verification.didit.me/v3/sessions/delete/ \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"session_numbers": ["1001", "1002"],
"retain_face_embeddings": true,
"face_retention_days": 365,
"instruction_id": "post-approval-cleanup-2026-08"
}'
curl -X POST https://verification.didit.me/v3/sessions/delete/ \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"session_numbers": ["1001"],
"deletion_instruction": "privacy_erasure",
"instruction_id": "dsar-2026-0142"
}'
curl -X POST https://verification.didit.me/v3/sessions/delete/ \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"delete_all": true}'
# More than 20 sessions matched: the response is 202 with a job_id.
curl https://verification.didit.me/v3/sessions/delete/JOB_ID/ \
-H "x-api-key: YOUR_API_KEY"
204 응답에서의 마이그레이션
이 릴리스 이전에는 이 엔드포인트가204 No Content를 반환했습니다. 이제는 results[]와 함께 200 OK를, 일치하는 세션이 20개를 초과하면 삭제 작업과 함께 202 Accepted를 반환합니다. 204를 검사하는 클라이언트는 업데이트하세요. 기본 삭제 동작은 변경되지 않았습니다. 정책을 명시적으로 변경하기 전까지 기존 애플리케이션은 delete_with_session을 계속 사용합니다.
관련 문서
인증
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 를 참고하십시오.
본문
application/json
삭제할 KYC 세션의 숫자 session_number 값(숫자 전용 문자열, JSON 숫자도 허용되며 변환됨)입니다. delete_all이 true가 아닌 한 필수이며, 빈 목록은 400을 반환합니다. 숫자가 아닌 항목이 있으면 전체 요청이 400으로 거부됩니다(delete_all이 true인 경우 유효성 검사를 건너뛰고 항목을 무시함). 애플리케이션의 라이브 세션과 일치하지 않는 번호는 알림 없이 건너뜁니다.
Minimum array length:
1Pattern:
^[0-9]+$예시:
["1001", "1002", "1003"]
true인 경우 호출 애플리케이션의 나머지 모든 KYC 세션이 삭제되고 session_numbers는 무시됩니다(filter_* 키로 선택 항목을 좁히지 않는 한). 일치하는 세션이 20개를 초과하면 요청 전에 생성된 세션만 포함하는 삭제 작업(202)으로 실행됩니다. 기본값은 false입니다. 되돌릴 수 없으며 확인 단계가 없습니다.
예시:
false
이번 삭제에 대해 애플리케이션의 face_retention_policy를 재정의합니다. true는 세션이 삭제된 후에도 세션의 사용자에 연결된 이미지가 없는 얼굴 생체 인식 템플릿 하나를 유지합니다. false는 세션과 함께 얼굴 임베딩을 삭제합니다. 생략하거나 null로 설정하면 애플리케이션 정책을 따릅니다. KYB 세션 및 얼굴 임베딩이 없는 세션의 경우 무시됩니다.
예시:
true
보존된 템플릿의 유한 보존 기간(일 단위)입니다. 애플리케이션에서 이미 face_retention_days를 설정하지 않은 한 템플릿이 보존될 때 필수입니다. 템플릿의 expires_at은 이 기간, 애플리케이션의 일반 데이터 보존 기간, 그리고 face_retention_deadline 중 가장 빠른 시점으로 설정됩니다.
필수 범위:
1 <= x <= 3650예시:
365
보존된 템플릿의 선택적 강제 만료일입니다. 미래 시점이어야 합니다.
예시:
"2027-08-28T00:00:00Z"
제공하는 지시의 유형입니다. operational_session_delete는 세션을 삭제하고 정책 또는 retain_face_embeddings에 명시된 경우에만 템플릿을 보존합니다. privacy_erasure는 세션을 삭제하기 전에 세션의 사용자에 고정된 보존된 모든 생체 인식 템플릿을 제거하며, 애플리케이션 정책으로 재정의할 수 없고 retain_face_embeddings: true와 함께 사용할 수 없습니다(400).
사용 가능한 옵션:
operational_session_delete, privacy_erasure 예시:
"operational_session_delete"
이 삭제 지침에 대한 귀하의 영구 참조값입니다(예: 삭제 티켓 id). 감사 로그 및 보존되는 템플릿에 기록됩니다. 생략 시 Didit이 생성합니다.
Maximum string length:
255예시:
"dsar-2026-0142"
응답
요청에서 일치하여 처리된 세션은 최대 20개입니다. 일치하는 세션당 하나의 결과가 반환되며, 일치하는 항목이 없는 번호(알 수 없거나 이미 삭제됨)는 건너뛰고 표시되지 않습니다. face_retention_outcome이 failed_retryable인 경우를 제외하고 결과는 삭제를 확인합니다. 이 세션은 삭제되지 않았으므로 재시도해야 합니다.
Show child attributes
Show child attributes
마지막 수정일 2026년 11월 7일