IVMS101 Personal Data Fields
Last updated
Last updated
Beneficiary VASP should do user verification and return the result containing the designated personal data fields of the beneficiary in requiredBeneficiaryInfo field.
If the VASP cannot return the personal information of the beneficiary, the verification result must be DENIED, the reason to be UNAVAILABLE-INFORMATION.
Similarly, in case of verification denial due to lack of originator's personal information, the denial reason will be returned as of LACK-OF-INFORMATION.
The message field needs to contain a list of comma-separated personal data fields which are required to process the verification. Then the originating VASP can retry by adding the listed fields of data and sending a new API request.
Code Name | Description | IVMS101 정보 위치 |
---|---|---|
ACCOUNT_NUMBER*
- Wallet address (Required)
- Originator.accountNumber
-Beneficiary.accountNumber
NATURAL_PERSON_DATE_AND_PLACE_OF_BIRTH
- Date and place of birth
- Fill with an address of residence instead of birthplace if not available
- Originator.originatorPersons[0].naturalPerson.dateAndPlaceOfBirth
- Beneficiary.beneficiaryPersons[0].naturalPerson.dataAndPlaceOfBirth
NATURAL_PERSON_NAME*
- Name in English - Domestic VASPs can share an name in domestic language
- Originator.originatorPersons[0].naturalPerson.name.nameIdentifier
- Beneficiary.beneficiaryPersons[0].naturalPerson.name.nameIdentifier
LOCAL_NATURAL_PERSON_NAME
- Name in local language (e.g. Korean)
- localNameIdentifier
- nameIdentifier is required field (English name)
- Originator.originatorPersons[0].naturalPerson.name.localNameIdentifier
- Beneficiary.beneficiaryPersons[0].naturalPerson.name.localNameIdentifier
NATURAL_PERSON_NATIONALITY
- Nationality
- Originator.originatorPersons[0].naturalPerson.nationality
- Beneficiary.beneficiaryPersons[0].naturalPerson.nationality
NATURAL_PERSON_GEOGRAPHIC_ADDRESS
- Address in English
- Domestic VASPs can share an address in domestic language
- Originator.originatorPersons[0].naturalPerson.geographicAddress
- Beneficiary.beneficiaryPersons[0].naturalPerson.geographicAddress
NATURAL_PERSON_NATIONAL_IDENTIFICATION
- National identifier numbers
- Originator.originatorPersons[0].naturalPerson.nationalIdentification
<- Beneficiary.beneficiaryPersons[0].naturalPerson.nationalIdentification/p>
NATURAL_PERSON_CUSTOMER_IDENTIFICATION
- Customer ID
- Customer ID or number assigned by VASP
- Originator.originatorPersons[0].naturalPerson.customerIdentification
- Beneficiary.beneficiaryPersons[0].naturalPerson.customerIdentification
NATURAL_PERSON_COUNTRY_OF_RESIDENCE
- Country of residence
- Alpha-2 country code (2 letters, KR for example)
- Originator.originatorPersons[0].naturalPerson.countryOfResidence
- Beneficiary.beneficiaryPersons[0].naturalPerson.countryOfResidence
LEGAL_PERSON_NAME*
- Legal name of individual or corporate
- Domestic VASPs can share domestic name
- Originator.originatorPersons[0].legalPerson.name.nameIdentifier
- Beneficiary.beneficiaryPersons[0].legalPerson.name.nameIdentifier
LOCAL_LEGAL_PERSON_NAME
- Legal name in local language
- localNameIdentifier
- nameIdentifier is required (Legal name in English)
- Originator.originatorPersons[0].legalPerson.name.localNameIdentifier
- Beneficiary.beneficiaryPersons[0].legalPerson.name.localNameIdentifier
CORPORATE_REPRESENTATIVE_NAME*
- Name of corporate representative in English
- Domestic VASPs can share the name in domestic language
- Fill the beneficiaryPersons field or the second element of originatorPersons
- Originator.originatorPersons[1].naturalPerson.name.nameIdentifier
- Beneficiary.beneficiaryPersons[1].naturalPerson.name.nameIdentifier
LOCAL_CORPORATE_REPRESENTATIVE_NAME
- Name of corporate representative in local language(e.g. Korean)
- localNameIdentifier
- nameIdentifier is required (Name in English)
- Originator.originatorPersons[1].naturalPerson.name.localNameIdentifier
- Beneficiary.beneficiaryPersons[1].naturalPerson.name.localNameIdentifier
CORPORATE_REPRESENTATIVE_DATE_AND_PLACE_OF_BIRTH
- Date and place of birth of corporate representative
- Fill with an address of residence instead of birthplace if not available
- Originator.originatorPersons[1].naturalPerson.dateAndPlaceOfBirth
- Beneficiary.beneficiaryPersons[1].naturalPerson.dateAndPlaceOfBirth
CORPORATE_REPRESENTATIVE_NATIONALITY
- Nationality of corporate representative
- Originator.originatorPersons[1].naturalPerson.nationality
- Beneficiary.beneficiaryPersons[1].naturalPerson.nationality
HEAD_OFFICE_GEOGRAPHIC_ADDRESS
- Geographic address of headquarter
- The first element of geographicAddress array
- Originator.originatorPersons[0].legalPerson.geographicAddress[0]
- Beneficiary.beneficiaryPersons[0].legalPerson.geographicAddress[0]
BRANCH_OFFICE_GEOGRAPHIC_ADDRESS
- Geographic address of branch office
- The second element of geographicAddress array
- Fill from 3rd element of geographicAddress 배for additional branches
- Fill this field even in case of that the branch office address is same with HQ address
- Originator.originatorPersons[0].legalPerson.geographicAddress[1]
- Beneficiary.beneficiaryPersons[0].legalPerson.geographicAddress[1]
LEGAL_PERSON_CUSTOMER_IDENTIFICATION
- Legal corporate customer ID
- The customer Id is assigned by the VASP
- Originator.originatorPersons[0].legalPerson.customerIdentification
- Beneficiary.beneficiaryPersons[0].legalPerson.customerIdentification
LEGAL_PERSON_NATIONAL_IDENTIFICATION
- Legal identifier, nationally granted ID
- Originator.originatorPersons[0].legalPerson.nationalIdentification
- Beneficiary.beneficiaryPersons[0].legalPerson.nationalIdentification
LEGAL_PERSON_COUNTRY_OF_REGISTRATION
- Country code of registration
- Alpha-2 country code (2 letters, KR for example)
- Originator.originatorPersons[0].legalPerson.countryOfRegistration
- Beneficiary.beneficiaryPersons[0].legalPerson.countryOfRegistration
LEGAL_PERSON_DATE_OF_INCORPORATION
- Date of incorporation
- YYYY-MM-DD format
- Originator.originatorPersons[0].legalPerson.dateOfIncorporation
- Beneficiary.beneficiaryPersons[0].legalPerson.dateOfIncorporation