বটে Telegram Stars ইনভয়েস (XTR): ডেভেলপারদের জন্য পেমেন্ট ফ্লো, ধাপে ধাপে
বটে Stars-এর বিনিময়ে ডিজিটাল পণ্য বিক্রি: XTR সহ sendInvoice, 10 সেকেন্ডের pre_checkout_query উত্তর, successful_payment, চার্জ আইডি সংরক্ষণ এবং একটি লঞ্চ চেকলিস্ট।
প্রকাশিত:

আপনার বট কি ডিজিটাল কিছু বিক্রি করে, যেমন সাবস্ক্রিপশন, কনটেন্ট, AI রিকোয়েস্ট বা ইন-গেম আইটেম? তাহলে পেমেন্ট শুধু 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 কেনার দিক
আপনার ব্যবহারকারীরা অ্যাপে বা @PremiumBot-এর মাধ্যমে Stars কেনেন, আর PayStars সেগুলো USDT-এর বিনিময়ে বিক্রি করে। নিজের সার্ভিসকে স্বয়ংক্রিয়ভাবে Stars কিনতে হলে PayStars API ও API ওভারভিউ সেটি কভার করে।
প্রশ্নোত্তর
Stars-এর বদলে ক্রিপ্টো বা অন্য মুদ্রা কি গ্রহণ করা যায়?
না। Telegram অ্যাপের ভিতরে ডিজিটাল পণ্য ও সেবার মূল্য শুধু Stars-এ পরিশোধ হয়।
পেমেন্ট কীভাবে পরীক্ষা করব?
আপনার বটকে Telegram-এর নির্দিষ্ট টেস্ট এনভায়রনমেন্টে যুক্ত করুন, যেখানে Stars পেমেন্ট বিনামূল্যে পরীক্ষা করা যায়।
রিফান্ড কীভাবে দেব?
Bot API-এর refundStarPayment মেথড দিয়ে।
উৎস
Related pages
ডলার (USDT) দিয়ে Stars ও Premium কিনুন
API কী দিয়ে: Fragment মূল্য, 0% (ওয়েবসাইট: 5%)। ওয়েবসাইটে পেমেন্টের আগে সঠিক মোট দেখানো হয়।
More news
আপনার Telegram Stars বটের রিফান্ড নীতি লেখা: টেমপ্লেট ও উদাহরণএকটি Telegram Stars বটের রিফান্ড নীতিতে কী থাকা উচিত: যোগ্যতা, সময়সীমা, /paysupport ও refundStarPayment, এবং আপনি মানিয়ে নিতে পারেন এমন নমুনা বাক্য।পড়ুন →
আপনার অ্যাকাউন্টে প্রবেশাধিকার হারালে আপনার Telegram Stars-এর কী হয়Stars আপনার ফোনের নয়, আপনার Telegram অ্যাকাউন্টের। প্রবেশাধিকার হারালে তাদের কী হয়, কীভাবে ফিরে আসবেন এবং ব্যালেন্স কীভাবে রক্ষা করবেন, জেনে নিন।পড়ুন →
ক্রিয়েটর বা ব্যবসা হিসেবে Telegram Stars আয়ের হিসাব রাখাTelegram Stars আয়ের পরিষ্কার হিসাব কীভাবে রাখবেন: কী লগ করবেন, Fragment উত্তোলন ট্র্যাক করা, ব্যক্তিগত ও ব্যবসা আলাদা রাখা, এবং একজন হিসাবরক্ষককে কী জিজ্ঞাসা করবেন।পড়ুন →