वियतनाम: VietQR, NAPAS 247 और MoMo भुगतान के अलग-अलग स्तरों पर हैं

दो बटन वाले चेकआउट की कल्पना करें: "VietQR" और "MoMo"। VietQR MoMo दोनों भुगतान बराबर तेज़ दिख सकते हैं, लेकिन उनका रास्ता अलग है। पहले मामले में ख़रीदार बैंक डिटेल्स स्कैन करता है और पैसा ट्रांसफ़र करता है। दूसरे में वह MoMo का तय पेमेंट परिदृश्य खोलता है। दोनों अलग आइडेंटिफ़ायर छोड़ते हैं और अलग कन्फ़र्मेशन माँगते हैं। उन्हें एक इंटरनल लेजर में जोड़ा जा सकता है, लेकिन उनके बाहरी स्टेटस को एक जैसा घोषित नहीं किया जा सकता।

ख़ास तौर पर ज़रूरी है कि VietQR और NAPAS 247 को एक के बाद एक होने वाले दो स्वतंत्र भुगतान न माना जाए। NAPAS FastFund 247 via VietQR नाम के ख़ास प्रोडक्ट में कोड उसी बैंक ट्रांसफ़र को एड्रेस करने का सुविधाजनक तरीक़ा है। नीचे इस ढाँचे को MoMo के मर्चेंट API से अलग रखा गया है। बात वैध रेवेन्यू स्वीकार करने की है, किसी भी उद्योग को लोकल रेल इस्तेमाल करने की अनुमति की नहीं।

VietQR से एक ख़रीद: क्या जाँचना चाहिए

NAPAS भागीदार बैंकों के खातों के बीच VietQR स्कैन से ट्रांसफ़र का वर्णन करता है — चौबीसों घंटे, एक ट्रांज़ैक्शन की राशि 500 मिलियन VND से कम। यह इस transfer प्रोडक्ट का वर्णन है, वियतनाम के हर QR भुगतान का नहीं। कोड बैंक डिटेल्स डालना आसान बनाता है, लेकिन यह साबित नहीं करता कि प्राप्तकर्ता आपके PSP का अनुबंधित मर्चेंट है। NAPAS का विवरण।

चेकआउट की तरफ़ बैंक, गंतव्य खाता, दिखाया गया प्राप्तकर्ता, अपेक्षित राशि, भुगतान का उद्देश्य, निर्देश जारी होने का समय और ऑर्डर की वैधता अवधि दर्ज करना उपयोगी है। ये इंटरनल रिकॉर्ड के सुझाए गए फ़ील्ड हैं, यह दावा नहीं कि हर स्टैटिक VietQR में ये सब ज़रूर होते हैं। अगर राशि या reference भुगतानकर्ता ख़ुद डालता है, तो पहले से तय करना होगा कि ग़लती, टेक्स्ट न होने और ऑर्डर बंद होने के बाद भुगतान पर क्या होगा।

ख़तरनाक भ्रम ऐसा दिखता है: "QR में ऑर्डर नंबर है, तो बैंक ऑर्डर नंबर किसी सुविधाजनक फ़ील्ड में लौटा देगा।" पूरा रास्ता जाँचना ज़रूरी है: निर्देश बनना, ख़रीदार के बैंक की स्क्रीन, असल इनकमिंग ट्रांसफ़र और प्राप्तकर्ता का एक्सपोर्ट। अगर टेक्स्ट कटता है, नॉर्मलाइज़ होता है या आपका सर्विसिंग चैनल उसे आगे नहीं भेजता, तो यह पायलट में पकड़ा जाता है। ऐसी किसी विशेषता पर ऑटोमैटिक क्रेडिट न बनाएँ जिसकी अनुबंध और टेस्ट ने पुष्टि नहीं की।

MoMo के लिए मर्चेंट ढाँचा चाहिए

MoMo का आधिकारिक onboarding क्रम से merchant profile, टेस्ट इंटीग्रेशन, अकाउंट की जाँच, production credentials, production पर जाँच और लॉन्च की मंज़ूरी से गुज़रता है। यह निजी वॉलेट के अधिकारों का वर्णन नहीं है। टेस्ट एनवायरनमेंट तक पहुँच बताती है कि आप इंटीग्रेशन लिख सकते हैं, यह नहीं कि उद्योग, लीगल एंटिटी या सेटलमेंट का कोई ख़ास तरीक़ा स्वीकार हो गया।

दो जाँचों को अलग रखें: बिज़नेस के दस्तावेज़ और ख़रीदार की भुगतान ऑथराइज़ करने की क्षमता। उदाहरण के लिए, MoMo के मौजूदा कोड की सूची में इनकार कोड 4002 है, जो C06 से असत्यापित डेटा और NFC से बायोमेट्रिक अपडेट की ज़रूरत से जुड़ा है। कोड 1004 दैनिक या मासिक सीमा पार होने से, और 1005 एक्सपायर हुए URL या QR से संबंधित है। ये अलग कारण हैं, और आँख मूँदकर अनुरोध दोहराना कोई सुधार नहीं है।

एक धुँधले "ID" की जगह पाँच आइडेंटिफ़ायर

MoMo मॉडल में partnerCode, orderId, requestId, transId और अपने ऑर्डर ID में फ़र्क़ करना चाहिए। पार्टनर और ऑर्डर संदर्भ तय करते हैं, requestId अनुरोध से जुड़ा है, transId MoMo जारी करता है। स्टेटस क्वेरी में partnerCode, orderId, requestId और सिग्नेचर इस्तेमाल होते हैं। नाम और भूमिकाएँ डॉक्यूमेंटेशन के ख़ास वर्ज़न से ली जाती हैं; वैल्यू केस और फ़ॉर्मैटिंग खोए बिना सहेजी जाती हैं।

