단일 검증 결과 조회 API

단일 검증 결과 조회

GET http://<enclave-endpoint>/v1/verifications/:uuid

verificationUuid로 단일 검증 이력을 조회할 수 있습니다.

Response Body

성공 케이스

Response Body Examples

• 200 OK

{
  "verificationId": "10",
  "verificationUuid": "5c9f6f44-1e09-483b-a9f5-5950b1cbae08",
  "result": "VERIFIED",
  "reason": "OK",
  "message": "",
  "assetInfo": {
    "symbol": "BTC",
    "network": "Bitcoin",
    "amount": "100123",
    "isExceedingThreshold": 1,
    "tradeCurrency": "123",
    "tradePrice": "100",
    "tradeISODatetime": "2022-02-02T10:00:00.000Z"
  },
  "txHash": null,
  "vout": null,
  "originatingVaspId": "15952089931162058999",
  "originatorAccountNumber": "0xtest001506550d8356a215be229c15b6ef371a9a",
  "ivms101Originator": "{\"originatorPersons\":[{\"naturalPerson\":{\"name\":{\"nameIdentifier\":[{\"primaryIdentifier\":\"Taylor\",\"nameIdentifierType\":\"LEGL\"}]},\"geographicAddress\":[{\"addressType\":\"test\",\"buildingName\":\"123\",\"townName\":\"Yeoksam-dong\",\"country\":\"KR\"}]}}]}",
  "ivms101OriginatingVasp": "{\"legalPerson\":{\"name\":{\"nameIdentifier\":[{\"legalPersonName\":\"perftest1\",\"legalPersonNameIdentifierType\":\"LEGL\"}]},\"geographicAddress\":[{\"addressType\":\"GEOG\",\"postcode\":\"13525\",\"townName\":\"Yeoksam-dong\",\"addressLine\":[\"Gangnam-gu, Gangbuck-do\",\"abc\"],\"country\":\"AF\"}],\"nationalIdentification\":{\"nationalIdentifier\":\"983746561\",\"nationalIdentifierType\":\"RAID\",\"registrationAuthority\":\"RA000025\"}}}",
  "beneficiaryVaspId": "15952089931162059995",
  "beneficiaryAccountNumber": "1G3qCGKP5dQtQ7secCPTCDPU9Wfjp9x3Hb",
  "ivms101Beneficiary": "{\"beneficiaryPersons\":[{\"naturalPerson\":{\"name\":{\"nameIdentifier\":[{\"primaryIdentifier\":\"Taylor\",\"secondaryIdentifier\":\"Robbins\",\"nameIdentifierType\":\"LEGL\"}]}}}],\"accountNumber\":[\"1G3qCGKP5dQtQ7secCPTCDPU9Wfjp9x3Hb\"]}",
  "ivms101BeneficiaryVasp": "{\"legalPerson\":{\"name\":{\"nameIdentifier\":[{\"legalPersonName\":\"perftest2\",\"legalPersonNameIdentifierType\":\"LEGL\"}]},\"geographicAddress\":[{\"addressType\":\"GEOG\",\"postcode\":\"13525\",\"townName\":\"Yeoksam-dong\",\"addressLine\":[\"14, Teheran-ro 4-gil\",\"Gangnam-gu\"],\"country\":\"AF\"}],\"nationalIdentification\":{\"nationalIdentifier\":\"7612873123\",\"nationalIdentifierType\":\"RAID\",\"registrationAuthority\":\"RA000073\"}}}",
  "verifiedAt": "2022-02-22T05:12:41.000Z",
  "orderedAt": null,
  "createdAt": "2022-02-22T05:12:40.000Z"
}

Field Name	Data Type	Required	Example	Description
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를 입력한 경우

Response Body Examples

• 404 Not Found

{
  "code": "VERIFICATION-NOT-FOUND",
  "message": "Verification(9faab87c-54a6-4145-baa9-7a3a42d7410c) is not found"
}