메인 콘텐츠로 건너뛰기
POST
Python
입력한 식별자와 사용자가 주장하는 신원 속성을 제출하고, 실행할 검사를 선택한 뒤 각 결과를 개별적으로 확인합니다. 입력 요건과 예상 과금을 먼저 확인하려면 사기 검사 계획을 사용하십시오.

프로필 선택

선택한 기본값과 결정 정책이 명확하도록 profile_version을 고정하십시오. 기본 프로필은 standard이며 버전은 2026-08-27입니다. 2026-09-14 버전은 선택 사항인 이메일 및 전화번호 소셜 데이터 보강을 추가하고, 완료된 모든 검사를 기본 사용자 인증 세션으로 기록합니다. 이 버전에서 유료 부가 기능은 옵트인 방식입니다. 2026-09-14.1 버전은 Enterprise 요금제를 사용하면서 글로벌하게 공유하는 조직을 대상으로 글로벌 사기 네트워크 식별자 조회도 활성화합니다. 2026-09-14.2 버전은 브라질용 선택 사항인 셀피-CPF 참조 검사를 추가합니다. 이전 버전은 원래 동작을 유지합니다. 현재 프로필은 이메일 위험, 전화번호 위험, IP 위험, 해당하는 데이터베이스 검증, 그리고 귀사 애플리케이션의 비공개 네트워크 이력을 지원합니다. 셀피 기반 신원 결합에는 2026-09-14.2 버전이 필요합니다. 이전 버전에서 이를 선택하면 not_available_in_profile_version이 반환됩니다.

주장된 신원 및 맥락

이메일, 전화번호, 정부 식별자는 subject.identifiers에 넣으십시오. 정부 식별자에는 발급 국가가 필요하며, 번호가 지역 내에서만 고유한 경우에는 발급 기관도 필요할 수 있습니다. 이름, 생년월일, 국적, 주소는 subject.attributes에 넣으십시오. 이 값들은 선택한 데이터 소스가 지원하는 범위에서 비교할 주장 값이며, 제출되었다는 사실만으로 검증된 정보가 되지는 않습니다. context에는 검증 시도의 IP 주소, 사용자 에이전트, 목적, 국가, 그리고 필요한 동의 확인 정보를 넣으십시오. 이렇게 하면 검증 시도에 관한 정보와 사람에 관한 정보가 분리됩니다. 지원되는 생체 검사의 경우, subject.selfie에 base64로 인코딩된 JPEG, PNG 또는 WebP 이미지를 최대 6MB까지 제공하십시오. 일치하는 이미지 데이터 URI도 허용됩니다. 참조 이미지, 원격 URL, 스토리지 키는 보내지 마십시오.

셀피와 주장된 식별자

biometric_identity를 선택하고, 브라질 tax_number 식별자와 셀피를 제출한 뒤 context.consent_obtained를 확인하십시오. 참조 검사는 해당 셀피가 주장된 CPF 소유자의 것인지 확인합니다. 동의가 없으면 consent_required가, 지원되지 않는 국가이면 unsupported_region이 반환됩니다. 이 모듈은 귀사 조직의 데이터베이스 검증 요금을 기준으로 한 확인 건당 가격이 적용됩니다. 실행하기 전에 요금제를 확인하십시오. 참조 검사가 응답하면 identity_relationship.result는 match, mismatch, inconclusive 중 하나가 됩니다. 불확정 응답은 검토가 필요하며, 불일치로 처리해서는 안 됩니다. 결과는 셀피와 CPF의 관계만 확인합니다. 제출된 이름이나 생년월일을 검증하지 않으며, 라이브니스를 입증하지 않고, 인터넷 또는 글로벌 사기 네트워크에서 얼굴을 검색하지도 않습니다. 다른 선택된 소스가 해당 필드에 대한 증거를 제공하지 않는 한, 이름과 생년월일은 여전히 주장 값입니다. 시간 초과와 소스 오류는 사용 불가 결과로 처리되며 과금되지 않습니다. 완료된 불확정 응답은 동일한 참조 검사 요금으로 과금됩니다. 이 검사는 셀피를 결과에 포함하지 않으며, 세션 미디어로 저장하지도 않습니다.

검사 선택

checks.include는 모듈을 선택하며, checks.exclude가 우선합니다. 명시적으로 빈 include 목록을 지정하면 선택 사항인 모든 작업이 비활성화되며, 정규화는 계속 실행됩니다. include를 생략하면 고정된 프로필의 기본값이 사용됩니다. 이메일 및 전화번호 소셜 데이터 보강은 email_social과 phone_social로 별도로 선택합니다. 이들은 유효하고 일치하는 식별자가 필요하며, OTP를 보내지 않습니다.

결과를 뒤섞지 않고 읽기

각 모듈은 실행 상태, 사유, 과금 단위를 보고합니다. not_requested, excluded_by_caller, missing_required_input, source_unavailable은 서로 다른 결과를 나타냅니다. 소스가 없다는 것은 신원 불일치나 위험 없음(0)을 뜻하지 않습니다. attribute_evidence는 필드 수준의 증거를 나타내며, risk는 신원, 연락처, 기기, 행동, 사기 네트워크 차원을 분리하여 보여 줍니다. 이메일, 기기, 또는 기타 식별자가 공유되는 것은 관찰된 연결일 뿐이며, 두 계정이 같은 사람에게 속한다거나 사기를 저질렀다는 증거가 아닙니다. recommendation은 해당 검사의 권고 사항이며, 다른 레코드의 상태를 변경하지 않습니다. 소셜 데이터 보강 결과는 enrichment 아래에 표시되며, 사용 불가 결과는 완료된 결과와 구분됩니다.

글로벌 사기 네트워크

