Роҳнамо · Telegram Stars

Ҳисобномаҳои Telegram Stars (XTR) дар ботҳо: ҷараёни пардохт барои таҳиягарон, қадам ба қадам

Фурӯши молҳои рақамӣ ба ивази Stars дар бот: sendInvoice бо XTR, ҷавоби 10-сония ба pre_checkout_query, successful_payment, нигоҳ доштани шиносаи пардохт ва рӯйхати санҷиш пеш аз оғоз.

Нашр шуд:

Ҳисобномаҳои Telegram Stars (XTR) дар ботҳо: ҷараёни пардохт барои таҳиягарон, қадам ба қадам

Оё боти шумо чизи рақамӣ мефурӯшад, масалан обуна, мундариҷа, дархостҳои зеҳни сунъӣ ё ашёи дохили бозӣ? Пас пардохт танҳо бо Telegram Stars аст. Ин мақола ҷараёни ҳисобномаи Telegram Stars (XTR)-ро аз нигоҳи таҳиягар, мувофиқи ҳуҷҷатҳои расмии Bot API, қадам ба қадам шарҳ медиҳад. Барои он ки чаро бояд Stars бошад, нигаред молҳои рақамӣ дар ботҳо танҳо тавассути Stars.

Ҷараён ба таври мухтасар

ҚадамБот чӣ мекунадTelegram чӣ мефиристад
1sendInvoice бо currency = XTR—
2Интизор мешавадpre_checkout_query
3answerPreCheckoutQuery (дар давоми 10 сония)—
4Интизор мешавадsuccessful_payment
5Шиносаи пардохтро нигоҳ медорад, молро мерасонад—

Қадами 1: эҷоди ҳисобнома

Ду роҳ вуҷуд дорад:

  • Ҳисобномаи бот: усули sendInvoice. Чун мол рақамӣ аст, provider_token сатри холӣ аст ва майдони currency XTR мебошад. Ҳисобномаро ба чати шахсӣ, гурӯҳ ё канал фиристодан мумкин аст.
  • Ҳисобномаи inline: агар боти шумо реҷаи inline-ро дастгирӣ кунад, inputInvoiceMessageContent ба корбарон имкон медиҳад ҳисобномаро бо дӯстон, гурӯҳҳо ва каналҳо мубодила кунанд. Тугмаи пардохти онро борҳо истифода бурдан мумкин аст.

Қадами 2: интихоби рафтори фиристодан

Параметри start_parameter инро идора мекунад:

  1. Ҳисобномаи чандчатӣ: нусхаҳои фиристодашуда тугмаи пардохтро нигоҳ медоранд, то корбарони зиёд пардохт кунанд. Ҳисобномаҳои inline ҳамеша чандчатӣ мебошанд.
  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-ро ройгон санҷидан мумкин аст.

Баргардониданро чӣ гуна иҷро кунам?

Бо усули refundStarPayment дар Bot API.

Манбаъҳо

Stars ва Premium-ро бо доллари ИМА (USDT) харед

Бо калиди API: нархи Fragment, 0% (сомона: 5%).

Оғоз кардан