결제 및 잔액
GetMyBot에는 두 가지 '결제' 루프가 있습니다: 플랫폼의 요청 잔액 (봇 운영용)과 Telegram을 통한 봇 사용자로부터의 결제 수신. 결제 섹션(또는 '결제 수신')은 요금제와 잔액을 관리합니다.
봇 요금제
플랫폼은 요청 단위로 작동을 계산합니다: 봇이 메시지 하나를 전달할 때마다 계정 잔액에서 요청 하나가 차감됩니다. 잔액은 정수 카운터이며, 불변 입출금 로그(가입 보너스, 요금제 적립, 충전, 소비)가 원본 데이터입니다.
요금제와 잔액
결제 섹션에 현재 잔액과 이용 가능한 요금제가 표시됩니다. 요금제에는 이름, 가격, 요청 수량 및 한도(예: 최대 봇 수)가 있습니다. 선택 버튼으로 요금제를 활성화합니다.
- 잔액 — 현재 요청 잔액 (개요 및 통계 화면에서도 표시).
- 통계 화면의 예측 (일) — 현재 소비 속도로 잔액이 얼마나 지속될지 추정.
입출금 로그 (ledger)
요청 잔액은 정수 카운터이지만, 원본 데이터는 불변 거래 로그(ledger)입니다. 잔액의 모든 변경 사항이 기록됩니다:
- 가입 보너스 — 새 계정에 지급되는 초기 요청 수량.
- 요금제 적립 — 요금제 활성화 시 지급된 요청.
- 충전 — 추가 구매된 요청.
- 소비 — 봇이 전달한 메시지 하나당 요청 하나 차감.
로그는 추가만 가능하며(기존 레코드 변경 불가), 언제든지 소비와 적립 내역을 확인할 수 있습니다. 현재 잔액은 로그의 합계입니다.
충전
충전은 필요한 요청 수량에 대한 결제를 생성합니다. 제공업체가 확인하면 잔액이 자동으로 그리고 멱등적으로 적립됩니다(중복 콜백이 중복 적립을 일으키지 않음). 특정 결제 제공업체는 인스턴스 구성에 따라 다릅니다.
사용자로부터 결제 수신 (Telegram Payments)
봇이 Telegram 결제를 수신하고 기록할 수 있습니다:
pre_checkout_query요청이 자동으로 확인됩니다.- 성공 결제(
successful_payment)가 기록되고(금액, 통화, 거래 식별자, 페이로드), 이후 반응이 트리거될 수 있습니다 — 예를 들어 접근 권한 부여, '결제함' 레이블 추가, 컬렉션에 주문 저장.
성공 결제 금액은 분석에서 볼 수 있습니다('결제').
청구서 발행(sendInvoice)과 편집기의 '결제 수신' / '알림' 버튼은 현재 '곧 출시'로 표시됩니다: 봇이 인바운드 결제를 기록하지만, 현재 버전에서는 반응에서 청구서를 시작할 수 없습니다.