검증 결과 조회 API

검증 결과 조회

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

지난 검증 요청에 대한 목록을 조회할 수 있습니다.

다음 API는 VerifyVASP를 통해 요청된 검증 히스토리를 조회합니다. 쿼리 매개변수는 모두 선택사항이며 입력된 모든 매개변수는 AND 연산을 통해 조회됩니다.

Request Query Parameters

Field NameData TypeRequiredExampleDescription

fromDate

string

false

“2022-01-01”

사용자 검증 요청 결과 조회 시작 날짜. (기본값: 1970-01-01)

toDate

string

false

"2011-01-15”

사용자 검증 요청 결과 조회 끝 날짜. (기본값: API 조회 시점)

symbol

string

false

"ETH”

가상 자산 심벌

network

string

false

"Ethereum"

가상 자산이 배포된 블록체인 네트워크 이름

txHash

string

false

“0x9fd7bfd46e4402c7197b4d8deb0199fcf7c1f57ef70c339f403a1cb060c31c28”

트랜잭션 아이디 (Transaction hash, txHash).

result

string

false

“VERIFIED”

사용자 검증 수행 결과. (하단 설명 참조)

actionType

string

false

“SEND”

VASP Transaction Type. (하단 설명 참조)

oppositeVaspId

string

false

“27372039731940175”

상대 VASP ID.

ID of VASP that is the opposite side of verification to query.

originatorAccountNumber

string

false

“0x5811001506550d8356a215be229c15b6ef371a9a”

Originator의 지갑 주소.

beneficiaryAccountNumber

string

false

“0x5811001506550d8356a215be229c15b6ef371a9b”

Beneficiary의 지갑 주소.

page

number

false

1

페이징 넘버 (default : 1)

rpp

number

false

10

레코드 개수 (default : 10)

  • result 필드에는 다음과 같은 값이 들어갈 수 있습니다.

    • “VERIFIED”, ”DENIED”, ”UNKNOWN”, ”ERROR” 중 한 개의 값을 갖습니다.

    • VERIFIED: 검증이 성공적으로 끝난 경우, 사용자에게 아무런 문제가 없음을 의미합니다.

    • DENIED: 지갑 주소는 맞지만 사용자(송신인 포함)에게 문제가 발견된 경우 (e.g. lack of KYC credential)

    • UNKNOWN: 지갑 주소가 모르는 주소일 경우 (VASP가 소유하지 않은 경우)

    • ERROR: 기타 다른 에러가 발생한 경우

  • actionType 필드에는 다음과 같은 값이 들어갈 수 있습니다.

    • "SEND", "RECEIVE" 중 한 개의 값을 갖습니다.

    • VASP Transaction Type으로 구분됩니다.

    • SEND: VASP에서 송신한 경우.

    • RECEIVE: VASP에서 수신한 경우.

Response Body

Field NameData TypeRequiredExampleDescription

count

number

true

172

모든 검증 결과 개수.

page

number

true

1

페이징 넘버 (default : 1)

rpp

number

true

10

레코드 개수 (default : 10)

verifications

array

true

-

사용자 검증 결과 목록

verifications.verificationId

string

true

"12345"

사용자 검증 결과 아이디

verifications.verificationUuid

string

true

"4615aa9d-ac64-4997-a9e6-0e772c57c7ef"

사용자 검증 요청 아이디

verifications.result

string

false

"VERIFIED"

사용자 검증 수행 결과. (하단 설명 참조)

verifications.reason

string

false

"OK"

검증이 실패한 경우에 그 이유를 나타내는 에러 코드 (하단 설명 참조). 성공적인 경우에는 "OK"

verifications.assetInfo

object

true

-

전송할 가상 자산에 대한 정보

verifications.assetInfo.symbol

string

true

“ETH”

VA. Virtual Asset. 전송할 가상 자산 심벌

verifications.assetInfo.network

string

false

"Ethereum"

가상 자산이 배포되어 있는 블록체인 네트워크 이름

verifications.assetInfo.amount

string

true

“0.024”

실제 전송할 가상 자산의 양

verifications.assetInfo.isExceedingThreshold

boolean

true

true

전송할 가상 자산의 법정 화폐 환산 금액이 법령에서 정한 금액 (1000달러 or 100만 원) 이상인지의 여부를 표시한 flag

verifications.assetInfo.tradePrice

string

true

“2439800”

전송할 가상 자산을 법정 화폐로 환산한 금액

verifications.assetInfo.tradeCurrency

string

true

“KRW”

전송할 가상 자산을 법정 화폐로 환산했을 때 사용한 화폐 코드

verifications.assetInfo.tradeISODatetime

string

true

“2022-02-06T23:13:43.513Z”

전송할 가상 자산을 법정 화폐로 환산했을 때 시세 적용 기준 시간, ISO 포맷으로 입력

verifications.txHash

string

true

“0x9fd7bfd46e4402c7197b4d8deb0199fcf7c1f57ef70c339f403a1cb060c31c28”

트랜잭션 아이디 (Transaction hash, txHash).

verifications.vout

string

false

"2"

트랜잭션 내에서 몇 번째 거래인지 구별할 수 있는 인덱스 값

verifications.originatingVaspId

string

true

"15952089931162058999"

송신 거래소 아이디

verifications.originatorAccountNumber

string

true

[”0xtest001506550d8356a215be229c15b6ef371a9a”]

송신인에 대한 계좌 번호 (지갑 주소)

verifications.ivms101Originator

string

true

"{'originatorPersons':[{'naturalPerson':{'name':{'nameIdentifier':[{'primaryIdentifier':'Taylor','nameIdentifierType':'LEGL'}]},'accountNumber':['1G3qCGKP5dQtQ7secCPTCDPU9Wfjp9x3Hb']}"

IVMS101 메시징 포맷의 송신인 정보

verifications.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 메시징 포맷의 송신 거래소 정보

verifications.beneficiaryVaspId

string

true

"15952089931162058777"

수신 거래소 아이디

verifications.beneficiaryAccountNumber

string

true

[”0xtest001506550d8356a215be229c15b6ef371a9b”]

수신인에 대한 계좌 번호 (지갑 주소)

verifications.ivms101Beneficiary

string

true

"{'originatorPersons':[{'naturalPerson':{'name':{'nameIdentifier':[{'primaryIdentifier':'James','nameIdentifierType':'LEGL'}]},'accountNumber':['1G3qCGKP5dQtQ7secCPTCDPU9Wfjp9x3Hb']}"

IVMS101 메시징 포맷의 수신인 정보

verifications.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 메시징 포맷의 수신 거래소 정보

verifications.verifiedAt

string

true

"2022-02-22T14:41:50.000Z"

사용자 검증 결과 전달받은 시간

verifications.orderedAt

Date

true

"2022-02-22T14:42:12.000Z"

트랜잭션 아이디를 리포팅 받은 시간, 또는 에러 리포팅 받은 시간

verifications.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 필드에는 다음과 같은 값이 들어갈 수 있습니다.

    • 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 호출이 시간 초과로 실패했을 경우

  • verifications.assetInfo.isExceedingThreshold 필드에는 다음과 같은 값이 들어갈 수 있습니다.

    • true, false 중 한 개의 값을 갖습니다.

    • true: 전송할 가상 자산의 법정 화폐 환산 금액이 법령에서 정한 금액 이상인 경우.

    • false: 전송할 가상 자산의 법정 화폐 환산 금액이 법령에서 정한 금액 미만인 경우.

Previous사용자 계정 검증 요청 APINext단일 검증 결과 조회 API

Last updated