Нұсқаулық · Telegram Stars

Боттардағы Telegram Stars шоттары (XTR): әзірлеушілерге арналған төлем ағыны, қадам бойынша

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

Жарияланды:

Боттардағы Telegram Stars шоттары (XTR): әзірлеушілерге арналған төлем ағыны, қадам бойынша

Бот цифрлық нәрсе сата ма, мысалы жазылым, мазмұн, ЖИ сұраулары немесе ойын ішіндегі заттар? Онда төлем тек Telegram Stars арқылы. Бұл мақала ресми Bot API құжаттамасына сүйеніп, Telegram Stars шотының (XTR) ағынын әзірлеуші тұрғысынан қадамдап көрсетеді. Неге міндетті түрде Stars болатынын мына жерден қараңыз: боттардағы цифрлық тауарлар тек Stars арқылы.

Ағын бір қарағанда

ҚадамБот не істейдіTelegram не жібереді
1currency = XTR мәнімен sendInvoice—
2Күтедіpre_checkout_query
3answerPreCheckoutQuery (10 секунд ішінде)—
4Күтедіsuccessful_payment
5Төлем идентификаторын сақтайды, тауарды береді—

1-қадам: шот жасау

Екі тәсіл бар:

  • Бот шоты: sendInvoice әдісі. Тауар цифрлық болғандықтан, provider_token — бос жол, ал currency өрісі — XTR. Шотты жеке чатқа, топқа немесе арнаға жіберуге болады.
  • Кірістірілген шот: бот кірістірілген режимді қолдаса, inputInvoiceMessageContent пайдаланушыларға шотты достарымен, топтармен және арналармен бөлісуге мүмкіндік береді. Оның Төлеу түймесін көп рет пайдалануға болады.

2-қадам: қайта жіберу тәртібін таңдау

Мұны start_parameter параметрі басқарады:

  1. Көп чатты шот: қайта жіберілген көшірмелерде Төлеу түймесі қалады, сондықтан көп пайдаланушы төлей алады. Кірістірілген шоттар әрқашан көп чатты болады.
  2. Бір чатты шот: тек жіберілген чатта төленеді; қайта жіберілген көшірмелерде оның орнына ботқа апаратын терең сілтеме түймесі шығады.

Ботпен жеке чатта жіберілген бір чатты шотты тек бір рет төлеуге болатынын ескеріңіз. Қалай болса да, жаңа төлемді қабылдауды әрқашан ботыңыз шешеді.

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 әдісі арқылы.

Дереккөздер

Stars пен Premium-ді USD (USDT) арқылы сатып алу

API кілті арқылы: Fragment бағасы, 0% (сайт: 5%).

Бастау