SEP-7 लिंक से Stellar पर USDC कैसे स्वीकार करें
Cosmos Pay में Stellar पर पेमेंट लिंक एक SEP-7 रिक्वेस्ट है: आपका ग्राहक उसका QR कोड स्कैन करता है या उसे Freighter, LOBSTR या xBull जैसे वॉलेट में खोलता है, और वहीं USDC भुगतान को मंज़ूरी देता है। USDC सीधे आपके Stellar अकाउंट में जाता है, और लिंक के मेमो से भुगतान मिलते ही Cosmos Pay लिंक को भुगतान हुआ मार्क कर देता है। USDC पाने के लिए आपके अकाउंट में पहले से USDC की ट्रस्टलाइन होनी चाहिए।

SEP-7 लिंक में क्या होता है
SEP-7 भुगतान अनुरोधों के लिए Stellar का मानक है: एक web+stellar:pay लिंक, या उसका QR कोड, जिसमें आपका पता, राशि, एसेट और उसका इश्यूअर, और एक संख्यात्मक मेमो होता है।
Cosmos Pay हर लिंक के लिए एक मेमो बनाता है और आपके अकाउंट पर आने वाले भुगतानों में उसे खोजता है। वह ऐसा भुगतान स्वीकार करता है जो लिंक बनने के बाद उस मेमो के साथ, आपके पते पर, लिंक के एसेट में किया गया हो और, अगर लिंक में राशि तय है, तो ठीक उतनी ही राशि का हो।
अपना अकाउंट तैयार करें
- USDC पाने से पहले आपका Stellar अकाउंट नेटवर्क पर मौजूद होना चाहिए और उसमें USDC की ट्रस्टलाइन होनी चाहिए। अकाउंट जोड़ते समय Cosmos Pay यह जाँच नहीं करता, और ट्रस्टलाइन के बिना किसी अकाउंट पर किया गया भुगतान आपके ग्राहक के साइन करने के बाद विफल हो जाता है।
- डैशबोर्ड में अकाउंट को अपने संगठन में जोड़ें और डैशबोर्ड जो माँगे उस पर साइन करें: इससे साबित होता है कि अकाउंट आपका है।
- टेस्ट के लिए यही Testnet पर करें। Testnet का फ़ॉसेट Friendbot किसी अकाउंट में टेस्ट XLM भेजता है, और वहाँ लिंक XLM में भुगतान ले सकते हैं।
आपके ग्राहक को क्या चाहिए
- एक Stellar वॉलेट जो SEP-7 लिंक खोलता हो, जैसे Cosmos Pay Wallet, Freighter, LOBSTR, xBull, Albedo या Rabet, जिसमें USDC हो और नेटवर्क शुल्क के लिए कुछ XLM भी। Cosmos Pay पर किसी अकाउंट की ज़रूरत नहीं।
- सीधा USDC भुगतान। जो वॉलेट रास्ते में किसी दूसरे एसेट को USDC में बदलता है (पाथ पेमेंट), उससे लिंक का भुगतान पूरा नहीं होता।
- Testnet पर, भुगतान से पहले वॉलेट Testnet पर सेट हो: लिंक में नेटवर्क का नाम नहीं होता, और SEP-7 का पालन करने वाला वॉलेट तब मेननेट मान लेता है।
Stellar पर अपना पहला USDC भुगतान स्वीकार करें
सैंडबॉक्स पर जाएँ
डैशबोर्ड में साइन इन करें और ऊपर “सैंडबॉक्स” चुनें। वहाँ आप जो लिंक बनाते हैं, वे Stellar Testnet पर चलते हैं और उनमें कोई असली पैसा ट्रांसफ़र नहीं होता।
अपना Stellar अकाउंट जोड़ें
पक्का करें कि अकाउंट मौजूद है और उसमें USDC की ट्रस्टलाइन है, फिर उसे अपने संगठन की सेटिंग्स में जोड़ें और डैशबोर्ड जो माँगे उस पर साइन करें।
लिंक बनाएँ
“भुगतान” में “पेमेंट लिंक बनाएँ” चुनें, फिर Stellar, राशि (या कोई राशि नहीं) और USDC चुनें, उसके बाद अपना अकाउंट और, चाहें तो, एक संदेश।
वॉलेट से इसका भुगतान करें
चेकआउट पेज खोलें और उसका QR कोड उसी नेटवर्क पर सेट किसी Stellar वॉलेट से स्कैन करें, या उसी डिवाइस पर लिंक खोलें। भुगतान को मंज़ूरी दें, और Cosmos Pay के भुगतान ढूँढते ही चेकआउट पर “भुगतान हो गया” दिखता है।
अपने सर्वर पर इसकी पुष्टि करें
डैशबोर्ड में एक वेबहुक एंडपॉइंट जोड़ें। भुगतान की पुष्टि होने पर Cosmos Pay HMAC-SHA256 से साइन किया गया PAYMENT_INTENT_SUCCEEDED भेजता है। जब यह पहुँचे, तब ऑर्डर डिलीवर करें।
प्रोडक्शन पर जाएँ
“प्रोडक्शन” चुनें और एक लाइव API की बनाएँ (यह prod_ से शुरू होती है)। अब लिंक Stellar के मेननेट पर चलते हैं, जहाँ Circle का USDC पहले से सेट है।
अपने सर्वर से लिंक बनाएँ
डेस्टिनेशन के रूप में अपना अकाउंट, राशि और, USDC के लिए, इश्यूअर के साथ एसेट कोड देकर POST /v1/payment-intents/pay कॉल करें, या TypeScript SDK में client.paymentIntents.createPay इस्तेमाल करें: डिफ़ॉल्ट chain Stellar है। रिस्पॉन्स में लिंक (उसका uri web+stellar:pay से शुरू होता है) और उसका QR कोड होता है।
अगर आप अपने ग्राहक का अकाउंट जानते हैं, तो एक ट्रांज़ैक्शन इंटेंट (POST /v1/payment-intents/tx, या SDK में createTx) इसके बजाय एक बिना साइन किया ट्रांज़ैक्शन लौटाता है, जिसे ग्राहक साइन करता है। इसे पाँच मिनट के भीतर साइन करना ज़रूरी है।
अगर आप अपना मेमो खुद सेट करते हैं, तो उसे सिर्फ़ एक भुगतान के लिए इस्तेमाल करें: अलग शर्तों के साथ वही मेमो अस्वीकार कर दिया जाता है।
जानने लायक बातें
- आप राशि खाली छोड़ सकते हैं और अपने ग्राहक को उसे चुनने दे सकते हैं। 300 अक्षरों तक का एक संदेश आपके ग्राहक के वॉलेट में दिखता है।
- भुगतान पर आपका अपना शुल्क होने पर चेकआउट आपके ग्राहक का अकाउंट माँगता है और एक ही ट्रांज़ैक्शन बनाता है, जो आपको और आपके शुल्क वाले वॉलेट, दोनों को भुगतान करता है।
- डैशबोर्ड में पेंडिंग Stellar लिंक पर एक जाँच होती है, जो ट्रांज़ैक्शन हैश से उसका भुगतान पूरा कर देती है।
- लिंक की समय-सीमा खत्म होने के बाद आए भुगतान से लिंक का भुगतान पूरा करने के लिए, उसका ट्रांज़ैक्शन हैश POST /v1/payment-intents/:id/validate पर भेजें।
- Stellar का नेटवर्क शुल्क आपके ग्राहक का वॉलेट XLM में चुकाता है। निजी भुगतान, जो राशि को ऑन-चेन छिपाते हैं, Stellar पर XLM में चलते हैं, फ़िलहाल Testnet पर।
मेरे अकाउंट पर किया गया भुगतान विफल क्यों हुआ?
सबसे आम कारण है पाने वाले अकाउंट पर USDC ट्रस्टलाइन का न होना। ट्रस्टलाइन जोड़ें, फिर नया लिंक बनाएँ और उसे दोबारा भेजें।
कौन-से वॉलेट SEP-7 लिंक का भुगतान कर सकते हैं?
कोई भी Stellar वॉलेट जो SEP-7 लिंक खोलता है, जैसे Cosmos Pay Wallet, Freighter, LOBSTR, xBull, Albedo या Rabet।
क्या मेरा ग्राहक USDC लिंक का भुगतान XLM से कर सकता है?
नहीं। लिंक का भुगतान सिर्फ़ सीधे USDC भुगतान से पूरा होता है: रास्ते में XLM को USDC में बदलने वाले भुगतान से नहीं।
क्या मैं असली पैसे के बिना टेस्ट कर सकता हूँ?
हाँ। सैंडबॉक्स में और टेस्ट कीज़ (dv_) के साथ लिंक Stellar Testnet पर चलते हैं, जहाँ USDC पहले से सेट है और Friendbot टेस्ट XLM भेजता है।
