Przewodnik po konfiguracji, zasady Stars i rzeczywiste opłaty
Telegram wymaga własnej waluty Stars (XTR) do zakupów cyfrowych i usług sprzedawanych w botach i Mini Aplikacjach.
Bramki płatności kryptowalutowych są używane do wszystkiego, czego Stars nie pokrywa: usługi w świecie rzeczywistym, dobra materialne, salda na platformie, depozyty i wypłaty B2B. Ten przewodnik przeprowadza przez to, co jest faktycznie dozwolone, dwa praktyczne sposoby na ustawienie akceptacji kryptowalut, jakie są koszty oraz obejście dla jednej rzeczy, której kryptowaluty jeszcze nie potrafią zrobić — subskrypcji cyklicznych.
Kluczowe wnioski
Istnieją dwa praktyczne sposoby akceptacji kryptowalut z Mini Aplikacji lub bota Telegram: zautomatyzowane zarządzanie depozytem i zautomatyzowane zarządzanie bezdepozytowe (smart kontrakt).
Żaden blockchain obecnie nie wspiera prawdziwych subskrypcji cyklicznych bez poważnych kompromisów w zakresie bezpieczeństwa — praktycznym rozwiązaniem jest doładowywane saldo w aplikacji.
Płatności kartą w WebView Mini Aplikacji często mają problemy z 3D Secure i kontrolami oszustw — jednym z praktycznych powodów, dla których kryptowaluty działają płynniej w tym konkretnym środowisku.
Fałszywe Mini Aplikacje stworzone w celu wyczerpania połączonych portfeli są aktywnym, rosnącym zagrożeniem w 2026 roku.
Bots kontra Mini Aplikacje
Większość treści "jak akceptować kryptowaluty na Telegramie" dotyczy w rzeczywistości botów — wysyłasz link do płatności lub fakturę jako wiadomość czatu, użytkownik w nią klika, a przeglądarka (lub wbudowane płatności) się otwiera.
Mini Aplikacja jest inna: to pełna aplikacja internetowa, która otwiera się bezpośrednio w Telegramie jako WebView, z własnym interfejsem, nawigacją i — jeśli chcesz — własnym procesem płatności wbudowanym w interfejs użytkownika, a nie dodanym jako link.
Portfel kryptowalutowy — dostępny z ikony załącznika w każdym czacie Telegram — jest dobrym przykładem tego, jak to wygląda w praktyce: salda, przepływy wysyłania/odbierania, własna nawigacja, wszystko bez opuszczania czatu.
Jeśli budujesz usługę subskrypcyjną, rynek lub platformę iGaming, prawie na pewno tworzysz Mini Aplikację, a nie prostego bota. Poniższe kroki konfiguracji dotyczą obu, ale doświadczenie przy płatności jest zauważalnie lepsze w Mini Aplikacji, ponieważ strona płatności może znajdować się w twoim interfejsie zamiast przekierowywać użytkownika gdzie indziej.
Telegram Stars vs. bramki kryptowalutowe
Dokumentacja Płatności Botów Telegrama wymaga, aby dobra i usługi cyfrowe sprzedawane w ramach bota lub Mini Aplikacji korzystały z Telegram Stars (kod waluty XTR) — nie kart, nie kryptowalut. Dotyczy to rzeczy takich jak odblokowywanie treści premium, kupowanie waluty w aplikacji do gry lub płacenie za subskrypcję cyfrową, która jest w całości konsumowana w Telegramie.
Volet.com · Sprawdzenie płatności Telegram
Gwiazdy, czy brama kryptowalutowa?
Wybierz, co sprzedajesz. Odpowiedź opiera się na własnych Warunkach korzystania z usług dla programistów botów Telegram, a nie na ogólnych poradach.
Gdzie bramki płatności kryptowalutowych są odpowiednim i legalnym narzędziem:
Usługi świadczone poza Telegramem — połączenie VPN, hosting, produkt SaaS, konsultacje, cokolwiek użytkownik konsumuje poza platformą, nawet jeśli płaci za to wewnątrz bota Telegram.
Towary fizyczne — cokolwiek wysyłane lub przekazywane osobiście.
Salda platformy i depozyty — doładowanie portfela wewnątrz własnej aplikacji (to również praktyczne rozwiązanie problemu subskrypcyjnego poniżej).
Płatności B2B i transgraniczne — wypłaty dla partnerów, rozliczenia na rynku między firmami, które całkowicie wykraczają poza definicję "towarów cyfrowych sprzedawanych w aplikacji" Telegramu.
Płatności kartą wewnątrz WebView Mini Aplikacji
Jest techniczny powód, dla którego kryptowaluty wydają się płynniejsze niż karty, szczególnie w środowisku Telegramu. Mini Aplikacje działają wewnątrz WebView — wbudowanej przeglądarki, a nie pełnej — a procesory kart często mają problemy z tym środowiskiem: kontrole antyfraudowe mogą się nie powieść, a okna potwierdzenia 3D Secure często nie otwierają się prawidłowo lub nie oddają kontroli z powrotem do strony, pozostawiając klienta w trakcie płatności bez jasnego następnego kroku.
Kryptowaluty omijają ten problem, ponieważ nie ma sieci kart i nie ma kroku 3D Secure w pętli, który mógłby się zepsuć wewnątrz WebView. Rozłóżmy to na bardziej szczegółowe elementy.
Dwa sposoby akceptacji kryptowalut w Telegramie
Oczywiście zawsze możesz ręcznie podać adres portfela i samodzielnie sprawdzić płatności — ale to nie skaluje się poza okazjonalne jednorazowe faktury. Dla czegokolwiek, co budujesz na dłużej, naprawdę wybierasz między dwoma zautomatyzowanymi modelami.
Zautomatyzowana akceptacja powiernicza
To jest to, czego większość firm naprawdę chce. Integrujesz bramkę płatności — za pomocą API lub Hosted Checkout — i ona obsługuje cały proces:
Bramka automatycznie generuje fakturę i szczegóły płatności dla każdego zakupu, pobierając adres z puli i obliczając kwotę do zapłaty.
Klient wysyła płatność; bramka automatycznie dopasowuje ją do faktury.
Bramka powiadamia Twój backend za pomocą webhooka, gdy płatność zostanie potwierdzona, abyś mógł automatycznie dostarczyć dostęp.
Środki są przypisywane do Twojego salda handlowego — albo w tej samej kryptowalucie, którą zapłacił klient, albo automatycznie przeliczane na stablecoin lub walutę fiducjarną, co jest przydatne, jeśli Twoje ceny są ustalone w USD i nie chcesz narażać się na zmienność kryptowalut.
W Telegramie wygląda to inaczej w zależności od tego, jak się integrujesz:
Za pomocą API, budujesz interfejs samodzielnie w wiadomościach swojego bota lub wewnątrz ekranów własnej Mini Aplikacji.
Za pomocą Hosted Checkout, Mini Aplikacja otwiera webview z gotową stroną płatności — nie wymaga to rozwoju backendu z Twojej strony, a działa w ten sam sposób, niezależnie od tego, czy budujesz bota, czy pełną Mini Aplikację.
Tutaj środki nigdy nie przechodzą przez bramkę. Klient łączy swój portfel bezpośrednio z Twoim procesem zakupu i płaci za pomocą smart kontraktu bezpośrednio do Twojego portfela. Bramki pobierają niewielką opłatę za przetwarzanie, ale nigdy nie przechowują środków; rozliczenie odbywa się całkowicie w ramach samej transakcji.
Zostaje przekierowany do aplikacji portfela, aby zatwierdzić połączenie — na urządzeniach mobilnych otwiera to samą aplikację portfela; na komputerach stacjonarnych, rozszerzenie przeglądarki lub skan QR.
Zostaje zwrócony do Twojego procesu zakupu.
Potwierdza szczegóły transakcji.
Zostaje ponownie przekierowany do swojego portfela, aby podpisać płatność.
Zostaje zwrócony na stronę potwierdzenia, która czeka na zakończenie transakcji w łańcuchu, zanim oznaczy zamówienie jako zakończone.
Jeszcze jeden szczegół techniczny: powiadomienie API nie jest częścią smart kontraktu. Sam transfer blockchainowy to jedyna rzecz, która odbywa się w łańcuchu — wszystko inne (aktualizacja statusu zamówienia, przyznawanie dostępu, wysyłanie potwierdzenia) to oddzielna logika backendowa po Twojej stronie, uruchamiana przez webhook, gdy bramka wykryje transakcję.
Ostrzeżenie o oszustwie związanym z wyczerpywaniem portfela
Ten dokładny proces — połączenie portfela, podpisanie transakcji — jest również tym, co naśladują oszuści. Oszukańcze klony popularnych aplikacji Mini Apps do zarabiania poprzez kliknięcia, w tym imitacje Notcoin i Hamster Kombat, skłoniły użytkowników do połączenia swoich portfeli, tylko po to, aby złośliwy inteligentny kontrakt natychmiast i nieodwracalnie wyczerpał środki.
Nie czyni to połączenia portfela niebezpiecznym z założenia, ale legitymacja musi być widocznie oczywista: spójna, weryfikowalna domena płatności, stała i szczegółowa zgoda na wydatki, a nie otwarta, oraz twarda zasada, że prawdziwe zakupy nigdy nie proszą o frazę seed lub zaliczkę — tylko o podpis z aplikacji portfela klienta.
TON (The Open Network), niedawno przemianowany z powrotem na swoją pierwotną nazwę Gram, jest jedynym wyborem dla TON Connect w powyższym przepływie niepowierniczym. To nie jest rekomendacja — to zasada. Własne Warunki Usługi Dewelopera Botów Telegramu wymagają, aby każda Mini Aplikacja dotykająca funkcjonalności portfela łączyła się wyłącznie przez TON Connect.
Dlaczego Telegram to egzekwuje: TON to własna blockchain Telegramu, a firma ma bezpośredni, rosnący udział w jej sukcesie. W maju 2026 roku Telegram przejął bezpośrednią kontrolę nad infrastrukturą TON: firma zablokowała 2,2 miliona tokenów, aby stać się największym walidatorem sieci, zastępując Fundację TON jako głównego operatora.
Akceptacja powiernicza przez API Volet.com lub Hosted Checkout w ogóle nie napotyka na to — nie ma kroku łączenia portfela w samej Mini Aplikacji, więc jakie aktywa możesz akceptować nie jest ograniczone w ten sam sposób.
Żaden blockchain dzisiaj nie wspiera automatycznego cyklicznego rozliczania w sposób, w jaki robi to sieć kart — najbliższe przybliżenia wymagają albo nadania inteligentnemu kontraktowi stałego zezwolenia na pobieranie funduszy w nieskończoność (co stanowi istotny kompromis w zakresie bezpieczeństwa, którego większość firm nie powinna akceptować), albo zbudowania czegoś tak kruchego, że nie warto tego wdrażać.
Praktycznym rozwiązaniem jest doładowywalny balans zamiast subskrypcji:
Użytkownik doładowuje saldo w Twojej Mini Aplikacji za pomocą kryptowalut — przez ten sam przepływ powierniczy lub niepowierniczy opisany powyżej.
Twoja aplikacja odejmuje koszt subskrypcji z tego salda według harmonogramu, który kontrolujesz.
Możesz nawet przechowywać i wyświetlać to saldo w walucie fiat (tak, aby użytkownik widział "pozostało $9.99" zamiast zmiennej kwoty w kryptowalucie), jednocześnie akceptując samo doładowanie w kryptowalucie.
Wymaga to nieco więcej pracy deweloperskiej w Twojej Mini Aplikacji, ale to wersja, która faktycznie działa dzisiaj bez proszenia użytkowników o przekazanie stałego zezwolenia na inteligentny kontrakt.
Oferta Volet.com na płatności w Telegramie
Pozyskiwanie kryptowalut przez Volet.com nie wymaga minimalnego obrotu, aby rozpocząć, bez opłat za konfigurację API lub Hosted Checkout oraz bez miesięcznych kosztów subskrypcyjnych.
Model
Opłata handlowa
Opłata za wypłatę
Powierniczy (API lub Hosted Checkout)
Od 0.25%
Od $0.5 stałe (więcej, jeśli konwersja — patrz poniżej)
Niepowierniczy (inteligentny kontrakt)
0.25%
Brak — środki trafiają bezpośrednio do Twojego portfela
Powyższa stawka to podstawowy poziom akceptacji płatności bez konwersji. Opcjonalna konwersja przy rozliczeniu jest wyceniana osobno — a najczęstszy przypadek, stablecoiny na USD, nie kosztuje nic dodatkowo. Oto, ile faktycznie kosztuje konwersja przy rozliczeniu:
Przykład: jednorazowe doładowanie salda usługi VPN w wysokości $9.99 opłacone w USDT.
Powierniczy (API lub Hosted Checkout):
Klient wysyła Ci 9.99 USDT z własnego portfela.
Otrzymujesz $9.99 minus opłatę za pozyskanie 0.25% (około $0.02), więc w przybliżeniu $9.97 trafia na Twoje saldo biznesowe Volet.com.
To saldo kumuluje się z każdym doładowaniem klienta, a to, ile kosztuje jego wypłata, zależy od tego, co zrobisz dalej.
Najtańsza opcja: pomiń fiat i wypłać, powiedzmy, $1,000 do swojego portfela kryptowalutowego w tej samej aktywie — tylko stała opłata sieciowa (około $0.5–3.5 w zależności od sieci), więc zachowasz w przybliżeniu $996.50–$999.50.
Jeśli chcesz fiat, konwertuj w momencie, gdy akceptujesz każdą płatność (rozliczając w USD zamiast trzymać USDT), a nie konwertuj później — ta konwersja jest darmowa, więc wypłata wynikowego salda $1,000 USD na Twoje konto bankowe kosztuje tylko opłatę za wypłatę, od 1% w zależności od metody, pozostawiając Cię z około $990.
Konwersja już zgromadzonego salda USDT na USD po fakcie, w Twoim koncie, kosztuje 1% na dodatek — plus ta sama opłata za wypłatę — więc skończysz z około $980 zamiast tego.
Niepowierniczy (inteligentny kontrakt):
Klient łączy swój portfel i podpisuje tę samą płatność 9.99 USDT.
Inteligentny kontrakt kieruje płatność bezpośrednio do Twojego portfela, minus ta sama opłata przetwarzania 0.25% — otrzymujesz w przybliżeniu $9.97, już siedzące w Twoim portfelu.
Nie ma oddzielnego kroku wypłaty ani opłaty za wypłatę, ponieważ środki nigdy nie były z gateway na początku.
Skaluj to do tych samych $1,000 w całkowitych płatnościach klientów użytych w powyższym przykładzie powierniczym, a porównanie jest proste: $997.50 trafia bezpośrednio do Twojego portfela.
Volet.com pomaga budować Twoje globalne płatności
W walutach fiat, kryptowalutach i stablecoinach. Przez API, kasę z hostem lub łatwe do zainstalowania wtyczki. Akceptuj, wysyłaj i zarządzaj funduszami — wszystko z poziomu kodu.
Nie. Hosted Checkout nie wymaga żadnego rozwoju backendu — Mini Aplikacja otwiera gotowy widok płatności w sieci.
Jednak pełna integracja API jest również dostępna, jeśli chcesz mieć większą kontrolę nad doświadczeniem płatności.
Możesz zacząć jako osoba fizyczna.
Akceptacja kryptowalut ma znacznie niższy próg wejścia niż tradycyjne systemy płatności: nie jest wymagana oddzielna osoba prawna, konto bankowe dla firm ani dedykowana pomoc prawna do jej podłączenia, a pojedynczy deweloper może bezpośrednio ustawić akceptację powierniczą lub niepowierniczą.
Tak, przy akceptacji powierniczej, przychodzące płatności w kryptowalutach mogą być automatycznie przeliczane na USD lub EUR przy rozliczeniu, więc twoje saldo nie zmienia się wraz z cenami kryptowalut, nawet jeśli twój klient zapłacił w niestabilnym aktywie.
Płatności niepowiernicze rozliczają się bezpośrednio w tym, czym klient zapłacił, ponieważ nie ma pośredniego kroku konwersji w tym procesie.
Narzędzia do automatyzacji księgowości kryptowalutowej i raportowania podatkowego są wciąż znacznie mniej rozwinięte niż te, które istnieją dla przychodów z kart lub banków — to prawdziwy problem, jeśli potrzebujesz czystych, gotowych do audytu ksiąg.
Przeliczanie przychodzących płatności na stablecoin lub walutę fiducjarną przy rozliczeniu (dostępne z akceptacją powierniczą Volet.com) eliminuje dodatkową złożoność śledzenia ruchów cen kryptowalut na dodatek do samych transakcji.
