CRYPTOMENTS 개발자 문서

1. 소개

본 문서는 CRYPTOMENTS 스테이블코인 결제 시스템의 관리자 콘솔 사용법을 안내하는 공식 가이드입니다. 이 가이드는 관리자 콘솔의 주요 기능을 효과적으로 사용하고 관리하는 데 도움을 주는 것을 목적으로 합니다.

2. 시작하기

2.1. 접속 및 로그인

지정된 URL로 접속하여 발급받은 이메일과 비밀번호를 입력해 로그인합니다.

2.2. 계정 정보 확인 및 비밀번호 변경

로그인 계정의 기본 정보, API Key를 확인하고 비밀번호를 변경할 수 있습니다.

⚠️ 중요: API Key와 Secret은 외부에 노출되지 않도록 각별히 주의해야 합니다.

3. 주요 기능 안내

3.1. 정책 관리

3.1.1. 환율 정책

서비스에 적용될 환율을 '실시간 시세 연동' 또는 '관리자 직접 입력' 방식으로 설정합니다.

3.1.2. 출금 정책

사용자 출금 요청에 대한 승인 방식을 설정합니다. '자동 출금' 또는 특정 금액(USDT 기준)을 초과하는 요청만 수동으로 승인하는 '수동(조건부) 출금'을 선택할 수 있습니다. 보안 강화를 위해 '수동(조건부) 출금'을 권장합니다.

3.1.3. 콜백(Callback) URL

입/출금 이벤트 발생 시, 파트너사 서버로 실시간 정보를 전송받을 URL을 설정합니다. 시스템 연동을 위한 개발자 설정 항목입니다.

3.1.4. 텔레그램 챗봇 설정

CRYPTOMENTS 시스템 운영 중 발생하는 주요 이벤트에 대한 알림을 실시간으로 텔레그램 챗봇을 통해 수신하도록 설정하는 메뉴입니다. 알림을 받을 텔레그램 계정을 등록하고, 알림 수신 여부를 활성화/비활성화할 수 있어 신속한 상황 파악과 이슈 대응에 매우 유용합니다.

주요 알림 종류

이 기능을 활성화하면, 관리자는 아래와 같은 중요한 상황이 발생했을 때 즉시 텔레그램 메시지로 알림을 받게 됩니다.

모지갑 잔액 부족 (WALLET_BALANCE_LOW): 출금에 사용될 모지갑의 자산이 부족할 경우
가스비 부족 (GAS_BALANCE_LOW): 트랜잭션 수수료로 사용될 수수료 지갑의 잔액(가스비)이 부족할 경우
출금 요청 (WITHDRAWAL_REQUEST): 사용자 출금 요청이 발생했을 경우 (특히 수동 승인이 필요한 경우 유용)
출금 완료 (WITHDRAWAL_COMPLETED): 출금 처리가 성공적으로 완료되었을 경우
입금 확인 (DEPOSIT_CONFIRMED): 사용자 입금이 최종 확인되었을 경우
잔액 부족 (BALANCE_LOW): 사용자의 잔액이 부족할 경우
시스템 점검 (SYSTEM_MAINTENANCE): 시스템 점검이 시작되거나 종료될 경우
시스템 오류 (SYSTEM_ERROR): 시스템에 예측하지 못한 오류가 발생했을 경우

설정 방법

설정 방법은 **A) 알림 활성화**와 **B) 알림 비활성화** 두 가지로 나뉩니다.

A. 알림 활성화 방법 (계정 최초 등록)

사전 준비: 설정을 진행하기 전에, 관리자 콘솔에 접속한 PC 또는 모바일 기기에 텔레그램이 설치 및 로그인되어 있어야 합니다.

`정책 관리` 메뉴에서 `텔레그램 챗봇 설정` 탭으로 이동합니다.
알림을 활성화하기 위해 아래 두 가지 방법 중 하나를 선택합니다. (두 방법 모두 동일한 텔레그램 인증 절차로 연결됩니다.)
- **방법 1:** 파란색 글씨의 봇 ID `@cryptoments_noti_bot` 링크를 직접 클릭합니다.
- **방법 2:** `활성화 여부`에서 `ON` 버튼을 클릭합니다.
자동으로 텔레그램 앱이 열리면서 'Cryptoments Noti Bot'과의 대화창이 나타납니다. 하단의 `시작(START)` 버튼을 누르거나, 명령어 `/verify` 를 입력하여 인증을 완료합니다.
인증에 성공하면, 관리자 콘솔 화면의 `활성화 여부`가 자동으로 `ON` 상태로 변경됩니다. 별도의 저장 절차 없이 즉시 활성화가 완료됩니다.

B. 알림 비활성화 방법

`텔레그램 챗봇 설정` 화면에서 알림이 `ON`으로 활성화된 상태일 때, `OFF` 버튼을 클릭합니다.
버튼을 클릭하는 즉시 알림이 비활성화되며, 더 이상 텔레그램으로 시스템 알림이 오지 않습니다.

💡 운영 권장 사항:
안정적인 시스템 운영과 신속한 이슈 대응을 위해 텔레그램 봇 알림 기능은 항상 `ON`으로 설정하여 사용하시는 것을 강력히 권장합니다. 특히 '모지갑 잔액 부족'이나 '가스비 부족' 알림은 출금 서비스 장애를 사전에 방지하는 데 결정적인 역할을 합니다.

3.2. 모지갑 관리

3.2.1. 체인 활성화

서비스에서 사용할 블록체인 네트워크(체인)를 선택하여 모지갑과 수수료 지갑을 생성하고 활성화합니다.

※ 트론(TRON) 특별 절차: 트론 체인은 지갑 생성 후, 해당 모지갑과 수수료 지갑 주소로 소량의 TRX를 전송해야 최종적으로 네트워크 활성화가 완료됩니다. 이 과정을 거치지 않으면 입금이 누락될 수 있습니다.

3.2.2. 체인 지갑 상세

모지갑/수수료 지갑의 상세 정보(보유 토큰 잔액, 거래 내역 등)를 확인하고, 관리자가 직접 자산을 외부로 출금할 수 있는 기능입니다.

3.3. 사용자 지갑 관리

3.3.1. 사용자 지갑 목록 및 검색

시스템에 생성된 모든 개별 사용자들의 지갑 목록을 조회하고, 사용자 ID로 특정 사용자를 검색합니다.

3.3.2. 사용자 지갑 상세

특정 사용자의 상세 정보(체인별 입금 주소, 개인 거래 내역 등)를 확인합니다. 주로 고객 지원 및 거래 문제 확인 시 사용됩니다.

3.4. 입출금 내역 관리

시스템에서 발생한 모든 입출금 거래의 통합 내역을 조회하고 검색합니다. 사용자 ID, 지갑 주소, 거래 ID(TX Hash) 등 다양한 조건으로 검색할 수 있습니다.

3.5. 출금 승인 관리

'출금 정책'에 따라 수동 승인이 필요한 고액 출금 요청 목록을 관리합니다. 관리자는 각 요청을 검토 후 `출금승인` 또는 `출금거절`을 결정하여 시스템 보안을 강화합니다.

관리자 콘솔 사용자 가이드

목차