IVMS101 Personal Data Fields

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.

Personal Data Fields Descriptions

Code NameDescriptionIVMS101 정보 위치

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

Last updated