가상 자산 주소 조회

가상 자산을 수신하는 주소가 CODE 내 소속 VASP 의 소유인지 확인을 요청합니다.

POST /v1/code/VerifyAddress/{BeneficiaryVaspEntityId}

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

이미 수신 가상 가산 주소가 어느 VASP 소속인지를 알고 있는 경우 이 단계를 생략할 수 있지만, 이 API 를 사용하여 해당 주소가 특정 VASP 소속이 맞는지 확인할 것을 권장합니다.

v1.6 부터는 '가상 자산 주소 조회' API 에서도 수취인 이름 검증을 지원하지만, 구현명세 버전이 낮은 거래소에서는 기대하는 답변을 받지 못합니다.

Path Parameter

• BeneficiaryVaspEntityId: 가상 자산을 수신하는 주소를 소유하는 VASP 의 EntityID 입니다.

REQUEST Body Schema: application/jsonRequest

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

• payload(Required): 개인정보를 담는 ivms101 메시지를 담는 객체입니다. payload 는 JSON String 을 암호화해서 보냅니다.

  • ivms101(Required):

    • Beneficiary(Required): 수취인의 이름, 지갑 주소 정보를 담기 위한 객체입니다.

      • beneficiaryPersons(Optional): VASP 를 지정해서 조회하는 경우에 한하여, 수취인의 이름 검증을 요청할 수 있습니다. '자산 이전 허가 요청' API 의 메시지 형식을 참고해 주세요.

      • accountNumber(Required): 자산을 수신하는 가상 자산 주소입니다. tag 나 memo 같은 2차 주소는 ':' 구분자 뒤에 붙입니다.

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

Response

200 OK

RESPONSE SCHEMA: application/json

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

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

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

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

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

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

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

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

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

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

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

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

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

{
  "result": "invalid",
  "reasonType": "NOT_FOUND_ADDRESS",
  "reasonMsg": "",
  "beneficiaryVaspEntityId": "string"
}