중앙화 지갑 구축하기
입출금 API를 연동하기 전, 아래 과정을 먼저 진행해 주세요.
- 회원가입
- 지갑 생성
- API 토큰 발급
- API 호출 IP 등록
일반적으로 중앙화 지갑은 다음과 같이 구축합니다. 이 외 기능은 서비스 형태에 따라 다양하게 구현할 수 있습니다.
자식주소 시스템 구축하기
자식주소 생성하기
엔드 유저에게 발급할 주소를 생성합니다. 일반적으로 자식주소는 엔드 유저 당 1개씩 발급합니다. 자식주소는 API를 호출하여 생성하며, 콘솔에서 발급된 자식주소 목록을 확인할 수 있습니다.
자식주소 잔액 관리하기
자식주소에 입금된 자산은 최종적으로 대표주소로 집금되며, 이때 자식주소의 잔액은 0이 됩니다. 따라서 각 자식주소 별 잔액을 고객사 측에서 별도로 DB 처리한 뒤, 엔드 유저가 확인할 수 있도록 표기하는 것을 권장드립니다.
대부분의 플랫폼은 동일한 자식주소 구조를 가지지만, 플랫폼에 따라 자식주소 구조가 다를 수 있으니 플랫폼 별 상세 가이드를 참고해 주시기 바랍니다.
입금 시스템 구축하기
토큰 추가하기
옥텟에서는 등록된 토큰만 입금 처리합니다. 따라서 토큰을 입금하기 전 해당 토큰을 지갑에 추가해야 합니다.
- [지갑 설정] - [토큰 관리]에서 토큰을 추가할 수 있습니다.
- 원하는 토큰이 목록에 없다면, 우측 상단의 [신규 토큰 등록 신청] 페이지에서 신규 토큰을 신청할 수 있습니다.
입금 발생 확인하기
외부에서 옥텟의 주소로 자산이 입금되면 옥텟 측 서버에서 고객사 측 서버로 해당 거래 데이터를 HTTP(post) 요청으로 발송합니다. 고객사 측에서 이를 수신할 수 있도록 내부적으로 작업한다면, 지속적인 polling 작업 없이도 실시간으로 입금이 발생하는 것을 확인할 수 있습니다.
집금 시스템 구축하기
집금하기
자식주소에 입금된 자산을 대표주소로 이동합니다. 집금을 원하는 시점에 집금 API를 호출하거나, 콘솔에서 [집금 내역]의 [집금하기] 버튼을 클릭하여 자산 별로 집금을 진행할 수 있습니다.
집금 수수료 관리하기
코인 집금 시 집금할 자산에서 수수료가 차감됩니다. 반면 토큰 집금 시 수수료로 지불할 코인을 충전하는 과정이 필요합니다. 이때 수수료주소에서 수수료만큼의 코인을 충전해줍니다. 따라서 집금을 진행하기 전 수수료주소의 잔액을 확인해야 합니다.
플랫폼에 따라 집금 방식이 다를 수 있으니 플랫폼 별 상세 가이드를 참고해 주시기 바랍니다.
출금 시스템 구축하기
출금하기
대표주소에 보관된 자산을 외부로 출금합니다. 출금 API를 호출하거나, 콘솔에서 출금을 신청할 수 있습니다. 필요 시 관리자의 승인을 거친 뒤 출금하도록 설정할 수 있습니다.
출금 승인 설정하기
기본적으로 모든 출금은 관리자의 승인을 받은 뒤 진행됩니다. 단, API 출금 시 해당 설정을 비활성화 할 수 있으며, 이 경우 출금 신청 즉시 출금이 진행됩니다.
- API 출금 - [지갑 설정] - [API 출금 승인]에서 관리자 승인을 비활성화 할 수 있습니다.
- 콘솔 출금 - 관리자 승인이 필수입니다.
출금 완료 확인하기
대표주소에서 외부로 자산이 출금되면 옥텟 측 서버에서 고객사 측 서버로 해당 거래 데이터를 HTTP(post) 요청으로 발송합니다. 고객사 측에서 이를 수신할 수 있도록 내부적으로 작업한다면, 지속적인 polling 작업 없이도 실시간으로 출금이 완료된 것을 확인할 수 있습니다.
Updated 9 months ago