Боттардағы Telegram Stars шоттары (XTR): әзірлеушілерге арналған төлем ағыны, қадам бойынша
Ботта цифрлық тауарларды Stars үшін сату: XTR-мен sendInvoice, pre_checkout_query-ге 10 секундтық жауап, successful_payment, төлем идентификаторын сақтау және іске қосу тізімі.
Жарияланды:

Бот цифрлық нәрсе сата ма, мысалы жазылым, мазмұн, ЖИ сұраулары немесе ойын ішіндегі заттар? Онда төлем тек Telegram Stars арқылы. Бұл мақала ресми Bot API құжаттамасына сүйеніп, Telegram Stars шотының (XTR) ағынын әзірлеуші тұрғысынан қадамдап көрсетеді. Неге міндетті түрде Stars болатынын мына жерден қараңыз: боттардағы цифрлық тауарлар тек Stars арқылы.
Ағын бір қарағанда
| Қадам | Бот не істейді | Telegram не жібереді |
|---|---|---|
| 1 | currency = XTR мәнімен sendInvoice | — |
| 2 | Күтеді | pre_checkout_query |
| 3 | answerPreCheckoutQuery (10 секунд ішінде) | — |
| 4 | Күтеді | successful_payment |
| 5 | Төлем идентификаторын сақтайды, тауарды береді | — |
1-қадам: шот жасау
Екі тәсіл бар:
- Бот шоты: sendInvoice әдісі. Тауар цифрлық болғандықтан, provider_token — бос жол, ал currency өрісі — XTR. Шотты жеке чатқа, топқа немесе арнаға жіберуге болады.
- Кірістірілген шот: бот кірістірілген режимді қолдаса, inputInvoiceMessageContent пайдаланушыларға шотты достарымен, топтармен және арналармен бөлісуге мүмкіндік береді. Оның Төлеу түймесін көп рет пайдалануға болады.
2-қадам: қайта жіберу тәртібін таңдау
Мұны start_parameter параметрі басқарады:
- Көп чатты шот: қайта жіберілген көшірмелерде Төлеу түймесі қалады, сондықтан көп пайдаланушы төлей алады. Кірістірілген шоттар әрқашан көп чатты болады.
- Бір чатты шот: тек жіберілген чатта төленеді; қайта жіберілген көшірмелерде оның орнына ботқа апаратын терең сілтеме түймесі шығады.
Ботпен жеке чатта жіберілген бір чатты шотты тек бір рет төлеуге болатынын ескеріңіз. Қалай болса да, жаңа төлемді қабылдауды әрқашан ботыңыз шешеді.
3-қадам: алдын ала тексеру
Пайдаланушы (қажет болса, алдымен Stars сатып алып) Төлеу түймесін басады. Бот тапсырыс мәліметтері бар pre_checkout_query алады және answerPreCheckoutQuery арқылы 10 секунд ішінде жауап беруі керек, әйтпесе операция жойылады. Бас тартсаңыз, адамға түсінікті себеп жазыңыз; Telegram оны пайдаланушыға көрсетеді.
4–5-қадамдар: төлем және жеткізу
Төлем сәтті болғанда successful_payment хабары келеді. Тек содан кейін тауарды беріңіз, өйткені pre_checkout_query-ге жауап беру төлемнің өткеніне кепілдік бермейді. telegram_payment_charge_id сақтаңыз; ол қайтарым үшін қажет.
Іске қоспас бұрын
- Ботты басқаратын тіркелгі үшін екі қадамды растауды қосыңыз.
- Шарттарды /terms арқылы, қолдауды /support және /paysupport арқылы көрсетіңіз.
- Даулар мен қайтарымдарға refundStarPayment арқылы дайын болыңыз. Толығырақ: Stars қайтарымдары және /paysupport.
- Серверді тұрақты ұстаңыз және төлем деректерінің сақтық көшірмесін жасаңыз.
Қалай тексеру керек
Telegram-ның арнайы сынақ ортасы Stars төлемдерін тегін тексеруге мүмкіндік береді. Бәрі дұрыс жұмыс істеген соң, жұмыс ортасына ауысыңыз.
Stars сатып алу жағы
Пайдаланушыларыңыз Stars-ты қолданбада немесе @PremiumBot арқылы сатып алады, ал PayStars оларды USDT-ге сатады. Өз қызметіңіз Stars-ты автоматты түрде сатып алуы керек болса, мұны PayStars API мен API шолуы қамтиды.
ЖҚС
Stars орнына криптовалюта немесе басқа валюта қабылдай аламын ба?
Жоқ. Telegram қолданбаларының ішіндегі цифрлық тауарлар мен қызметтер тек Stars арқылы төленеді.
Төлемдерді қалай тексеремін?
Ботты Telegram-ның арнайы сынақ ортасына қосыңыз: онда Stars төлемдерін тегін тексеруге болады.
Қайтарымды қалай жасаймын?
Bot API-дегі refundStarPayment әдісі арқылы.
Дереккөздер
Related pages
Stars пен Premium-ді USD (USDT) арқылы сатып алу
API кілті арқылы: Fragment бағасы, 0% (сайт: 5%).
More news
Telegram Stars ботыңыз үшін қайтару саясатын жазу: үлгі және мысалдарTelegram Stars ботының қайтару саясаты нені қамтуы керек: кімге беріледі, мерзім, /paysupport және refundStarPayment, сондай-ақ бейімдеуге болатын үлгі мәтін.Оқу →
Telegram аккаунтына қол жеткізе алмасаңыз, Telegram Stars не боладыStars телефоныңызға емес, Telegram аккаунтыңызға тиесілі. Қол жеткізе алмағанда олармен не болатынын, қалай қайта кіруге болатынын және балансты қалай қорғау керектігін біліңіз.Оқу →
Telegram Stars кірісін автор немесе бизнес ретінде есепке алуTelegram Stars кірісін таза есепке алу жолы: нені жазу керек, Fragment арқылы шығаруды бақылау, жеке мен бизнесті бөлу және бухгалтерден не сұрау керек.Оқу →