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

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

Path Parameter

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

Request

이름	필수 여부	타입
currency	필수	string
payload	필수	string
address	옵션	string
tag	옵션	string
network	옵션	string

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

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

address: 수신인의 지갑주소를 입력합니다. 타 솔루션사와 연동되어 있는 VASP는 필수로 요청할 수 있으니, 타 프로토콜과의 상호운용 페이지를 참고해주세요.

tag: Tag 혹은 Memo가 존재하는 경우 작성합니다. (예. XRP) 타 솔루션사와 연동되어 있는 VASP는 필수로 요청할 수 있으니, 타 프로토콜과의 상호운용 페이지를 참고해주세요.

network: 하나의 코인이 여러 네트워크 위에 존재 할 때 구분을 위해 작성합니다. 타 솔루션사와 연동되어 있는 VASP는 필수로 요청할 수 있으니, 타 프로토콜과의 상호운용 페이지를 참고해주세요.


{
  "currency": "XRP",
  "address": "TestXrpAddress",
  "tag": "1000001",
  "network": "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 인증을 진행하지 않은 경우입니다.

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

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

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

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

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

가상자산 주소 조회

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

Path Parameter

Request

Response

Example