Callback API
Callback 호출
POST
VEGA_VERIFICATION_CALLBACK_API_PATH
비동기 방식으로 API가 호출되었을 경우 사용되는 Callback API입니다.
비동기로 동작하는 API는 아래와 같습니다.
사용자 검증 요청 API
트랜잭션 결과 리포트 API
에러 상황 리포트 API
Chainalysis KYT 기능을 이용한 위험 평가 API
Refinitiv WCO 기능을 이용한 위험 평가 API
Callback API는 enclave에서 호출하는 API로 다음과 같은 경우에 호출됩니다.
이전에 요청했던 Verification에 대한 결괏값이 도착했을 경우 (callbackType : VERIFICATION_RESULT)
송신 VASP에서 특정 verification에 대응되는 txHash 또는 txID의 report가 도착했을 경우 (callbackType : TX_REPORT)
송신 VASP에서 특정 verification에 대응되는 에러 상황 report가 도착했을 경우 (callbackType : ERROR_REPORT)
기존에 등록한 Chainalysis KYT 요청에 대한 위험 평가 결과를 수신했을 경우 (callbackType : CHAINALYSIS_KYT_RESULT)
기존에 등록한 Refinitiv WCO 요청에 대한 위험 평가 결과를 수신했을 경우 (callbackType : REFINITIV_WCO_RESULT)
Request Header
Authorization
Bearer <VEGA_VERIFICATION_AUTHORIZATION_TOKEN>
Request Body
callbackType
string
true
Callback API가 어떠한 상황에서 호출되었는지 구분하는 값. (하단 설명 참조)
data
object
true
callbackType에 따라 data 형식이 달라집니다. (위 샘플 코드 참조)
callbackType 필드에는 다음과 같은 값이 들어갈 수 있습니다.
VERIFICATION_RESULT: 이전에 호출했던 사용자 검증 요청 API에 대한 결과가 도착했을 때 호출
TX_REPORT: Originating VASP로부터 트랜잭션 결과 리포트가 도착했을 때 호출
ERROR_REPORT: Beneficiary VASP로부터 에러 상황 리포트가 도착했을 때 호출
CHAINALYSIS_KYT_RESULT: Chainalysis KYT API를 이용하여 위험 평가를 수행한 결과가 도출되었을 때 호출
REFINITIV_WCO_RESULT: Refinitiv WCO API를 이용하여 위험 평가를 수행한 결과가 도출되었을 때 호출
data.reason 필드에는 다음과 같은 값이 들어갈 수 있습니다.
단, 사용자 검증 요청에 대한 결과
data.result
필드의 값이 DENIED 일 때에만 유효합니다.data.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 호출이 시간 초과로 실패했을 경우
Response Body
result
boolean
true
true
결괏값. (에러는 반환하지 않습니다.)
Last updated