IVMS101 사용자 개인 정보 종류 코드

Beneficiary VASP(수신 VASP)에서는 사용자 검증을 수행하고 requiredBeneficiaryInfo에 지정된 수취인 개인 정보를 반드시 기입해서 반환해야 합니다.

만약, Beneficiary VASP에서 requiredBeneficiaryInfo에 지정된 Beneficiary 개인 정보를 반환할 수 없을 경우에는 result를 DENIED, reason을 UNAVAILABLE-INFORMATION로 반환해야 합니다.

반대로, 수취 VASP 입장에서 송신인(originator)에 대한 검증을 수행하기에는 개인 정보가 부족하다면, result 필드는 DENIED로 설정하고, reason 필드에는 LACK-OF-INFORMATION 코드를 기입합니다. 그리고, message 필드에는 검증에 필요한 추가적인 개인 정보 코드 목록을 쉼표로 구분하여 string으로 반환합니다.

LACK-OF-INFORMATION 에러 코드를 전달받은 Originating VASP(송신 VASP)에서는 message 필드에 기입되어 있는 개인 정보 코드에 해당하는 송신자 개인 정보를 추가하여, 새로운 사용자 검증 API를 전송하면 됩니다.

사용자 개인 정보 코드

Code Name	Description	IVMS101 정보 위치
ACCOUNT_NUMBER*	- 지갑 주소 (필수)	- Originator.accountNumber - Beneficiary.accountNumber
NATURAL_PERSON_DATE_AND_PLACE_OF_BIRTH	- 생년월일과 출생지 - 출생지 정보가 없는 경우 집 주소	- Originator.originatorPersons[0].naturalPerson.dateAndPlaceOfBirth - Beneficiary.beneficiaryPersons[0].naturalPerson.dataAndPlaceOfBirth
NATURAL_PERSON_NAME*	- 원칙적으로는 영문명 - 국내 VASP 끼리 거래 시에는 국문 이름을 전달해도 무방	- Originator.originatorPersons[0].naturalPerson.name.nameIdentifier - Beneficiary.beneficiaryPersons[0].naturalPerson.name.nameIdentifier
LOCAL_NATURAL_PERSON_NAME	- 로컬 이름 (e.g. 한국어) - localNameIdentifier에 기재 - nameIdentifier도 필수로 기재 (영문명)	- Originator.originatorPersons[0].naturalPerson.name.localNameIdentifier - Beneficiary.beneficiaryPersons[0].naturalPerson.name.localNameIdentifier
NATURAL_PERSON_NATIONALITY	- 국적	- Originator.originatorPersons[0].naturalPerson.nationality - Beneficiary.beneficiaryPersons[0].naturalPerson.nationality
NATURAL_PERSON_GEOGRAPHIC_ADDRESS	- 지리적 주소 (영문) - 국내 VASP 끼리 거래 시에는 국문으로 전달해도 무방	- Originator.originatorPersons[0].naturalPerson.geographicAddress - Beneficiary.beneficiaryPersons[0].naturalPerson.geographicAddress
NATURAL_PERSON_NATIONAL_IDENTIFICATION	- 주민 번호	- Originator.originatorPersons[0].naturalPerson.nationalIdentification <- Beneficiary.beneficiaryPersons[0].naturalPerson.nationalIdentification/p>
NATURAL_PERSON_CUSTOMER_IDENTIFICATION	- 고객 번호 - VASP 내부에서 부여한 고유한 고객 번호	- Originator.originatorPersons[0].naturalPerson.customerIdentification - Beneficiary.beneficiaryPersons[0].naturalPerson.customerIdentification
NATURAL_PERSON_COUNTRY_OF_RESIDENCE	- 거주국 - 2글자 국가 코드로 입력	- Originator.originatorPersons[0].naturalPerson.countryOfResidence - Beneficiary.beneficiaryPersons[0].naturalPerson.countryOfResidence
LEGAL_PERSON_NAME*	- 법인 영문명 - 국내 VASP 끼리 거래 시에는 국문 이름을 전달해도 무방	- Originator.originatorPersons[0].legalPerson.name.nameIdentifier - Beneficiary.beneficiaryPersons[0].legalPerson.name.nameIdentifier
LOCAL_LEGAL_PERSON_NAME	- 법인 로컬 이름. (e.g. 한국어) - localNameIdentifier에 기재 - nameIdentifier도 필수로 기재 (영문명)	- Originator.originatorPersons[0].legalPerson.name.localNameIdentifier - Beneficiary.beneficiaryPersons[0].legalPerson.name.localNameIdentifier
CORPORATE_REPRESENTATIVE_NAME*	- 법인 대표자 영문명 - 국내 VASP 끼리 거래 시에는 국문 이름을 전달해도 무방 - beneficiaryPersons 혹은 originatorPersons의 두 번째 원소에 대표자 정보 기입	- Originator.originatorPersons[1].naturalPerson.name.nameIdentifier - Beneficiary.beneficiaryPersons[1].naturalPerson.name.nameIdentifier
LOCAL_CORPORATE_REPRESENTATIVE_NAME	- 법인 대표자 로컬 이름 (e.g. 한국어) - localNameIdentifier에 기재 - nameIdentifier도 필수로 기재 (영문명)	- Originator.originatorPersons[1].naturalPerson.name.localNameIdentifier - Beneficiary.beneficiaryPersons[1].naturalPerson.name.localNameIdentifier
CORPORATE_REPRESENTATIVE_DATE_AND_PLACE_OF_BIRTH	- 법인 대표자 생년월일과 출생지 - 출생지 정보가 없으면 집 주소	- Originator.originatorPersons[1].naturalPerson.dateAndPlaceOfBirth - Beneficiary.beneficiaryPersons[1].naturalPerson.dateAndPlaceOfBirth
CORPORATE_REPRESENTATIVE_NATIONALITY	- 법인 대표자 국적	- Originator.originatorPersons[1].naturalPerson.nationality - Beneficiary.beneficiaryPersons[1].naturalPerson.nationality
HEAD_OFFICE_GEOGRAPHIC_ADDRESS	- 법인 본점 소재지 주소 - geographicAddress 배열 첫 번째 원소로 기재	- Originator.originatorPersons[0].legalPerson.geographicAddress[0] - Beneficiary.beneficiaryPersons[0].legalPerson.geographicAddress[0]
BRANCH_OFFICE_GEOGRAPHIC_ADDRESS	- 법인 사업장 소재지 주소 - geographicAddress 배열 두 번째 원소로 기재 - 사업장이 여러 개일 경우에는 geographicAddress 배열 세 번째 원소부터 추가로 기재할 수 있음 - 본점 주소와 사업장 주소가 같은 경우에도 중복으로 기재	- Originator.originatorPersons[0].legalPerson.geographicAddress[1] - Beneficiary.beneficiaryPersons[0].legalPerson.geographicAddress[1]
LEGAL_PERSON_CUSTOMER_IDENTIFICATION	- 법인 고객 번호 - VASP 내부에서 부여한 고유한 고객 번호	- Originator.originatorPersons[0].legalPerson.customerIdentification - Beneficiary.beneficiaryPersons[0].legalPerson.customerIdentification
LEGAL_PERSON_NATIONAL_IDENTIFICATION	- 사업자 등록 번호 등 법인 식별 번호	- Originator.originatorPersons[0].legalPerson.nationalIdentification - Beneficiary.beneficiaryPersons[0].legalPerson.nationalIdentification
LEGAL_PERSON_COUNTRY_OF_REGISTRATION	- 법인 등록을 한 국가 - 2 글자 국가 코드로 입력	- Originator.originatorPersons[0].legalPerson.countryOfRegistration - Beneficiary.beneficiaryPersons[0].legalPerson.countryOfRegistration
LEGAL_PERSON_DATE_OF_INCORPORATION	- 법인 설립 날짜 - YYYY-MM-DD 형식으로 입력	- Originator.originatorPersons[0].legalPerson.dateOfIncorporation - Beneficiary.beneficiaryPersons[0].legalPerson.dateOfIncorporation