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 |
Last updated