본문으로 건너뛰기
색인되지 않은 문서
이 문서는 색인되지 않습니다. 검색 엔진이 이 문서를 색인하지 않으며, 주소를 알고 있는 사용자만 접근할 수 있습니다.

자식주소 출금 지갑 구축하기

입출금 API를 연동하기 전, 아래 과정을 먼저 진행해 주세요.
  1. 회원가입
  2. 지갑 생성
  3. API 토큰 발급
  4. API 호출 IP 등록

일반적으로 자식주소 출금 지갑은 다음과 같이 구축합니다. 이 외 기능은 서비스 형태에 따라 다양하게 구현할 수 있습니다.


자식주소 시스템 구축하기​

자식주소 생성하기​

엔드 유저에게 발급할 주소를 생성합니다. 일반적으로 자식주소는 엔드 유저 당 1개씩 발급합니다. 자식주소는 API를 호출하여 생성하며, 콘솔에서 발급된 자식주소 목록을 확인할 수 있습니다.

자식주소 잔액 관리하기​

자식주소 별 잔액은 주소 잔액 조회 API를 호출하여 조회할 수 있습니다.

👀

대부분의 플랫폼은 동일한 자식주소 구조를 가지지만, 플랫폼에 따라 자식주소 구조가 다를 수 있으니 플랫폼 별 상세 가이드를 참고해 주시기 바랍니다.


입금 시스템 구축하기​

토큰 추가하기​

옥텟에서는 등록된 토큰만 입금 처리합니다. 따라서 토큰을 입금하기 전 해당 토큰을 지갑에 추가해야 합니다.

  • [지갑 설정] - [토큰 관리]에서 토큰을 추가할 수 있습니다.
  • 원하는 토큰이 목록에 없다면, 우측 상단의 [신규 토큰 등록 신청] 페이지에서 신규 토큰을 신청할 수 있습니다.

입금 발생 확인하기​

1. 콘솔에서 확인하기​

콘솔의 [입출금 내역]에서 입금 내역을 확인할 수 있습니다. UNFINALIZED 상태인 입금은 '진행'으로 표시되며, FINALIZED 상태인 입금은 '완료'로 표시됩니다.

2. 웹훅으로 확인하기​

대표주소나 자식주소에 입금이 완료되면 입금 웹훅이 전송됩니다. 전송된 웹훅으로 입금 여부를 확인할 수 있습니다. 웹훅 이용 방법과 전송되는 데이터 형태는 웹훅 페이지를 참고하세요.


출금 시스템 구축하기​

자식주소에서 출금하기​

자식주소에 보관된 자산을 외부로 출금합니다. 자식주소 출금 신청 API를 호출하여 출금을 신청할 수 있습니다.

대표주소에서 출금하기​

대표주소에 보관된 자산을 외부로 출금합니다. 출금 신청 API를 호출하거나, 콘솔에서 출금을 신청할 수 있습니다.

출금 승인 설정하기​

기본적으로 모든 출금은 관리자의 승인을 받은 뒤 진행됩니다. 단, API 출금 시 해당 설정을 비활성화 할 수 있으며, 이 경우 출금 신청 즉시 출금이 진행됩니다.

  • API 출금 - 관리자 승인을 비활성화 할 수 있습니다.
  • 콘솔 출금 - 관리자 승인이 필수입니다.

출금하기​

출금 신청 API를 호출하면 대표주소에서 외부로 출금을 요청할 수 있습니다. 출금 요청에 성공하면 uuid 값이 반환됩니다. 해당 값으로 출금 진행 상태를 조회할 수 있습니다.

Response 예시

{
"uuid": "18012e3f-07f3-45ec-862b-f020c0ca935a"
}


출금 완료 확인하기​

1. 콘솔에서 확인하기​

콘솔의 [입출금 내역]에서 출금 내역을 확인할 수 있습니다. AWAITING_WITHDRAWAL와 PENDING 상태인 출금은 '진행'으로 표시되며, FINALIZED 상태인 출금은 '완료'로 표시됩니다.

2. API로 확인하기​

출금 트랜잭션 정보 조회 API를 호출하면 특정 출금 트랜잭션의 진행 상태를 확인할 수 있습니다.

Response 예시

{
"idx": 490,
"uuid": "07efdcb2-b3fd-4fe7-bf47-c0b460b289e3",
"fromAddress": "0x71b5De2970A32eEf6362AE7Bc3B73103b4392bB0",
"toAddress": "0x295909dC67B76f936BD4119aDd877088602cCaD3",
"amount": "2.00000000000000000000",
"memo": null,
"requestId": "25",
"type": "API",
"description": "",
"requiredApprovalCount": 1,
"useApiAutoApproval": true,
"status": "SENT",
"createdDate": "2022-01-25T09:25:02.383Z",
"modifiedDate": "2022-01-25T09:25:10.000Z",
"rejectedDate": null
}

3. 웹훅으로 확인하기​

대표주소에서 외부로 출금이 완료되면 출금 웹훅이 전송됩니다. 전송된 웹훅으로 출금 여부를 확인할 수 있습니다. 웹훅 이용 방법과 전송되는 데이터 형태는 웹훅 페이지를 참고하세요.