अपने हिसाब-किताब के लिए प्रयास नंबर जोड़ें। एक ऑर्डर में पहला प्रयास बिना भुगतान के रह सकता है और दूसरा सफल हो सकता है। रिफ़ंड सफल वित्तीय ट्रांज़ैक्शन से जुड़ा होगा, न कि बस आख़िरी खोले गए पेज से। हर प्रयास के लिए अपेक्षित VND राशि और मिला नतीजा रखें; प्रोडक्ट का नाम या फ़ोन नंबर यूनिक की के रूप में इस्तेमाल न करें।

ब्राउज़र में ख़रीदार की वापसी से ज़्यादा अहम है IPN

MoMo नतीजा सर्वर-साइड POST से ipnUrl पर भेजता है। डॉक्यूमेंटेशन सिग्नेचर की जाँच और partnerCode, orderId व amount के मिलान की माँग करता है; प्राप्तकर्ता का जवाब 15 सेकंड के भीतर HTTP 204 होना चाहिए। resultCode 0 संबंधित ट्रांज़ैक्शन की सफलता है, 9000 सफल ऑथराइज़ेशन। अलग capture वाले परिदृश्य में दूसरे को अपने आप पूरा हुआ डेबिट नहीं माना जाना चाहिए। IPN के नियम।

अपनी प्रोसेसिंग idempotent होनी चाहिए: एक पुष्ट मनी इवेंट एक ही रिकॉर्ड बनाता है, भले नोटिफ़िकेशन दोबारा आए। सुझाया गया क्रम है — अनुरोध जाँचें, इवेंट को भरोसेमंद तरीक़े से दर्ज करें, जल्दी प्राप्ति की पुष्टि करें, और भारी डिलीवरी का काम क्यू से चलाएँ। अगर नोटिफ़िकेशन खो गया, तो आधिकारिक स्टेटस क्वेरी इस्तेमाल करें, नई रसीद के लिए ख़रीदार से दोबारा भुगतान न करवाएँ।

एक और सीमा है: HTTP 2xx दिखाता है कि API अनुरोध सफलतापूर्वक प्रोसेस हुआ, लेकिन यह बिज़नेस कोड और ऑपरेशन के प्रकार की जाँच की जगह नहीं लेता। पेमेंट पेज बनना, ऑथराइज़ेशन और अंतिम सफल भुगतान अलग-अलग सवालों के जवाब हैं। यूज़र को संदेश में पुष्ट स्थिति ही बतानी चाहिए, सर्वर के हर तकनीकी रूप से सफल जवाब पर "भुगतान हो गया" नहीं दिखाना चाहिए।

रिफ़ंड अपने नतीजे वाला अलग ऑपरेशन है

MoMo का Refund API रिफ़ंड के लिए नया orderId माँगता है जो मूल ऑर्डर से अलग हो, साथ में requestId, राशि और मूल सफल भुगतान का transId। refund का नतीजा जानने के लिए अलग क्वेरी है। आंशिक रिफ़ंड बची हुई रिफ़ंड-योग्य राशि से ज़्यादा नहीं होना चाहिए। डॉक्यूमेंटेशन पेमेंट मेथड के हिसाब से संख्यात्मक सीमाएँ अलग बताता है; एक सीमा को MoMo के सभी प्रोडक्ट पर लागू नहीं किया जा सकता।

एक उदाहरण में ख़रीदार ने 400 000 VND चुकाए, फिर उसके लिए आंशिक रिफ़ंड तय हुआ। सिस्टम मंज़ूर रिफ़ंड राशि रिज़र्व करता है, उसे मूल transId से जोड़ता है और नतीजे को अलग ट्रैक करता है। अगर अनुरोध टाइमआउट पर ख़त्म हुआ, तो पहले पता किया जाता है कि वह स्वीकार हुआ या नहीं। इस जाँच के बिना नए आइडेंटिफ़ायर के साथ नया refund बनाने से भरपाई दोहराए जाने का जोखिम है।

पेमेंट API के दायरे से बाहर क्या रहता है

सेटलमेंट शेड्यूल, कमीशन, रिज़र्व, अनुमत सामान और बिज़नेस का पैसा स्वीकार करने का अधिकार अनुबंध और लागू नियमों से तय होते हैं। MoMo की जाँच और बैंक खाता होना उद्योग की अनुमति की जगह नहीं लेते। वियतनाम में आधिकारिक संस्थाएँ अवैध जुआ चलाने की ज़िम्मेदारी अलग से स्पष्ट करती हैं; ऑनलाइन गेम के नियम भी वर्चुअल आइटम को खुलकर निकाले जा सकने वाले पैसे के बराबर नहीं मानते।

इसलिए किसी ख़ास गेमिंग बिज़नेस के लिए लोकल मेथड की उपयुक्तता इस बात से नहीं निकाली जा सकती कि QR स्कैन हो जाता है या API जवाब देता है। अच्छे इंटीग्रेशन का व्यावहारिक नतीजा कुछ और है: हर वैध भुगतान का साबित स्टेटस, जुड़ा हुआ ऑर्डर, सेटलमेंट का स्पष्ट दायित्व और जाँचने योग्य रिफ़ंड। इस तस्वीर में VietQR, NAPAS 247 और MoMo की भूमिकाएँ अलग हैं, और पैसे की तीन स्वतंत्र आवाजाही गढ़ने की ज़रूरत नहीं है।