CODE APIs

API Name	Description
VASP 목록 조회	송신 VASP가 코드에 요청하며, 코드를 통해 트래블룰이 연동되어 있는 VASP의 목록을 반환합니다. 고객향 출고 화면에서 출금 가능한 거래소 목록을 만들 때 참고할 수 있습니다.
공개키 조회	송신 VASP가 코드에 요청하며 암호화를 위해 필요한 VASP들의 공개키 목록을 반환합니다.
주소로 VASP 찾기 요청	VASP가 코드에게 요청하며 지갑 주소가 어떤 VASP의 소속인지 검색하는 요청을 보냅니다. 비동기 방식으로 진행됩니다.
주소로 VASP 찾기 결과 조회	VASP가 코드에 요청하며 ‘주소로 VASP 찾기 요청'에 대한 결과를 요청합니다.
가상 자산 주소 조회	송신 VASP와 수신 VASP가 통신하며 지갑 주소가 특정 VASP의 소속이 맞는지 확인합니다. 가상자산을 본격적으로 이체하기 전, 불필요한 사용자 정보 유출을 막기 위해 확인합니다.
자산 이전 허가 요청	송신 VASP와 수신 VASP가 통신하며 수신 VASP에게 가상자산 이전에 대한 허가를 요청합니다.
자산 이전 결과 전송	송신 VASP와 수신 VASP가 통신하며 블록체인 네트워크상 Transaction이 완료되었음을 알리기 위해 전송합니다.
트랜잭션 상태 조회	수신 VASP와 송신 VASP가 통신하며, 수신 VASP가 특정 Transaction의 상태를 역 조회하기 위해 요청합니다. 일반적으로 일정 시간 동안 ‘자산 이전 결과 전송' API를 통해 결과가 전송되지 않을 때 확인을 위한 목적으로 사용됩니다.
자산 이전 종료	송신 VASP와 수신 VASP가 통신하며, 자산 이전 프로세스가 중단되거나 실패한 경우를 알리기 위한 목적으로 사용합니다.
TXID로 VASP 찾기 요청	VASP가 코드에 요청하며, TXID를 기준으로 송신처 조회를 요청하여 익명의 Transaction에 대한 송신처를 찾는 것을 목적으로 합니다. 비동기 방식으로 진행됩니다.
TXID로 VASP 찾기 결과 조회	VASP가 코드에게 요청하며, ‘TXID로 VASP 찾기 요청’에 대한 결과로 VASP의 Entity ID를 반환합니다.
자산 이전 데이터 요청	수신 VASP가 송신 VASP와 통신하며, 이미 발생한 익명의 Transaction에 대해 ‘TXID로 VASP 찾기 요청’과 ‘TXID로 VASP 찾기 결과 조회’ API를 통해 송신처를 확인하고 트래블룰 준수를 위한 사용자 데이터를 주고받습니다

통신 흐름

트래블룰 준수를 위해서는 사전에 데이터를 주고받고, 그 이후에 블록체인 트랜잭션을 실행하는 것이 정석입니다. 하지만 선라이즈 이슈나 금액 제한 등의 이슈로 트래블룰 데이터 없이 자산이 이체되는 경우도 발생합니다.
코드는 두 가지 경우를 모두 커버하기 위한 아래와 같이 두 가지 옵션을 제공합니다.

선트래블룰 후트랜잭션 (Pre-Travel Rule, Post-Transaction)

📘
일반적으로 트래블룰 규제를 준수하며 가상자산을 입출고하는 경우 위와 같은 통신의 흐름이 진행됩니다. 이때, 출고 요청을 바로 하지 않고 검증 단계를 거치는 이유는 잘못된 요청으로 불필요하게 사용자 정보가 전달되는 것을 막기 위함입니다.

선트랜잭션 후트래블룰 (Pre-Transaction, Post-Travel Rule)

연동 순서

코드는 규제를 준수하고 신뢰할 수 있는 환경 구축을 위해 연동 전 VASP에 대한 자체적인 실사(Due Diligence)를 진행합니다. 심사 통과 후 개발 연동이 진행되며, 필요에 따라 한국 내 VASP와의 연동을 위한 추가 실사가 필요할 수 있습니다. 개발 연동을 마치고 운영 런칭 전 연동 체크리스트를 꼭 확인해 주세요.