메인 콘텐츠로 건너뛰기
POST
curl

개요

선택한 기업에 대해 지속적인 AML 모니터링을 켜거나 끌 수 있습니다. 이 작업은 기업 콘솔의 지속적인 AML 모니터링 작업과 정확히 같습니다. 콘솔과 이 엔드포인트는 동일한 기본 작업을 실행하므로 규칙, 과금, 결과가 같습니다. 먼저 estimate_only: true를 보내면 선택된 기업 수, 새 AML 스크리닝이 필요한 기업 수, 일회성 스크리닝 비용, 연간 모니터링 비용을 확인할 수 있습니다. 시험 실행(dry-run)은 아무것도 기록하지 않습니다. 추정 결과는 사용자 엔드포인트와 같은 필드 이름을 사용하므로 users_total은 선택된 기업의 수입니다.

선택 항목 처리 방식

  • 기업당 하나의 스크리닝만 모니터링됩니다. 여러 번 인증한 기업은 한 번만 모니터링되고 한 번만 과금됩니다. 비활성화하면 해당 기업의 모든 스크리닝에 대한 모니터링이 꺼집니다.
  • AML 스크리닝이 없는 기업은 먼저 스크리닝됩니다. Didit은 이런 기업에 대해 새 AML 인증을 만들고(기업의 인증 탭에 표시됨), 일반 AML 스크리닝과 같이 과금하며 해당 스크리닝에 모니터링을 활성화합니다. 스크리닝에는 기업의 법적 명칭(또는 표시 이름)과 국가가 사용됩니다. 이름이 전혀 없는 기업은 조용히 제외되지 않고 skipped_no_identity_data로 보고됩니다.
  • 샌드박스 애플리케이션은 스크리닝을 만들지 않습니다(skipped_sandbox).
  • 잔액은 먼저 확인합니다. 잔액이 예상 비용을 충당하지 못하면 활성화 요청은 403으로 거부되며, 응답에는 추정 결과가 포함되어 충전해야 할 금액을 알 수 있습니다.
  • 연간 갱신. 새로 모니터링되는 기업은 다음 갱신일에 연간 모니터링 가격이 청구됩니다. 이 날짜는 콘솔의 지속적인 모니터링 열에 표시되는 날짜와 같습니다. 비활성화하면 갱신이 중지되지만, 이미 청구된 기간은 환불되지 않습니다.

선택 항목과 일괄 처리 크기

vendor_data_list, didit_internal_id_list, 또는 둘 다로 기업을 선택할 수 있습니다. 두 목록은 OR로 결합됩니다. 요청에는 두 목록을 합쳐 최대 1000개의 식별자를 담을 수 있습니다. 애플리케이션의 어떤 기업과도 일치하지 않는 식별자는 보낸 그대로 unmatched에 반환되며, 요청을 실패시키지 않습니다. 일치하는 기업이 하나도 없는 선택은 total: 0인 빈 작업으로 완료되고 모든 식별자가 나열됩니다. 이는 일괄 삭제 엔드포인트와 같은 규칙입니다.

즉시 처리 또는 백그라운드 처리

기업 20개 이하를 선택하면 즉시 처리되며, 호출은 완료된 작업과 함께 200을 반환합니다. 더 큰 선택은 PENDING 작업과 함께 202를 반환합니다. status가 COMPLETED 또는 FAILED가 될 때까지 AML 모니터링 작업 조회를 주기적으로 호출하세요. 어느 경우든 작업에는 기업마다 outcome이 포함된 results 항목이 하나씩 들어 있습니다.

웹훅

모니터링 전환 자체는 웹훅을 보내지 않습니다. 모니터링이 켜진 후에는 재스크리닝 때마다 지속적인 AML 모니터링에 설명된 일반 status.updated 및 data.updated 이벤트가 발생합니다.

권한

애플리케이션의 활성 API 키라면 누구나 이 엔드포인트를 호출할 수 있습니다. Didit API 키는 역할이 아니라 애플리케이션 범위입니다. 콘솔의 역할 및 권한은 콘솔에서 사용자가 할 수 있는 작업을 결정하며, Management API 트래픽에는 적용되지 않습니다.

관련 항목

인증

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 를 참고하십시오.

본문

application/json

vendor_data_list, didit_internal_id_list 또는 둘 다를 사용하여 기업을 선택합니다(두 목록은 OR 조건으로 결합됨). 두 목록을 합쳐 요청당 최대 1,000개의 식별자까지 가능합니다.

is_enabled
boolean
필수

모니터링을 활성화하려면 true, 비활성화하려면 false입니다.

estimate_only
boolean
기본값:false

true인 경우, 예상 비용을 반환하며 쓰기 작업(스크리닝, 결제, 작업)을 수행하지 않습니다.

vendor_data_list
string[]

상태를 전환할 기업들의 귀하 고유 식별자 목록이며, 전송된 내용과 정확히 일치합니다.

didit_internal_id_list
string<uuid>[]

토글할 기업의 Didit 내부 ID입니다. 생성, 조회 및 목록 endpoint에서 반환된 didit_internal_id입니다.

응답

견적(estimate_only가 true인 경우) 또는 인라인으로 처리된 선택 항목에 대한 완료된 작업입니다.

예상 비용입니다. estimate_only가 true인 경우 직접 반환됩니다(아무것도 기록되지 않음).

users_total
integer
필수

선택 조건과 일치하는 프로필 수입니다.

already_enabled
integer
필수

이미 모니터링 중인 프로필(활성화 시 수행할 작업 없음. 비활성화 시 해제되는 대상임).

with_existing_aml
integer
필수

기존 AML 스크리닝이 모니터링 상태로 전환될 프로필 수(신규 스크리닝 없음).

needing_screening
integer
필수

AML 스크리닝 이력이 없어 먼저 스크리닝을 진행할 프로필 수(일반 AML 스크리닝으로 청구됨).

skipped_no_identity_data
integer
필수

신원 데이터가 누락되어 스크리닝할 수 없는 프로필 수입니다.

skipped_blocked
integer
필수

건너뛸 차단된 사용자 수입니다(기업의 경우 항상 0).

estimated_screening_cost_usd
number
필수

새 스크리닝의 일회성 비용입니다.

예시:

0.2

estimated_annual_monitoring_cost_usd
number
필수

모니터링 대상이 될 프로필의 연간 모니터링 비용입니다.

예시:

0.07

balance_sufficient
boolean
필수

조직 잔액이 스크리닝과 첫해 모니터링 비용을 충당할 수 있는지 여부입니다.

unmatched
string[]
필수

이 애플리케이션의 어떤 프로필과도 일치하지 않는 요청의 식별자로, 전송된 형태 그대로입니다.

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