networks_cross_org를 선택하면 지원되는 이메일, 전화번호, 올바르게 네임스페이스가 지정된 문서 식별자를 공유 네트워크에 대해 조회합니다. 이 조회에는 Enterprise 요금제와 조직의 공유 모드를 global로 설정해야 합니다. 이 조건이 충족되지 않으면 요금제는 해당 모듈을 available: false와 availability_reason: "entitlement_required"로 보고합니다. 이 모듈을 선택한 검사는 상태 skipped와 사유 entitlement_required로 건너뜁니다. 조직에서 Networks가 활성화되어 있지 않은 경우에도 같은 사유가 적용됩니다. 샌드박스 애플리케이션은 요금제나 공유 모드의 제한을 받지 않습니다. 지원되는 식별자를 사용하면 모듈이 실행되고 빈 샘플 결과를 반환합니다. 이 조회는 기존 조직 읽기 한도를 사용하며, 읽기 작업을 감사 로그에 기록합니다. 조회당 별도의 요금은 없습니다. 검사를 계획하는 것만으로는 공유 인덱스를 조회하지 않으며 읽기 한도도 사용하지 않습니다. network.cross_organization에는 검사가 완료되면 signals_checked와 공개된 집계 insights가 포함됩니다. 각 인사이트에는 신호 유형, 결과 분류, 기여자 수, 최근성 구간이 포함되며, 공개가 활성화된 경우에만 업종 분류가 포함됩니다. 다른 조직, 계정, 개인 또는 인증을 식별하지 않습니다. 공개 임계값 미만의 결과는 생략됩니다. 빈 목록은 사기 이력이 없다는 것을 증명하지 않습니다. 공개된 공유 신호는 검토 권고를 발생시킵니다. 자동 거부나 신원 일치를 발생시키지 않습니다. 조회를 사용할 수 없는 사유는 조회가 완료되었지만 결과가 비어 있는 경우와 별도로 보고됩니다. 나중에 조직이 교차 조직 액세스 권한을 잃으면(예: 요금제 변경 또는 공유 모드가 더 이상 global이 아닌 경우), 결과 조회, 재시도, 세션 세부 정보에서 공유 집계와 그로부터 파생된 위험 근거가 숨겨집니다. 원래의 권고는 과거 결정으로 남으며, 읽기 작업은 인증 상태를 변경하지 않습니다.

세션, 재시도 및 요금

check_id는 Fraud Check 조회를 통해 저장된 결과를 가져옵니다. request_id가 있으면 해당 네이티브 인증 세션을 식별합니다. 버전 2026-09-14, 2026-09-14.1, 2026-09-14.2에서는 비공개 네트워크 이력만 선택된 경우에도 항상 해당 세션을 생성합니다. client_reference를 같은 요청 본문과 함께 재사용하면, 해당 검사가 존재하는 동안 다시 실행하거나 요금을 청구하지 않고 원래 결과를 반환합니다. 같은 참조에 다른 본문을 보내면 409가 반환됩니다. 실행이 아직 진행 중이면, 응답의 Retry-After 간격이 지난 후 같은 요청을 다시 시도하십시오. 연결된 인증을 삭제하면 Fraud Check 결과도 삭제되며, 이후 조회는 404를 반환합니다. 실행 중에 삭제된 검사는 완료된 결과를 게시할 수 없습니다. 가격은 조직의 현재 선불 또는 계약 요율에 따릅니다. 사용할 수 없거나 건너뛴 모듈은 과금되지 않으며, 비공개 네트워크 이력에는 검사당 요금이 없습니다. 샌드박스 검사는 유료 공급업체 호출이나 요금 없이 샘플 응답을 사용합니다.

인증

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

본문

subject
object
필수
client_reference
string

이 검사에 대한 귀하 고유의 참조값입니다. 멱등성 키 역할을 겸합니다. 동일한 본문으로 재사용하면 모듈을 다시 실행하거나 비용을 청구하지 않고 원래 검사 결과를 반환하며, 다른 본문으로 재사용하면 409를 반환합니다.

Required string length: 1 - 255
profile
string
기본값:standard

오케스트레이션 프로필 ID입니다. Didit standard 프로필이 기본값으로 사용됩니다.

Required string length: 1 - 64
profile_version
string

동결된 프로필 버전을 고정합니다. 기본값은 프로필의 현재 버전입니다.

Required string length: 1 - 32
context
object
checks
object
vendor_data
string
Maximum string length: 1000
metadata
any

응답

check_id
string<uuid>
필수
client_reference
string | null
필수
processing_status
enum<string>
필수
  • pending - 대기 중
  • running - 실행 중
  • completed - 완료됨
  • failed - 실패함
사용 가능한 옵션:
pending,
running,
completed,
failed
profile_id
string
필수
profile_version
string
필수
created_at
string<date-time>
필수
completed_at
string<date-time> | null
필수
inputs
object[]
필수
modules
object[]
필수
attribute_evidence
object[]
필수
compound_evidence
object[]
필수
risk
object[]
필수
network
object
필수
recommendation
enum<string>
필수
  • approve - 승인
  • review - 검토
  • reject - 거부
사용 가능한 옵션:
approve,
review,
reject
next_action
enum<string>
필수
  • none - 없음
  • manual_review - 수동 검토
  • step_up - 추가 인증
  • resubmit_capture - 캡처 재제출
사용 가능한 옵션:
none,
manual_review,
step_up,
resubmit_capture
decision_reasons
string[]
필수
coverage
object
필수
usage
object[]
필수
request_id
string<uuid>

이 검사를 위해 생성된 네이티브 인증 세션입니다.

enrichment
object
identity_relationship
object | null
vendor_data
string | null
metadata
unknown
마지막 수정일 2026년 11월 7일