단일 검증 결과 조회 API
단일 검증 결과 조회
GET
http://<enclave-endpoint>/v1/verifications/:uuid
verificationUuid로 단일 검증 이력을 조회할 수 있습니다.
Response Body
성공 케이스
verificationUuid
string
true
"4615aa9d-ac64-4997-a9e6-0e772c57c7ef"
사용자 검증 요청 아이디
result
string
false
"VERIFIED"
사용자 검증 수행 결과. (하단 설명 참조)
reason
string
false
"OK"
검증이 실패한 경우에 그 이유를 나타내는 에러 코드 (하단 설명 참조). 성공적인 경우에는 "OK"
assetInfo
object
true
-
전송할 가상 자산에 대한 정보
assetInfo.symbol
string
true
“ETH”
VA. Virtual Asset. 전송할 가상 자산 심벌
assetInfo.network
string
false
"Ethereum"
가상 자산이 배포되어 있는 블록체인 네트워크 이름
assetInfo.amount
string
true
“0.024”
실제 전송할 가상 자산의 양
assetInfo.isExceedingThreshold
boolean
true
true
전송할 가상 자산의 법정 화폐 환산 금액이 법령에서 정한 금액 (1000달러 or 100만 원) 이상인지의 여부를 표시한 flag
assetInfo.tradePrice
string
true
“2439800”
전송할 가상 자산을 법정 화폐로 환산한 금액
assetInfo.tradeCurrency
string
true
“KRW”
전송할 가상 자산을 법정 화폐로 환산했을 때 사용한 화폐 코드
assetInfo.tradeISODatetime
string
true
“2022-02-06T23:13:43.513Z”
전송할 가상 자산을 법정 화폐로 환산했을 때 시세 적용 기준 시간, ISO 포맷으로 입력
txHash
string
true
“0x9fd7bfd46e4402c7197b4d8deb0199fcf7c1f57ef70c339f403a1cb060c31c28”
트랜잭션 아이디 (Transaction hash, txHash).
vout
string
false
"2"
트랜잭션 내에서 몇 번째 거래인지 구별할 수 있는 인덱스 값
originatingVaspId
string
true
"15952089931162058999"
송신 거래소 아이디
originatorAccountNumber
string
true
[”0xtest001506550d8356a215be229c15b6ef371a9a”]
송신인에 대한 계좌 번호 (지갑 주소)
ivms101Originator
string
true
"{'originatorPersons':[{'naturalPerson':{'name':{'nameIdentifier':[{'primaryIdentifier':'Taylor','nameIdentifierType':'LEGL'}]},'accountNumber':['1G3qCGKP5dQtQ7secCPTCDPU9Wfjp9x3Hb']}"
IVMS101 메시징 포맷의 송신인 정보
ivms101OriginatingVasp
string
true
"{'legalPerson':{'name':{'nameIdentifier':[{'legalPersonName':'A Exchange','legalPersonNameIdentifierType':'LEGL'}]},'geographicAddress':[{'addressType':'GEOG','postcode':'12345','townName':'Yeoksam-dong','addressLine':['Gangnam-gu, Gangbuck-do'],'country':'KR'}],'nationalIdentification':{'nationalIdentifier':'KR001','nationalIdentifierType':'RAID','registrationAuthority':'RA001'}}}"
IVMS101 메시징 포맷의 송신 거래소 정보
beneficiaryVaspId
string
true
"15952089931162058777"
수신 거래소 아이디
beneficiaryAccountNumber
string
true
[”0xtest001506550d8356a215be229c15b6ef371a9b”]
수신인에 대한 계좌 번호 (지갑 주소)
ivms101Beneficiary
string
true
"{'originatorPersons':[{'naturalPerson':{'name':{'nameIdentifier':[{'primaryIdentifier':'James','nameIdentifierType':'LEGL'}]},'accountNumber':['1G3qCGKP5dQtQ7secCPTCDPU9Wfjp9x3Hb']}"
IVMS101 메시징 포맷의 수신인 정보
ivms101BeneficiaryVasp
string
true
"{'legalPerson':{'name':{'nameIdentifier':[{'legalPersonName':'B Exchange','legalPersonNameIdentifierType':'LEGL'}]},'geographicAddress':[{'addressType':'GEOG','postcode':'12345','townName':'Yeoksam-dong','addressLine':['Gangnam-gu, Gangbuck-do'],'country':'KR'}],'nationalIdentification':{'nationalIdentifier':'KR002','nationalIdentifierType':'RAID','registrationAuthority':'RA001'}}}"
IVMS101 메시징 포맷의 수신 거래소 정보
verifiedAt
string
true
"2022-02-22T14:41:50.000Z"
사용자 검증 결과 전달받은 시간
orderedAt
Date
true
"2022-02-22T14:42:12.000Z"
트랜잭션 아이디를 리포팅 받은 시간, 또는 에러 리포팅 받은 시간
createdAt
Date
true
"2022-02-22T14:41:49.000Z"
사용자 검증 요청 시간
result 필드에는 다음과 같은 값이 들어갈 수 있습니다.
“VERIFIED”, ”DENIED”, ”UNKNOWN”, ”ERROR” 중 한 개의 값을 갖습니다.
VERIFIED: 검증이 성공적으로 끝난 경우, 사용자에게 아무런 문제가 없음을 의미합니다.
DENIED: 지갑 주소는 맞지만 사용자(송신인 포함)에게 문제가 발견된 경우 (e.g. lack of KYC credential)
UNKNOWN: 지갑 주소가 모르는 주소일 경우 (VASP가 소유하지 않은 경우)
ERROR: 기타 다른 에러가 발생한 경우
reason 필드에는 다음과 같은 값이 들어갈 수 있습니다.
단, 사용자 검증 요청에 대한 결과
result
필드의 값이 DENIED 일 때에만 유효합니다.message
필드에는, 아래 표에 설명된 값을 string으로 전달합니다. (하단 표 내용 참조)
reason
(string)
result
(string)
message
(string)
Description
UNKNOWN-SYMBOL
DENIED
심벌 이름, 해당 VASP에서 취급하지 않는다고 판명된 심벌 이름
거래소에서 취급하지 않는 심벌일 경우 (VASP가 취급하지 않는 자산일 경우)
UNKNOWN-NETWORK
DENIED
해당 VASP에서 취급하지 않는다고 판명된 네트워크 이름
거래소에서 취급하지 않는 네트워크이거나 네트워크 정보가 불충분한 경우 (심벌은 동일하지만 네트워크가 맞지 않는 경우)
UNKNOWN-ADDRESS
DENIED
해당 VASP 소유의 주소가 아니라고 판명된 지갑 주소
가상 자산 주소가 해당 VASP의 주소가 아닌 경우
LACK-OF-INFORMATION
DENIED
부족한 개인 정보 필드 코드 목록 (쉼표로 구분)
상대방 사용자의 정보가 검증을 수행하기에 부족한 경우
UNAVAILABLE-INFORMATION
DENIED
넘겨줄 수 없는 개인 정보 필드 코드 목록 (쉼표로 구분)
상대방이 요청한 개인 정보가 없거나 넘겨줄 수 없는 경우
BLACKLISTED
DENIED
-
상대방 사용자에 대한 sanction screening 결과 문제가 있는 경우
UNVERIFIED-KYC
DENIED
-
자신의 VASP의 해당 사용자가 KYC 인증이 되어 있지 않은 경우
MISMATCHED-NAME
DENIED
-
수신자의 이름이 송신 VASP에서 보내준 이름과 일치하지 않는 경우
NOT-ALLOWED
DENIED
거부 사유
송수신 VASP에서 어떤 이유로든 해당 사용자 검증 요청을 거부한 경우
UNDEFINED-ERROR
DENIED
에러 내용
그 밖에, 따로 정의되어 있지 않은 에러가 발생한 경우
BENEFICIARY-ACCOUNT-NOT-MATCHED
ERROR
-
송신자가 입력한 수신자 주소가 수신 VASP에 의해 변경되어 반환되었을 경우
REQUEST-TIMEOUT
ERROR
-
수신 VASP에서 사용자 검증 VASP API 호출이 시간 초과로 실패했을 경우
assetInfo.isExceedingThreshold 필드에는 다음과 같은 값이 들어갈 수 있습니다.
true, false 중 한 개의 값을 갖습니다.
true: 전송할 가상 자산의 법정 화폐 환산 금액이 법령에서 정한 금액 이상인 경우.
false: 전송할 가상 자산의 법정 화폐 환산 금액이 법령에서 정한 금액 미만인 경우.
실패 케이스
존재하지 않는 verification uuid를 입력한 경우
Last updated