Telegram payments की मदद से खरीदार चैट छोड़े बिना किसी bot या Mini App को पेमेंट कर सकता है। Bot एक invoice भेजता है, Telegram अपनी payment sheet खोलता है, और पैसा विक्रेता तक पहुँचता है: फ़िज़िकल सामान के लिए किसी payment provider के ज़रिए, और डिजिटल सामान के लिए Telegram Stars के रूप में। इस गाइड में हम बताएँगे कि Telegram payments कैसे काम करते हैं, आप जो बेचते हैं उसके लिए कौन-सा विकल्प सही है, हर विकल्प का खर्च कितना है, और कोड के साथ या बिना कोड के पेमेंट लेना स्टेप बाय स्टेप कैसे शुरू करें।
क्या आप उन सभी तरीकों की पूरी लिस्ट ढूँढ रहे हैं जिन्हें एक शॉप जोड़ सकती है, जिनमें TON और दक्षिण-पूर्व एशिया के वॉलेट भी शामिल हैं? वह Telegram payment methods में है। यह पेज इस बारे में है कि Telegram में पेमेंट कैसे काम करते हैं और उन्हें चालू कैसे करें।
Telegram payments कैसे काम करते हैं#
Telegram का Bot Payments API एक मुफ़्त और खुला प्लेटफ़ॉर्म है। इसमें दो रास्ते हैं:
- फ़िज़िकल सामान और सेवाओं का पेमेंट थर्ड-पार्टी providers के ज़रिए होता है। Telegram ऐसे 20 से ज़्यादा providers के साथ काम करता है, और खरीदार 200 से ज़्यादा देशों से पेमेंट कर सकते हैं। इन पेमेंट्स पर Telegram कोई कमीशन नहीं लेता और कार्ड की जानकारी सेव नहीं करता; कार्ड provider संभालता है। Telegram की payment sheet पर Apple Pay और Google Pay चलते हैं।
- डिजिटल सामान और सेवाओं का पेमेंट Telegram Stars में ही होना चाहिए, जिसका currency code
XTRहै। Telegram का कहना है कि अगर आप डिजिटल सामान दूसरी करेंसी या थर्ड-पार्टी providers के ज़रिए बेचते हैं, तो वह आपका bot या Mini App मोबाइल यूज़र्स को नहीं दिखा सकता।
हर पेमेंट एक ही रास्ते से गुज़रता है:
- Invoice. Bot आइटम और कुल रकम के साथ एक invoice भेजता है (
sendInvoice), या Mini App किसी लिंक से invoice खोलता है। - Shipping (वैकल्पिक). अगर डिलीवरी का खर्च पते पर निर्भर करता है, तो Telegram पहले bot से shipping के विकल्प माँगता है।
- Pre-checkout जाँच. पैसे काटने से पहले Telegram bot से ऑर्डर कन्फ़र्म करने को कहता है। Bot के पास जवाब देने के लिए 10 सेकंड होते हैं, वरना पेमेंट रद्द हो जाता है।
- पेमेंट. खरीदार sheet पर कन्फ़र्म करता है: कार्ड, Apple Pay, Google Pay या Stars से।
- कन्फ़र्मेशन. Bot को
successful_paymentमैसेज मिलता है और वह ऑर्डर डिलीवर करता है।
आप जो बेचते हैं, उसके लिए कौन-सा विकल्प सही है#
| विकल्प | खरीदार किससे पेमेंट करता है | किसके लिए | Telegram कितना लेता है | सेटअप |
|---|---|---|---|---|
| Telegram Stars | Stars बैलेंस | डिजिटल सामान: फ़ाइलें, एक्सेस, मेंबरशिप | विक्रेता को हर Star पर लगभग $0.013 मिलते हैं | कुछ भी जोड़ने की ज़रूरत नहीं |
| @BotFather के ज़रिए card provider (Stripe, Freedom Pay और अन्य) | Telegram की sheet पर कार्ड, Apple Pay, Google Pay | फ़िज़िकल सामान और ऑफ़लाइन सेवाएँ | कुछ नहीं; provider अपनी फ़ीस लेता है | एक provider token |
| Stripe Connect (Tiny Shops) | Stripe के सुरक्षित checkout पेज पर कार्ड | Stripe वाले देशों में फ़िज़िकल सामान | कुछ नहीं; Stripe की फ़ीस लगती है | डैशबोर्ड से Stripe onboarding |
| TON | कोई भी TON वॉलेट | क्रिप्टो समझने वाले खरीदार, दूसरे देशों के खरीदार | कुछ नहीं | एक वॉलेट एड्रेस |
| Manual order | जो आप तय करें: कैश, ट्रांसफ़र | लोकल डिलीवरी, कैश ऑन डिलीवरी | कुछ नहीं | कुछ नहीं |
Provider की फ़ीस देश और कॉन्ट्रैक्ट के हिसाब से अलग होती है। Stripe अपने रेट stripe.com/pricing पर बताता है; Freedom Pay जैसे providers इन्हें आपके एग्रीमेंट में तय करते हैं। आप पर कौन-सा रेट लागू होता है, यह किसी ब्लॉग की टेबल से नहीं, अपने provider से पता करें।
Telegram Stars संक्षेप में#
खरीदार Apple या Google की in-app purchase से या @PremiumBot से Stars खरीदते हैं, और फिर उन्हें bots और Mini Apps में खर्च करते हैं। विक्रेता के लिए इनकी वैल्यू Telegram की bot developer terms तय करती हैं:
- इनाम (reward) के रूप में हर Star पर लगभग $0.013, जो Fragment के ज़रिए मिलता है।
- अगर आप बैलेंस Telegram Ads पर खर्च करते हैं, तो हर Star पर $0.02।
- मिले हुए Stars को rewards या ads के लिए उपलब्ध होने में 21 दिन तक लग सकते हैं।
Stars सिर्फ़ पूरी संख्या में होते हैं, टिप का विकल्प नहीं होता, और Stars पेमेंट के साथ Telegram खरीदार का नाम, फ़ोन या पता नहीं भेजता। रिफ़ंड Bot API (refundStarPayment) से वापस जाते हैं, और Stars में बेचने वाले bot को /paysupport कमांड का जवाब देना ज़रूरी है। कार्ड के साथ पूरी तुलना, Stars-से-USD टेबल के साथ, Telegram Stars vs Stripe में है।
Telegram पर पेमेंट कैसे लें (सामान्य तरीका)#
अगर आप bot खुद बनाते हैं, तो Telegram के docs के हिसाब से ये स्टेप हैं:
- @BotFather से एक bot बनाएँ। हमारी bot गाइड में यह पूरा तरीका बताया गया है।
- Provider token लें। @BotFather में:
/mybots→ आपका bot → Bot Settings → Payments। एक provider चुनें, उसका साइन-अप पूरा करें और token कॉपी करें। टेस्ट वाले token से शुरू करें। Stars के लिए यह स्टेप छोड़ दें: token एक खाली string होता है। - अपने कोड से
sendInvoiceयाcreateInvoiceLinkके ज़रिए invoices भेजें, उस करेंसी में जिसे आपका provider सपोर्ट करता है। - 10 सेकंड के अंदर pre-checkout query का जवाब दें, और अगर आप flexible shipping इस्तेमाल करते हैं तो shipping query का भी।
successful_paymentको हैंडल करें: ऑर्डर को paid मार्क करें और सामान भेजें।- Telegram की live चेकलिस्ट पूरी करें: bot के मालिक वाले अकाउंट पर two-step verification, एक
/termsकमांड जिसे खरीदार मानते हैं, एक/supportकमांड, और विवाद (disputes) और chargebacks खुद संभालने की तैयारी। फिर टेस्ट token की जगह live token लगाएँ (उसके बीच में:LIVE:होता है)।
एक store builder आपके लिए स्टेप 3 से 5 तक का काम करता है, साथ में कैटलॉग, कार्ट और ऑर्डर अलर्ट भी।
Tiny Shops में Telegram payments कैसे लें#
Tiny Shops एक no-code Telegram Mini App shop builder है। आपका स्टोर आपके अपने bot के अंदर खुलता है, और checkout Telegram की payment sheet पर पूरा होता है।
Telegram provider के ज़रिए कार्ड#
- @BotFather →
/mybots→ आपका स्टोर bot → Bot Settings → Payments में जाकर एक टेस्ट token लें। दो providers के लिए स्टेप बाय स्टेप गाइड: Stripe और Freedom Pay। - Storefront Settings → Orders & Payments खोलें। Checkout Mode में Telegram Payments चुनें।
- Add Provider पर क्लिक करें। Provider Name भरें (कोई भी नाम, जैसे "Stripe"), token को Provider Token में पेस्ट करें, Test Mode और Active को चालू रहने दें, और Save Provider पर क्लिक करें।
- Store Currency में स्टोर की करेंसी जाँचें। यह ऐसी होनी चाहिए जिसे आपका provider सपोर्ट करता हो। अगर पेमेंट
PAYMENT_PROVIDER_INVALIDके साथ फ़ेल होता है, तो आम तौर पर वजह करेंसी ही होती है। - Checkout → Payment methods खोलें और देखें कि लिस्ट में Telegram Invoice है। अगर नहीं है, तो Add method पर क्लिक करके इसे जोड़ें। कोई active provider होते ही यह Connected दिखाता है।
- Invoice के फ़ील्ड चुनें। Invoice Field Configuration में ज़रूरत के हिसाब से Request Name, Request Phone Number, Request Email या Request Shipping Address चालू करें। Flexible Shipping Pricing से डिलीवरी का दाम पते पर निर्भर कर सकता है। Enable Tips से 4 तक सुझाई गई टिप रकम और एक Maximum Tip Amount जुड़ जाते हैं।
- अपने फ़ोन से एक टेस्ट ऑर्डर करें। Stripe के टेस्ट token के साथ Telegram का टेस्ट कार्ड
4242 4242 4242 4242, कोई भी आगे की तारीख और कोई भी CVC इस्तेमाल करें। - Live हो जाएँ। @BotFather से live token लें, Edit Provider पर क्लिक करें, token पेस्ट करें, Test Mode बंद करें और सेव करें।
Telegram Stars#
- Storefront Settings → Orders & Payments में Telegram Payments चुनें, फिर Store Currency को Telegram Stars (XTR) पर सेट करें। पेज पर Telegram Stars Enabled दिखता है: न token चाहिए, न कोई सेटिंग।
- Checkout → Payment methods में Telegram Stars जोड़ें।
- अपने प्रोडक्ट्स के दाम पूरे Stars में रखें।
एक स्टोर की एक ही करेंसी होती है, इसलिए एक स्टोर या तो Stars लेता है या card provider। अगर आप पार्सल वाला सामान और डिजिटल सामान दोनों बेचते हैं, तो एक ही अकाउंट पर दो स्टोर चलाएँ।
दूसरे विकल्प#
Stripe Connect (Stripe के checkout पेज पर कार्ड, पेआउट आपके अपने Stripe में), TON, इंडोनेशिया, फ़िलीपींस और मलेशिया के लिए Xendit, और Manual order, ये सभी Checkout → Payment methods से सेट होते हैं। हर एक के स्टेप Telegram payment methods में हैं।
Telegram में Apple Pay और Google Pay#
वॉलेट्स को अलग से चालू नहीं करना पड़ता। Telegram की payment sheet Apple Pay और Google Pay सपोर्ट करती है, और जब आपका provider और खरीदार का डिवाइस इन्हें सपोर्ट करते हैं, तो ये दिखने लगते हैं। अगर किसी खरीदार को Apple Pay नहीं दिखता, तो जाँचें कि आपका provider आपके देश में इसे देता है या नहीं। Stars पेमेंट में वॉलेट का इस्तेमाल होता ही नहीं: खरीदार अपने Stars बैलेंस से पेमेंट करता है।
इसका खर्च कितना है#
Provider वाले पेमेंट्स पर Telegram कुछ नहीं लेता; आपका provider अपनी फ़ीस लेता है। Tiny Shops का खर्च हर महीने Free पर $0, Starter पर $9.99, Pro पर $29 और Scale पर $79 है, और हर ऑर्डर पर उसकी कुल रकम का प्लान वाला प्रतिशत लगता है: 5%, 3%, 1.5% या 0.7%। हर अकाउंट को पहले 50 ऑर्डर मुफ़्त मिलते हैं, सिर्फ़ एक बार, हर महीने नहीं। Stars की बिक्री पर प्रतिशत पहली बिक्री से ही लगता है। Pro पर प्रतिशत के रूप में महीने में ज़्यादा से ज़्यादा $149 लगते हैं, Scale पर ज़्यादा से ज़्यादा $79। पूरी जानकारी pricing पर है।
समस्याएँ और उनका हल#
| समस्या | संभावित वजह | हल |
|---|---|---|
पेमेंट PAYMENT_PROVIDER_INVALID के साथ फ़ेल होता है | Provider आपकी स्टोर करेंसी सपोर्ट नहीं करता | Store Currency बदलें या provider से पूछें कि वह कौन-सी करेंसी लेता है |
| Telegram Invoice पर Not connected दिखता है | कोई active provider नहीं है | Orders & Payments में एक provider जोड़ें और Active चालू रखें |
| Checkout पर Stars का विकल्प नहीं दिखता | स्टोर करेंसी XTR नहीं है | Store Currency को Telegram Stars (XTR) पर सेट करें |
| टेस्ट पेमेंट चलते हैं, असली नहीं | अभी भी टेस्ट token लगा है | Live token पेस्ट करें और Test Mode बंद करें |
| ऑर्डर अलर्ट नहीं आता | अलर्ट भेजने की जगह सेट नहीं है | इसे Order Notifications में सेट करें और Send test order alert दबाएँ |
अक्सर पूछे जाने वाले सवाल#
Telegram payments कैसे काम करते हैं? Bot एक invoice भेजता है, Telegram अपनी native payment sheet दिखाता है, खरीदार कार्ड, वॉलेट या Stars से पेमेंट करता है, और bot को कन्फ़र्मेशन मिलता है, जिसके बाद वह ऑर्डर डिलीवर करता है। कार्ड पेमेंट थर्ड-पार्टी provider से होकर जाते हैं; Stars Telegram के अंदर ही रहते हैं।
क्या Telegram पेमेंट पर फ़ीस लेता है? थर्ड-पार्टी providers के ज़रिए होने वाले पेमेंट पर नहीं; provider अपनी फ़ीस लेता है। Stars के साथ, Telegram की developer terms के मुताबिक विक्रेता को इनाम के रूप में हर Star पर लगभग $0.013 मिलते हैं।
क्या मैं Telegram में Apple Pay ले सकता हूँ? हाँ, अगर आपका provider इसे सपोर्ट करता है। Apple Pay और Google Pay Telegram की payment sheet पर दिखते हैं, स्टोर में अलग से कोई सेटअप नहीं करना पड़ता।
क्या मैं Telegram में डिजिटल प्रोडक्ट्स कार्ड से बेच सकता हूँ? Bot या Mini App के अंदर नहीं। Telegram डिजिटल सामान और सेवाओं के लिए Stars ज़रूरी करता है, और जो bot इन्हें दूसरी करेंसी में बेचता है, उसे मोबाइल यूज़र्स से छिपा सकता है।
क्या मुझे डेवलपर की ज़रूरत है? Store builder के साथ नहीं। Tiny Shops में सेटअप बस इतना है: @BotFather से एक token और डैशबोर्ड में कुछ सेटिंग्स।
अपना स्टोर खोलें और पहला Telegram पेमेंट लें: tiny-shops.com →
