Telegram बॉट में USDT भुगतान कैसे स्वीकार करें
Telegram बॉट डिजिटल सामान बेचने की सबसे अच्छी जगहों में से एक हैं, और पारंपरिक चेकआउट जोड़ने की सबसे ख़राब जगहों में से एक। न कार्ड फ़ॉर्म है, न ऐसा होस्टेड पेमेंट पेज जो अपना लगे, और उपयोगकर्ताओं को ब्राउज़र में भेजा जाना पसंद नहीं। सादे REST API वाला क्रिप्टो पेमेंट गेटवे कहीं बेहतर बैठता है: आपका बॉट इनवॉइस बनाता है, भुगतान की जानकारी संदेश के रूप में भेजता है और जब वेबहुक बताता है कि पैसा आ गया, तब आगे बढ़ता है।
शुरू करने से पहले क्या चाहिए
- @BotFather से मिला बॉट टोकन।
- ऐसा सर्वर जो HTTPS रिक्वेस्ट ले सके। आपके बॉट का बैकएंड और वेबहुक रिसीवर एक ही एप्लिकेशन हो सकते हैं।
- VisualPay अकाउंट जिसमें टू-फ़ैक्टर ऑथेंटिकेशन चालू हो, एक मर्चेंट बना हो और पैनल से मर्चेंट API कुंजी कॉपी की गई हो। रजिस्ट्रेशन और आपका पहला मर्चेंट मुफ़्त है, और पहले कोई पहचान सत्यापन पास नहीं करना पड़ता।
- जिस भी कॉइन और नेटवर्क को आप स्वीकार करना चाहते हैं, उसके लिए आपके नियंत्रण वाला वॉलेट एड्रेस, जो मर्चेंट पर दर्ज हो।
प्रक्रिया की रूपरेखा
कोड लिखने से पहले यह साफ़ कर लेना मदद करता है कि कौन क्या करता है, क्योंकि यहीं गलती होने से बॉट के भुगतानों में पैसा रिसता है:
- उपयोगकर्ता बॉट में प्रोडक्ट चुनता है।
- आपका बैकएंड (क्लाइंट कभी नहीं) ट्रांज़ैक्शन बनाने के लिए गेटवे को कॉल करता है।
- आपका बॉट पेमेंट एड्रेस, USDT की सटीक राशि और समय-सीमा संदेश के रूप में भेजता है।
- उपयोगकर्ता अपने वॉलेट से भुगतान करता है।
- गेटवे भुगतान पकड़ता है और आपके वेबहुक को कॉल करता है।
- आपका बैकएंड स्थिति की जाँच करता है, ऑर्डर को भुगतान किया हुआ चिह्नित करता है और बॉट से सामान दिलवाता है।
ध्यान दें कि चरण 6 को चरण 5 शुरू करता है, उपयोगकर्ता की कोई हरकत नहीं। चैट में "मैंने भुगतान कर दिया" बटन स्टेटस दोबारा जाँचने के इशारे के तौर पर ठीक है। उसे कभी प्रोडक्ट जारी करने का आधार नहीं बनना चाहिए।
चरण 1: पूछें कि कौन सा नेटवर्क
USDT कई चेन पर मौजूद है और वे आपस में बदले नहीं जा सकते। TRC20 का USDT किसी ERC20 एड्रेस पर भेज दिया तो वह गया। इसलिए नेटवर्क को एक स्पष्ट विकल्प बनाएँ, खुले टेक्स्ट के बजाय इनलाइन कीबोर्ड के साथ:
{
"inline_keyboard": [
[{ "text": "USDT · TRC20 (Tron)", "callback_data": "pay:USDT:trc20" }],
[{ "text": "USDT · BEP20 (BSC)", "callback_data": "pay:USDT:bep20" }],
[{ "text": "USDT · ERC20 (Ethereum)", "callback_data": "pay:USDT:erc20" }]
]
}
एक काम की सलाह: TRC20 को सबसे ऊपर रखें। Tron पर नेटवर्क शुल्क इतना कम है कि छोटी ख़रीदारी के लिए यह आम तौर पर सबसे सुविधाजनक विकल्प होता है, और बॉट ज़्यादातर छोटी चीज़ें ही बेचते हैं।
चरण 2: ट्रांज़ैक्शन सर्वर पर बनाएँ
कॉलबैक क्वेरी आने पर आपका बैकएंड इनवॉइस बनाता है। API कुंजी हेडर में जाती है और कभी आपके सर्वर से बाहर नहीं जाती:
const res = await fetch(
'https://visualpay.net/api/v1/merchant/transaction/create',
{
method: 'POST',
headers: {
'x-api-key': process.env.VISUALPAY_API_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({
currency_symbol: 'USDT',
network_code: 'trc20',
amount_usd: 25.5,
ttl: 20,
order_id: order.id,
comment: `Telegram user ${ctx.from.id}`,
}),
}
);
const tx = await res.json();
कुछ फ़ील्ड ऐसे हैं जिन पर कॉपी करने के बजाय सोचना चाहिए:
ttlमिनटों में भुगतान की अवधि है, और एक्सचेंज रेट भी इतनी ही देर लॉक रहता है। बॉट के लिए बीस मिनट ठीक डिफ़ॉल्ट है: वॉलेट ऐप खोलने के लिए काफ़ी, और कीमत के उतार-चढ़ाव का जोखिम सीमित रखने के लिए छोटा।order_idआपका अपना पहचानकर्ता है। इसे Telegram उपयोगकर्ता और चैट के साथ सेव करें ताकि वेबहुक सही बातचीत तक वापस पहुँच सके।commentखुला टेक्स्ट है जो आपके पैनल में दिखता है। जब कोई उपयोगकर्ता कहे "मैंने भुगतान किया और कुछ नहीं मिला", तब यह सपोर्ट के काम आता है।
लौटाया गया ट्रैकिंग कोड तुरंत ऑर्डर के साथ जोड़कर सेव करें। बाद में भुगतान इसी से खोजा जाएगा।
चरण 3: इनवॉइस को संदेश के रूप में दिखाएँ
चूँकि गेटवे रीडायरेक्ट करने के बजाय भुगतान का डेटा लौटाता है, आप उसे सहज रूप में दिखा सकते हैं। राशि और एड्रेस को मोनोस्पेस में रखें ताकि Telegram में टैप करके कॉपी हो सकें, और एड्रेस को कभी दो पंक्तियों में न टूटने दें:
ठीक इतना भेजें:
1580.70 USDT
नेटवर्क: TRC20 (Tron)
इस एड्रेस पर:
TXk...c72E
⏱ 20 मिनट में समाप्त होगा।
दो चीज़ें जोड़ना फ़ायदेमंद है। QR कोड लगाएँ ताकि मोबाइल उपयोगकर्ता दूसरे डिवाइस से स्कैन कर सकें। और "भुगतान जाँचें" बटन जोड़ें जो स्टेटस एंडपॉइंट को कॉल करे। यह सामान जारी करने के लिए नहीं है। यह इसलिए है कि बेसब्र उपयोगकर्ता के पास सपोर्ट को संदेश भेजने के बजाय दबाने के लिए कुछ हो।
चरण 4: वेबहुक सँभालें
ऑर्डर असल में यहीं पूरा होता है। आपका एंडपॉइंट HTTPS होना चाहिए, और उसे सादा और सतर्क होना चाहिए:
app.post('/webhooks/visualpay', async (req, res) => {
// 1. जल्दी जवाब दें ताकि गेटवे इंतज़ार न करता रहे।
res.sendStatus(200);
const { tracking_code } = req.body;
// 2. पेलोड पर भरोसा करने के बजाय सर्वर पर दोबारा जाँचें।
const status = await verifyWithGateway(tracking_code);
if (status !== 'confirmed') return;
// 3. आइडेम्पोटेंसी: एक वेबहुक एक से ज़्यादा बार आ सकता है।
const order = await orders.findByTrackingCode(tracking_code);
if (!order || order.fulfilled) return;
await orders.markFulfilled(order.id);
await bot.telegram.sendMessage(order.chat_id, 'भुगतान मिल गया। यह रहा आपका प्रोडक्ट: …');
});
तीन नंबर वाली टिप्पणियाँ ही पूरा सबक़ हैं। जल्दी जवाब दें, क्योंकि धीमे वेबहुक हैंडलर से दोबारा कोशिशें होती हैं। रिक्वेस्ट बॉडी पर भरोसा करने के बजाय स्टेटस एंडपॉइंट से दोबारा जाँचें। इसमें एक API कॉल लगती है और जालसाज़ी की एक पूरी श्रेणी ख़त्म हो जाती है। आइडेम्पोटेंट रहें, क्योंकि दोबारा आए वेबहुक से प्रोडक्ट का दो बार पहुँचना एक असली बग है जो प्रोडक्शन में होगा।
चरण 5: मुश्किल स्थितियाँ सँभालें
बॉट की कामयाबी इस पर टिकी है कि जब चीज़ें ठीक से न चलें तब क्या होता है:
- समाप्त। अवधि बिना भुगतान के बंद हो गई। कुछ नहीं लिया गया। संदेश बदलकर यह बताएँ और "फिर कोशिश करें" बटन दें जो मौजूदा रेट पर नया ट्रांज़ैक्शन बनाए।
- कम भुगतान। अगर यह मर्चेंट पर तय की गई कमी की टॉलरेंस के भीतर है, तो भुगतान पास हो जाता है और आपकी क्रेडिट राशि असल में आई रकम से दोबारा निकाली जाती है। उस दायरे के बाहर उपयोगकर्ता को साफ़ बताएँ कि कितना आया और कितना चाहिए था।
- ज़्यादा भुगतान। स्वीकार होता है और ज़्यादा भुगतान के रूप में दर्ज होता है। अपनी नीति पहले से तय करें (फ़र्क को उनके अकाउंट बैलेंस में जोड़ें या मैन्युअल रिफ़ंड करें) और भुगतान से पहले बॉट में बता दें।
- देर से भुगतान। कोई समाप्ति के एक मिनट बाद भुगतान करता है। दोबारा जाँच वाला एंडपॉइंट समाप्त या रद्द हुए ट्रांज़ैक्शन के लिए ऑन-चेन भुगतान की फिर से जाँच करता है, इसलिए यह सपोर्ट का मामला बनने के बजाय ठीक किया जा सकता है।
सेटलमेंट पाना
चूँकि VisualPay नॉन-कस्टोडियल है, कन्फ़र्म हुए भुगतान किसी प्रोवाइडर के बैलेंस में आपकी निकासी का इंतज़ार नहीं करते। किसी नेटवर्क का आपका बैलेंस सेटलमेंट सीमा पार करते ही रकम अपने आप आपके बताए वॉलेट एड्रेस पर चली जाती है, आम तौर पर एक मिनट से कम में, और सिर्फ़ चेन का अपना नेटवर्क शुल्क कटता है।
सुरक्षा की बातें जिन्हें गंभीरता से लेना चाहिए
- API कुंजी की जगह आपके सर्वर का एनवायरनमेंट वेरिएबल है। बॉट के क्लाइंट कोड में कभी नहीं, रिपॉज़िटरी में कभी नहीं, संदेश में कभी नहीं।
- वेबहुक एंडपॉइंट HTTPS होने चाहिए, और आपका पाथ ऐसा होना चाहिए जिसका अंदाज़ा लगाना मुश्किल हो।
- ट्रांज़ैक्शन बनाने वाले कमांड पर रेट लिमिट लगाएँ। इसके बिना एक उपयोगकर्ता सैकड़ों खुले इनवॉइस बना सकता है।
- तय समय पर मिलान करें। रात का एक जॉब जो ट्रांज़ैक्शन की सूची निकालकर आपके अपने ऑर्डर से मिलाए, वे गिने-चुने मामले पकड़ लेता है जहाँ वेबहुक पूरी तरह छूट गया।
यह तरीका बॉट के लिए क्यों ठीक है
न कोई प्लगइन इंस्टॉल करना है, न कोई SDK अपडेट रखना है, न कोई रीडायरेक्ट जो बातचीत तोड़े। बॉट बॉट ही रहता है: संदेशों का एक सिलसिला जिसमें इनवॉइस आता है, उसका भुगतान होता है और वह पहुँचाए गए प्रोडक्ट में बदल जाता है। गेटवे जो कुछ करता है (रेट लॉक, एड्रेस जारी करना, चेन की निगरानी, सेटलमेंट), वह दो HTTP कॉल और एक वेबहुक के पीछे होता है।
आज ही USDT और USDC स्वीकार करना शुरू करें
KYC के बिना शुरू करें, चेकआउट अपनी साइट पर रखें और भुगतान सीधे अपने वॉलेट में पाएँ। रजिस्ट्रेशन और आपका पहला मर्चेंट मुफ़्त है।