팝업레이어 알림
팝업레이어 알림이 없습니다.
내 채널에서 직접 판매!
텔레그램 스타즈(Stars) 결제 연동 및 디지털 상품 판매 가이드
텔레그램 스타즈(Telegram Stars) 인앱 결제 시스템을 활용하여 E-book, 프리미엄 구독권, 디지털 템플릿 등을 채널에서 직접 판매하는 전체 프로세스를 단계별로 학습합니다. 가상 결제 시뮬레이터로 실제 구매 플로우를 직접 체험해 보세요.
텔레그램은 자체 가상화폐인 스타즈(Stars)를 도입하여, 앱 내에서 디지털 상품을 직접 사고팔 수 있는 결제 인프라를 구축했습니다. 기존에는 별도의 외부 결제 게이트웨이(Stripe, PayPal 등)를 연동해야 했지만, 이제 스타즈를 활용하면 Apple/Google 인앱 결제와 연동되어 전 세계 어디서든 간편하게 결제를 받을 수 있습니다.
이 가이드에서는 디지털 상품 등록 -> 결제 요청 전송(Bot API) -> 결제 확인 -> 콘텐츠 전달 -> 정산 출금까지의 전체 플로우를 단계별로 설명하고, 하단의 가상 결제 시뮬레이터를 통해 실제 구매자가 체험하는 것과 동일한 과정을 직접 테스트해 볼 수 있습니다.
스타즈(Stars)는 텔레그램이 공식 운영하는 인앱 결제 전용 가상 화폐입니다. 사용자는 Apple App Store 또는 Google Play에서 스타즈를 구매하고, 이를 채널/봇에서 디지털 상품을 구매하는 데 사용합니다. 판매자는 모아진 스타즈를 Fragment 플랫폼을 통해 TON 블록체인으로 출금할 수 있습니다.
Stars 충전
결제 요청
콘텐츠 전달
TON 정산
lightbulb스타즈 가격 기준
1 Stars는 약 $0.02 USD에 해당합니다. 예를 들어 50 Stars 상품은 약 $1.00 정도이며, 판매자에게 실지급되는 금액은 Apple/Google 인앱 결제 수수료(약 30%)를 제외한 금액입니다. 정확한 환율은 Fragment 플랫폼에서 실시간 확인이 가능합니다.
텔레그램 스타즈로 판매할 수 있는 디지털 상품은 매우 다양합니다. 다만, 물리적 상품(실물 배송이 필요한 제품)은 스타즈 결제 대상에서 제외된다는 점을 유의하세요.
| 상품 유형 | 설명 | 적정 가격대 (Stars) |
|---|---|---|
| E-book / PDF 가이드 | 전자책, 투자 리포트, 교육 자료 등 다운로드형 문서 | 50 ~ 500 Stars |
| 프리미엄 채널 구독 | 월간/분기별 정기 구독형 독점 콘텐츠 접근 권한 | 100 ~ 1,000 Stars/월 |
| 디지털 템플릿/에셋 | 디자인 템플릿, 프리셋, 폰트, 아이콘 팩 등 창작 자산 | 30 ~ 300 Stars |
| 온라인 강의/튜토리얼 | 녹화 강의 영상 URL 또는 비밀 그룹 초대 링크 제공 | 200 ~ 2,000 Stars |
| 유료 미디어 (Paid Media) | 채널 포스트 내 사진/영상을 결제 후 열람하는 방식 | 1 ~ 2,500 Stars |
텔레그램 결제 기능은 Bot API를 통해 작동합니다. 먼저 @BotFather에게 /newbot 명령을 보내 새 봇을 만들고, 발급받은 Bot Token을 안전하게 보관하세요. 이 토큰이 결제 요청을 처리하는 인증 키 역할을 합니다.
BotFather에게 /mybots 명령을 보내 방금 만든 봇을 선택한 다음, Payments 메뉴에서 결제 제공자로 "Telegram Stars"를 선택합니다. 별도의 외부 결제 게이트웨이 연동 없이 즉시 활성화됩니다.
Bot API의 sendInvoice 메서드를 사용하여 고객에게 결제 가능한 인보이스(청구서)를 전송합니다. 주요 파라미터는 다음과 같습니다:
| 파라미터 | 설명 | 예시 값 |
|---|---|---|
| title | 상품명 (구매자에게 표시) | "Premium E-book Vol.3" |
| description | 상품 설명 | "투자 전략 심화 가이드 PDF" |
| payload | 서버 내부 식별용 문자열 | "ebook_vol3_user123" |
| currency | 결제 통화 (스타즈 고정) | "XTR" |
| prices | 상품 가격 (Stars 단위) | [{"label":"E-book","amount":150}] |
lightbulbcurrency 값 주의
스타즈 결제 시 currency 값은 반드시 "XTR"로 설정해야 합니다. USD, KRW 등 일반 통화 코드를 입력하면 오류가 발생합니다. XTR은 Telegram Stars의 공식 통화 코드입니다.
구매자가 결제 버튼을 누르면 봇에 pre_checkout_query 이벤트가 전달됩니다. 이 시점에서 재고 확인, 가격 검증 등을 수행한 뒤 answerPreCheckoutQuery(ok=true)로 응답하면 결제가 확정됩니다. 반드시 10초 이내에 응답해야 하며, 지연 시 결제가 자동 취소됩니다.
결제가 완료되면 봇에 successful_payment 메시지가 전달됩니다. 이 시점에서 구매자에게 파일 전송, 비밀 채널 초대 링크 발급, 또는 잠긴 콘텐츠의 열람 권한을 부여합니다. telegram_payment_charge_id 값을 반드시 기록해 두세요. 이 값이 환불 처리 시 필요합니다.
warning환불 정책 필수 숙지
텔레그램은 결제 완료 후 21일 이내에 판매자가 refundStarPayment API를 호출하여 환불을 처리할 수 있습니다. 21일이 지나면 자동으로 정산이 확정되며 환불이 불가능해집니다. CS 대응 체계를 미리 구축해 두세요.
아래 시뮬레이터에서 디지털 상품을 선택하고 가상 스타즈로 결제해 보세요. 실제 텔레그램 결제 플로우와 동일한 과정(상품 선택 -> 인보이스 생성 -> Pre-Checkout 검증 -> 결제 확정 -> 영수증 발급)을 체험할 수 있습니다.
상품을 클릭하여 선택한 뒤 결제 버튼을 누르세요
> Stars Digital Shop 초기화 완료.
> 가상 잔액: 500 Stars 로드됨.
> 상품을 선택하고 결제를 시도해 보세요.
판매로 적립된 스타즈는 @BotFather의 /mystars 명령으로 잔액을 확인할 수 있습니다. 출금은 Fragment 플랫폼(fragment.com)에서 진행하며, 스타즈를 TON 블록체인의 암호화폐로 변환하여 외부 지갑으로 인출합니다.
| 정산 항목 | 상세 내용 |
|---|---|
| 정산 확정 기간 | 결제 완료 후 21일 경과 시 자동 확정 (환불 불가) |
| 출금 플랫폼 | Fragment (fragment.com) - Telegram 공식 경매/정산 사이트 |
| 출금 통화 | TON (The Open Network 블록체인 토큰) |
| 최소 출금 가능량 | 1,000 Stars 이상 (약 $20 USD 상당) |
| 수수료 | Apple/Google 앱스토어 수수료(~30%) 차감 후 지급 |
lightbulbFragment 출금 팁
Fragment에서 스타즈를 TON으로 환전할 때는 실시간 시세가 적용됩니다. TON 가격이 높을 때 환전하면 더 유리합니다. 또한, TON 블록체인 특성상 출금 수수료가 매우 저렴(약 0.01 TON)하여 소액 출금도 부담 없이 가능합니다.
텔레그램 스타즈는 복잡한 외부 결제 시스템 없이도 채널/봇에서 디지털 상품을 직접 판매할 수 있는 강력한 내장 결제 인프라입니다. Bot API의 sendInvoice 한 번이면 전 세계 사용자에게 인보이스를 전송하고, 결제 확인 후 자동으로 콘텐츠를 전달할 수 있습니다.
직장인 크리에이터, 정보 채널 운영자, 교육 콘텐츠 제작자라면 스타즈 결제를 활용하여 추가 수익원을 구축해 보세요. 작은 규모의 디지털 상품부터 시작하여 점차 상품 라인업을 확장하면, 텔레그램 채널 자체가 하나의 완벽한 디지털 커머스 플랫폼이 됩니다.
lightbulb관련 가이드 연계 학습
스타즈 결제를 채널에 연동하기 전에, 비즈니스 계정 전환과 챗봇 자동화 응대 설정을 먼저 완료해 두면 CS 운영 효율이 크게 향상됩니다.
텔레그램 비즈니스 챗봇(Business Bots) 연동 및 무인 응대 자동화 가이드 보러 가기
텔레그램 비즈니스 유료 채널 구독 모델 구축 가이드
스타즈 단건 결제를 넘어 정기 구독형 유료 채널을 운영하고 싶다면, 가입 승인 링크 관리와 구독 모델 설계 방법을 함께 확인해 보세요.
payments유료 채널 구축 가이드 보러 가기