가상자산을 전송하려는 VASP 는 전체 과정의 첫 단계에서 이 API 를 사용하여 수취인(beneficiary)의 가상자산의 주소(address + tag(optional))가 어느 VASP 의 소유인지 알아야 합니다.

❗️동기 방식으로 작동하는 API로 요청 후 즉시 응답을 받을 수 있습니다.

Path Parameter

이름	필수 여부	타입	설명
BeneficiaryVaspEntityId	필수	string	수신 지갑을 소유하는 VASP의 entityId

Request

이름	필수 여부	타입
currency	필수	string
payload	필수	string

currency: 이전하려는 가상자산의 심볼로 대소문자를 구분하지 않습니다.

payload: IVMS101객체를 암호화한 string으로 지갑 주소만 검증하기 때문에 전체 IVMS101 객체를 다 입력하지 않아도 됩니다. 아래의 Sample payload와 같이 Beneficiary 객체 내에 array<accountNumber>는 필수, beneficiaryPersons는 옵션입니다.


{
  "currency": "XRP",
  "payload": "encrypted ivms101 payload"
}

{
   "ivms101": {
      "Beneficiary": {
        "beneficiaryPersons": [],
        "accountNumber": ["rHcFoo6a9qT5NHiVn1THQRhsEGcxtYCV4d:memo or tag"]
      }
   }
}

Response

이름	필수 여부	타입
result	필수	string
reasonType	옵션	string
reasonMsg	옵션	string
beneficiaryVaspEntityId	필수	string

result: 가상자산 주소 검증 결과입니다.

-valid: 정상적인 주소일 때 반환됩니다.

-invalid: 요청을 실패한 결과 반환됩니다. reasonType 값으로 상세 내용을 구분할 수 있습니다.

reasonType: result 필드값이 invalid 인 경우에 이 필드가 추가 됩니다.

-NOT_FOUND_ADDRESS: 가상자산 주소를 찾을 수 없는 경우입니다.

-NOT_SUPPORTED_SYMBOL: 거래할 수 없는 화폐 심볼입니다.

-NOT_KYC_USER: 수신 주소의 소유자가 KYC 인증을 진행하지 않은 경우입니다.

-INPUT_NAME_MISMATCHED: 요청 메시지로 전송한 수취인 이름이 실제 소유자의 이름과 일치하지 않는 경우입니다.

-SANCTION_LIST: 가상자산 주소 또는 소유자가 수신VASP 의 제재 대상입니다.

-LACK_OF_INFORMATION: 자산 이전을 결정하는데 필요한 정보가 없는 경우입니다.

-UNKNOWN: 그 밖에 다른 이유입니다.

reasonMsg: invalid 인 경우 상세 메시지를 정의합니다.

beneficiaryVaspEntityId: 조회 대상 가상자산 주소를 소유하는 VASP가 존재하는 경우 해당 VASP 의 Entity ID 입니다.

가상자산 주소 조회

Path Parameter

Request

Response

Example