등기부 조회
Didit은 지원되는 국가의 기업 등기부에 연결해 공식 데이터를 가져옵니다. 호스팅 플로우에서 사용자는 설립 국가를 선택하고 회사명, 등록번호 또는 둘 다를 입력합니다. 둘 중 하나는 반드시 입력해야 합니다. 등기부에서 요구하는 경우 등록번호는 정규화되며(예: 영국 회사 번호는 8자리가 되도록 앞에 0을 채웁니다), 두 식별자를 모두 제공하면 등기부 조회는 두 값을 함께 사용합니다.expected_details로 검색 미리 채우기
회사를 이미 알고 있다면 세션을 생성할 때 expected_details(company_name, registry_country, registration_number)를 전달하세요. 호스팅 플로우는 국가(주 단위 등기부의 경우 US-CA와 같이 주도 함께)를 미리 선택하고 잠그며, 일치하는 검색 필드를 미리 채우고, 지정된 검색을 자동으로 실행합니다. 사용자는 바로 자신의 회사 결과 화면으로 이동합니다. 두 필드 모두 수정할 수 있으므로 사용자는 잘못된 값을 바로잡을 수 있습니다. 이 기능은 미리 채우기만 제공하며, 지정한 회사와 다른 회사를 선택해도 경고가 표시되지 않습니다.
검색 유형
등기부 검색은 두 가지 모드를 지원합니다.검색 워크플로
등기부 조회는 비동기 워크플로를 따릅니다.검색
Didit은 선택한 국가와 입력된 식별자(회사명, 등록번호 또는 두 값을 함께)를 사용해 등기부를 조회합니다. 응답의
searched_by 필드는 결과가 어떤 방식으로 매칭되었는지 알려줍니다(name, registration_number, registration_number_and_name). 호스팅 UI는 등록번호 기반 결과에 대해 한 번의 탭으로 “회사명으로 대신 검색”하는 재정의 옵션을 제공합니다. 검색은 비동기로 실행됩니다.결과 폴링
결과가 확정될 때까지 검색 상태를 폴링하세요. 대형 등기부는 결과를 반환하는 데 몇 초가 걸릴 수 있습니다.
회사 선택
반환된 회사 목록을 검토하고 올바른 일치 항목을 선택하세요. Didit은 선택한 회사를 기업 확인(KYB)에 연결하고 사용 가능한 모든 데이터를 채웁니다.
확인 후 계속
회사 정보를 확인하거나 수정한 뒤 구성된 다음 단계로 계속 진행합니다.
일부 등기부는 소유 구조 보고서가 준비되기 전에 회사 프로필을 반환합니다. 이 보고서는 신청자가 문서 업로드처럼 독립적인 단계를 진행하는 동안 백그라운드에서 계속 처리됩니다.
등기부 미리 채우기는 주요 인물 양식을 차단하지 않습니다. 신청자는 주요 인물을 직접 입력할 수 있으며, 보고서가 도착하면 제출 전에 등기부에서 얻은 인물이 나타납니다.
보고서에 의존하는 사용자 지정 결정은 결과를 추측하지 않고 보고서가 도착할 때까지 기다립니다.
보고서가 도착해도 사용자의 수정 사항은 유지됩니다.
보고서가 대기 중인 상태는 완료된 등기부 확인이나 자동 승인으로 간주되지 않으며, 등기부 결제에는 실제로 제공된 등급이 적용됩니다.
수동 제출
회사가 등기부에서 조회되지 않으면 회사 데이터를 수동으로 제출하세요. 세션은 제공된 데이터로 계속 진행되며
is_from_registry는 false로 설정됩니다.조회되는 데이터
회사 상태
데이터 출처 표시기
각 기업 레코드에는is_from_registry 플래그가 포함됩니다:
true: 데이터를 공식 법인 등기부에서 가져왔습니다false: 기업이 등기부에서 찾을 수 없어 데이터를 수동으로 제출했습니다
fetch_status 필드는 등기부 조회가 완료되었는지, 실패했는지, 아직 진행 중인지를 추적합니다.
데이터 등급 및 요금
호스팅 흐름에서는 기업을 선택하면, 지원자가 세부 정보를 확인하기 전이나 인증을 마치기 전에 떠나더라도 등기부 조회 요금이 부과됩니다. 선택 시점에 보고서가 준비되어 있으면 제공된 등급의 요금이 즉시 부과됩니다. 소유 구조 정보가 아직 대기 중이면 선택 시점에 Lite 요금이 부과되며, 더 높은 등급이 제공될 때에는 차액만 부과됩니다. 소유 구조 정보를 사용할 수 없으면 소유 구조 추가 요금은 적용되지 않습니다. 총액은 선택 시점에 제시된 가격을 사용하며, 요청한 등급의 견적을 넘지 않습니다. 선택과 이후의 소유 구조 조정은 등기부 조회 1건으로 계산됩니다. 구매한 보고서를 읽거나 세부 정보를 확인해도 다시 과금되지 않습니다. 기존 정액 요금 계약에서는 선택 시점에 등기부 조회 1건이 계산되며, 이후 소유 구조 정보가 제공되어도 계약 단위가 추가로 차감되지 않습니다. 호스팅 워크플로 검색에는 별도의 검색 수수료가 없습니다. 독립형 API 검색은 성공한 요청당 $0.50의 수수료가 발생할 수 있습니다. 자세한 내용은 검색 과금을 참조하십시오. 국가별 전체 요금표는 KYB 등기부 요금을 참조하십시오.
호스팅 워크플로는 Workflows → KYB Registry Check → Countries에서 국가별 등급을 선택합니다. 등기부에 기업의 소유 구조 기록이 없으면, 주주 또는 UBO 등급 요청은 해당 국가의 등기부가 제공할 수 있는 가장 높은 등급으로 제공되고 그 등급으로 과금됩니다. 보통은 Lite입니다.
등기부에서 찾을 수 없어 수동으로 입력된 기업(
is_from_registry: false)에는 정액 $0.75가 부과됩니다. 등기부 기록이 반환되지 않았더라도 검색은 실행되었기 때문입니다.
예시: Lite 등급 응답
예시: Lite 등급 응답
등기부 데이터와 사용자 제공 데이터 비교
Didit은 등기부에서 반환된 데이터와 사용자가 확인한 데이터를 별도의 감사 기록으로 보관하며, 후속 검사에는 병합된 정식 보기를 사용합니다. 각 기업에는 다음 세 가지 관련 블록이 있습니다:confirmed_by_user_at 타임스탬프는 최종 사용자가 등기부 데이터를 확인하거나 수정한 시점을 나타냅니다. 이 타임스탬프가 아직 null이고 is_editable이 true이면, 최종 사용자는 호스팅 흐름 안에서 필드를 계속 수정할 수 있습니다.
수동 입력 기업(is_from_registry: false)의 경우 user_provided_data가 유일한 출처이며, 사용자가 제출한 후에는 is_editable이 false가 됩니다.
분석가는 Business Console의 세션 검토에서 두 출처를 나란히 확인하고, 등기부가 제공한 내용과 사용자가 확인한 내용의 차이를 비교할 수 있습니다.
설정 가능한 법인 등기부 양식 필드
호스팅 인증 흐름의 법인 등기부 확인 단계에서 요청할 기업 정보 필드를 직접 설정할 수 있습니다. Business Console에서 워크플로 편집기를 열고, KYB Registry check 노드를 선택한 다음 Fields 탭으로 이동해 설정하십시오. 각 필드는 다음 세 가지 상태 중 하나를 가집니다.
세 개의 필드는 항상 표시되며 항상 필수입니다. 이 필드들은 기업을 식별하므로 설정할 수 없습니다:
company_name, country_code, region(지역 또는 주/도, 법인 등기부가 지역 단위로 운영되는 경우).
설정 가능한 필드는 16개입니다.
registration_number, incorporation_date, legal_address, vat_number, alternative_names, tax_number, company_type, legal_entity_identifier, location_of_registration, nature_of_business, registered_capital_amount, registered_capital_currency, website, email, phone, control_scheme
기본적으로 그리고 기존의 모든 워크플로에서는 incorporation_date만 필수이고, 나머지 설정 가능한 필드는 모두 선택 사항입니다. 따라서 폼은 이 설정이 도입되기 전과 똑같이 동작합니다.
필수 여부는 서버에서 강제 적용됩니다. 필수 필드가 비어 있는 상태로 법인 등기부 양식을 제출하면 400 응답이 반환되며, 필드별 오류 메시지가 함께 전달됩니다. 호스팅 UI에는 활성화된 필드만 표시됩니다. 워크플로 API에서 이 설정은 KYB Registry 노드의 kyb_registry_fields_config 객체이며, 구조는 기능 설정을 참고하십시오.
vat_number가 필수로 표시되어 있더라도 EU VAT 국가에 설립된 기업에만 적용됩니다. 그 외 국가에서는 수집할 EU VAT 번호가 없으므로, 필수로 설정되어 있어도 선택 사항으로 취급됩니다. 이러한 기업의 tax_number는 제공된 경우 여전히 검증됩니다.VAT 및 납세자 번호 검증
등록 단계가 제출되면 Didit은 회사의vat_number를 해당 국가의 공식 출처와 대조하여 검증합니다.
vat_number가 없는 회사는 대신 tax_number를 검증합니다.
번호는 국가 접두사를 붙이거나 생략해서, 그리고 구분 기호를 임의로 넣어서 제출할 수 있습니다(DE 123 456 789, DE123456789, 123456789는 독일 회사의 경우 모두 같은 번호입니다).
공식 등록부. 다음 국가에서는 번호를 정부 또는 공식 사업자 등록부에서 실시간으로 확인하며, 이 등록부는 등록된 이름을 반환하고 대부분의 경우 주소도 함께 반환합니다:
프랑스 SIREN 또는 SIRET, 네덜란드 RSIN, 또는 전체 형식의 헝가리 세금 번호를 VAT 번호로 제출하면, 검증 전에 일치하는 VAT 번호로 변환됩니다.
그리스 VAT 번호는 자동으로
EL 접두사를 붙여 검증됩니다.
검사 숫자 규칙. 다음 국가에서는 어떤 등록부도 조회할 수 없으므로, 번호는 해당 국가의 공식 형식과 검사 숫자 규칙에 따라 검증됩니다: 알바니아, 안도라, 아르헨티나, 호주, 아제르바이잔, 벨라루스, 캐나다, 칠레, 중국, 도미니카 공화국, 이집트, 엘살바도르, 가나, 과테말라, 아이슬란드, 인도, 인도네시아, 이스라엘, 일본, 케냐, 리히텐슈타인, 멕시코, 몰도바, 모나코, 몬테네그로, 모로코, 모잠비크, 뉴질랜드, 북마케도니아, 페루, 러시아, 산마리노, 세르비아, 싱가포르, 남아프리카공화국, 대한민국, 대만, 태국, 튀니지, 튀르키예, 우크라이나, 영국, 미국, 우루과이, 베네수엘라, 베트남.
이 규칙은 tax_number가 독일 Steuernummer처럼 검증할 VAT 번호가 없는 국가 납세자 번호인 경우 EU에서도 적용됩니다.
tax_number는 세금 식별 번호만 나타낼 뿐 VAT 등록을 의미하지 않으므로, VIES에 해당 번호가 없으면 결과는 invalid가 아니라 이 규칙으로 대체됩니다.
그 밖의 국가 회사는 vat_validation_status: "not_applicable"을 받습니다.
샌드박스 세션도 세금 등록부에 연결하지 않으므로 같은 값을 받습니다.
결과는 회사에 저장되며 KYB 결정 payload에 노출됩니다:
vat_validation_source는 eu_vies, pl_vat_white_list, no_brreg, ch_uid_register, br_receita_federal, co_rues, cr_hacienda, ec_sri, py_dnit, format_rules 중 하나입니다.
번호가 valid, invalid, format_valid 또는 invalid_format이 되면 결과는 세션이 끝날 때까지 유지되며, 번호가 변경되지 않는 한 등록부에 다시 조회하지 않습니다.
상호명 교차 검사. 번호가 valid이고 출처가 등록된 이름을 공개하면, Didit은 이를 제출된 회사명과 퍼지 비교합니다.
의미 있는 차이가 있으면 세션 상태는 바뀌지 않고 KYB_COMPANY_VAT_NAME_MISMATCH 경고가 발생합니다. 이 경고는 검토자를 위한 약한 신호입니다.
additional_data에는 registry_name, registry_source, submitted_name이 포함되며, 출처가 VIES인 경우에는 vies_name도 포함됩니다.
일부 EU 회원국은 상호명이나 주소를 공개하지 않습니다. 이 경우 해당 필드는 비어 있게 반환되며 비교는 실행되지 않습니다.
설정 가능한 작업. KYB 등록 확인 노드의 두 설정은 확인이 실패했을 때 세션에 어떤 작업을 수행할지 결정합니다(값: REVIEW, DECLINE, NO_ACTION):
tax_number의 검증 상태가 invalid_format인 경우에는 payload에 보고되지만 작업은 발동되지 않습니다. 자유 텍스트 세금 필드에는 다른 회사 식별자가 들어 있는 경우가 많기 때문입니다.
각 결과는 등록 확인에서 해당 경고(KYB_COMPANY_VAT_INVALID, KYB_COMPANY_VAT_COULD_NOT_VALIDATE)도 함께 발생시킵니다. 자세한 내용은 기업 인증 경고를 참조하세요.
데이터 상호 참조
Didit는 사용자가 제공한 데이터/기준 데이터를 등기부가 반환한 데이터 및 업로드된 문서에서 추출한 OCR 데이터와 자동으로 비교합니다:- 회사명: 약어와 표기 형식의 차이를 고려한 퍼지 매칭
- 등록번호: 정확히 일치하는지 검증
- 국가: 제공된 국가와 등기부 국가 간의 일관성 검사
- 주소: 비교를 위한 지오코딩 및 정규화
재무 요약
사용 가능한 경우 Didit는 등기부에서 요약 재무 데이터를 가져옵니다:- 매출 또는 매출액
- 직원 수
- SIC/NACE 산업 코드
- 신고일 및 컴플라이언스 상태
추가 등기부 필드
관할 지역의 적용 범위에 따라 등기부 응답에는 다음 정보도 포함될 수 있습니다:alternative_names: 상호, DBA, 이전 법적 명칭legal_entity_identifier(LEI): 금융기관 및 상장 기업용website,email,phone: 등기부에 등록된 연락처 정보nature_of_business: 짧은 사업 설명(등기부 언어 기준)registered_capital: 수권 자본 또는 발행 자본을{amount, currency}객체로 제공
business 블록에 저장됩니다.
신뢰도 및 검증 상태
각 등기부 응답에는verification_status가 포함됩니다:
자체 후속 로직을 구현하려면
is_from_registry와 함께 사용합니다:
교차 참조 결과
각 교차 참조는 필드별로 실행되며 다음 중 하나를 반환합니다:MATCH: 제공된 데이터가 등기부와 일치합니다.MISMATCH: 의미 있는 차이가 있습니다. 경고로 표시됩니다.NO_DATA: 한쪽 데이터가 비어 있어 비교할 수 없습니다.
결과를 좌우하는 요인
회사 상태, 설립 국가, AML 결과, 신고된 데이터와의 일치 여부는 경고 태그로서 등기부 확인과 AML 스크리닝에 반영되어 결정에 영향을 줍니다. 각 경고를 승인, 검토 또는 거부할지는 워크플로에서 결정합니다. 신호와 이를 제어하는 워크플로 키는 위험 평가를 참조하십시오.지원 국가
적용 범위는 국가마다 다릅니다. 지역별 등급 세부 내역은 지원 국가를 참조하십시오.다음 단계
소유 구조
UBO 식별 및 소유 체인.
응답 스키마
페이로드에서 각 필드가 나타나는 위치.
지원 국가
지역별 적용 범위.