VibeFox MercadoPago for OpenCart — सहायता
आवश्यकताएँ
OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या 4.0.2 और उसके बाद का (4.1.0.3 पर परीक्षण किया गया)।
PHP: 8.0 या उसके बाद का संस्करण।
स्टोर की मुद्रा: आपके MercadoPago खाते के देश की मुद्रा स्टोर में सक्रिय होनी चाहिए: ARS (अर्जेंटीना), BRL (ब्राज़ील), CLP (चिली), COP (कोलंबिया), MXN (मेक्सिको), PEN (पेरू) या UYU (उरुग्वे)। MercadoPago खाते की मुद्रा में शुल्क लेता है और मुद्रा परिवर्तन नहीं करता, इसलिए भुगतान विधि केवल उन ग्राहकों को दिखाई जाती है जो उसी मुद्रा में भुगतान करते हैं।
MercadoPago खाता: आपको MercadoPago डेवलपर पैनल (Your integrations > your application > Credentials) में एक एप्लिकेशन चाहिए, जिसकी परीक्षण क्रेडेंशियल (TEST- से शुरू) और उत्पादन क्रेडेंशियल (APP_USR- से शुरू) हों: हर एक के लिए एक Public Key और एक Access Token। सूचनाओं की वैकल्पिक हस्ताक्षर जाँच के लिए your application > Webhooks से गुप्त हस्ताक्षर भी चाहिए।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक ही डोमेन पर काम करती है।
इंस्टॉलेशन
इस डाउनलोड में दोनों OpenCart संस्करणों के पैकेज एक zip फ़ाइल में हैं। इसे अपने कंप्यूटर पर अनज़िप करें। इसमें README.txt, OpenCart 3 का पैकेज wcp_mercadopago_gateway-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज wcp_mercadopago_gateway.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।
OpenCart 3
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_mercadopago_gateway-oc3-(version).ocmod.zip चुनें। इस एक्सटेंशन में कोई OCMOD बदलाव नहीं है, इसलिए Extensions > Modifications को रीफ़्रेश करने की ज़रूरत नहीं है। इंस्टॉलर के बजाय, इस पैकेज के upload फ़ोल्डर की सामग्री को अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।
2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox MercadoPago Gateway खोजें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन उपयोगकर्ता के पास भुगतान एक्सटेंशन की सूची बदलने का अधिकार होना चाहिए।
3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। पेज के शीर्ष पर लाइसेंस ब्लॉक में License key में अपनी VibeFox लाइसेंस कुंजी चिपकाएँ और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।
4. Account country चुनें, परीक्षण और उत्पादन क्रेडेंशियल दर्ज करें और यदि चाहें तो अपने MercadoPago एप्लिकेशन में सूचनाएँ सेट करें (देखें कॉन्फ़िगरेशन)। जाँच लें कि खाते की मुद्रा System > Localisation > Currencies में सक्रिय है।
5. Enable / Disable चालू करें और Save पर क्लिक करें। MercadoPago परीक्षण कार्डों से टेस्ट मोड में भुगतान की जाँच करें, फिर Test mode बंद करें।
OpenCart 4
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_mercadopago_gateway.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन का कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।
2. इंस्टॉल किया गया पैकेज उसी पेज पर एक्सटेंशनों की सूची में दिखता है। उसके आगे Install (हरा + बटन) पर क्लिक करें।
3. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox MercadoPago Gateway खोजें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर।
4. लाइसेंस कुंजी, क्रेडेंशियल और सूचनाएँ उसी तरह दर्ज करें जैसे OpenCart 3 के चरण 3 से 5 में। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल Notification URL अलग है (देखें भुगतान सूचनाएँ)।
नया इंस्टॉल भुगतान विधि बंद और टेस्ट मोड चालू के साथ शुरू होता है।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox MercadoPago Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सहेजता है। सेटिंग्स के ऊपर, टेस्ट मोड चालू होने पर, पेज Test mode is on: the TEST- credentials are used and no real money is charged. दिखाता है। यह चेतावनी देता है जब वर्तमान मोड का Public Key या Access Token गायब हो (तब चेकआउट में भुगतान विधि छिप जाती है), जब स्टोर की डिफ़ॉल्ट मुद्रा आपके MercadoPago खाते की मुद्रा से अलग हो (तब भुगतान विधि केवल खाते की मुद्रा में भुगतान करने वाले ग्राहकों को दिखती है, या स्टोर में वह मुद्रा सक्रिय न होने पर छिप जाती है), और जब क्रेडेंशियल Account country से अलग देश के खाते के हों। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सहेज नहीं सकता।
यदि आप Title खाली छोड़कर (या 128 अक्षरों से लंबा रखकर) सहेजते हैं, तो कुछ भी सहेजा नहीं जाता और पेज Enter a title for the payment method (1 to 128 characters). दिखाता है। कोई और गलत मान सहेजा नहीं जाता और पिछला मान बना रहता है, साथ में एक त्रुटि आती है जो फ़ील्ड का नाम बताती है और — the previous value was kept. पर समाप्त होती है। यह उन क्रेडेंशियल पर लागू होता है जो अपेक्षित उपसर्ग (परीक्षण फ़ील्ड के लिए TEST-, उत्पादन फ़ील्ड के लिए APP_USR-) से शुरू नहीं होते, 1–24 के बाहर के Maximum installments पर, ऐसे Sort Order पर जो पूर्ण संख्या नहीं है (Sort Order must be a whole number), ऐसे Total पर जो 0 या उससे बड़ी संख्या नहीं है, और ऐसे geo zone या ऑर्डर स्टेटस पर जो मौजूद नहीं है। सहेजने के बाद एक्सटेंशन MercadoPago से पूछता है कि हर एक्सेस टोकन किस देश का है। यदि वर्तमान मोड का टोकन जाँचा नहीं जा सकता, खाता किसी समर्थित देश में नहीं है, या देश Account country से अलग है, तो चेतावनी दिखाई जाती है। तब एक्सटेंशन खाते के देश का उपयोग करता है।
MercadoPago
Enable / Disable: Enable MercadoPago card payments भुगतान विधि को चालू या बंद करता है। यह विधि चेकआउट में तभी दिखती है जब सक्रिय मोड के क्रेडेंशियल भरे हों और ग्राहक MercadoPago खाते की मुद्रा में भुगतान करे। डिफ़ॉल्ट: बंद।
Title: चेकआउट पर ग्राहक को दिखाया जाने वाला भुगतान विधि का नाम। यही नाम ऑर्डर में भी भुगतान विधि के रूप में सहेजा जाता है। डिफ़ॉल्ट: Credit or debit card (MercadoPago)। आवश्यक, 128 अक्षरों तक।
Description: Confirm Order चरण में कार्ड फ़ील्ड के ऊपर दिखाया जाने वाला पाठ। डिफ़ॉल्ट: Pay securely with your credit or debit card. Card data is sent directly to MercadoPago.
Sort Order: चेकआउट पर भुगतान विधियों के बीच MercadoPago की स्थिति। खाली छोड़ें या कोई पूर्ण संख्या लिखें।
Geo Zone: MercadoPago केवल चुने गए geo zone के भुगतान पतों के लिए दें। डिफ़ॉल्ट: All zones। Geo zones System > Localisation > Geo Zones में सेट किए जाते हैं।
Total: चेकआउट का वह कुल योग, स्टोर की डिफ़ॉल्ट मुद्रा में, जिस तक पहुँचने पर ही MercadoPago दिया जाए। किसी भी राशि पर MercadoPago देने के लिए खाली छोड़ें।
MercadoPago खाता
MercadoPago डेवलपर पैनल में अपने एप्लिकेशन की क्रेडेंशियल प्राप्त करें: Your integrations > your application > Credentials (पेज वहाँ का लिंक देता है)। परीक्षण क्रेडेंशियल TEST- से और उत्पादन क्रेडेंशियल APP_USR- से शुरू होते हैं।
Account country: आपके MercadoPago खाते का देश। यह तय करता है कि किस मुद्रा में शुल्क लिया जाएगा, कार्ड फ़ील्ड की भाषा क्या होगी, और कार्डधारक का दस्तावेज़ माँगा जाएगा या नहीं। ग्राहक को उसी मुद्रा में भुगतान करना होगा, जैसे अर्जेंटीना के लिए ARS। क्रेडेंशियल सहेजते समय देश को खाते से मिलाया जाता है। डिफ़ॉल्ट: Argentina (ARS)।
Test mode: टेस्ट मोड में TEST- क्रेडेंशियल उपयोग होते हैं और आप MercadoPago टेस्ट कार्ड से भुगतान करते हैं; चेकआउट पर TEST MODE बैज और Use MercadoPago test cards. No real charges. दिखता है। असली कार्ड से उत्पादन क्रेडेंशियल के साथ शुल्क लेने के लिए इसे बंद करें। रिफ़ंड और सूचनाएँ हमेशा उसी मोड के क्रेडेंशियल उपयोग करते हैं जिसमें भुगतान हुआ था। डिफ़ॉल्ट: चालू।
Test Public Key: TEST- से शुरू होती है। ब्राउज़र में कार्ड को टोकन में बदलने के लिए उपयोग होती है।
Test Access Token: TEST- से शुरू होता है। केवल सर्वर पर उपयोग होता है। गोपनीय रखें।
Production Public Key: APP_USR- से शुरू होती है।
Production Access Token: APP_USR- से शुरू होता है। केवल सर्वर पर उपयोग होता है। गोपनीय रखें।
सहेजे गए एक्सेस टोकन और webhook सीक्रेट फिर कभी नहीं दिखाए जाते। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान लिखें। सहेजा गया मान हटाने के लिए फ़ील्ड के नीचे Clear the saved value on save पर टिक लगाएँ और Save पर क्लिक करें।
भुगतान विकल्प
Maximum installments: ग्राहक अधिकतम कितनी किश्तें (cuotas या parcelas) चुन सकता है, 1 से 24 तक। 1 = केवल एकमुश्त भुगतान। यह सीमा सर्वर पर भी लागू होती है। डिफ़ॉल्ट: 1।
भुगतान सूचनाएँ (webhooks)
कार्ड भुगतान को आमतौर पर तुरंत अंतिम उत्तर मिल जाता है। जिन भुगतानों को MercadoPago समीक्षा में रखता है (प्रक्रिया में या लंबित), वे MercadoPago की सूचनाओं से पूरे होते हैं। जब आपके स्टोर का सार्वजनिक पता हो (localhost या .local या .test डोमेन नहीं), तब एक्सटेंशन हर भुगतान के साथ सूचना URL भेजता है। आप इसे your application > Webhooks में Payments इवेंट के लिए भी जोड़ सकते हैं। यह URL इस सेक्शन में Notification URL में दिखता है। OpenCart 3 पर यह कुछ इस तरह दिखता है: https://your-store/index.php?route=extension/payment/wcp_mercadopago_gateway/webhook&source_news=webhooks, OpenCart 4 पर https://your-store/index.php?route=extension/wcp_mercadopago_gateway/payment/wcp_mercadopago_gateway.webhook&source_news=webhooks जैसा। यह आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। URL को ठीक वैसा ही कॉपी करें जैसा सेटिंग्स दिखाती हैं।
किसी सूचना पर अपने-आप भरोसा नहीं किया जाता। एक्सटेंशन भुगतान को उसी मोड के एक्सेस टोकन से MercadoPago API से दोबारा पढ़ता है जिस मोड में भुगतान हुआ था, और उसे आपके स्टोर के भुगतान प्रयास से जोड़ता है। सूचनाओं के बिना, समीक्षा में रहने वाले ऑर्डर Awaiting MercadoPago Status में रहते हैं, जब तक आप उन्हें हाथ से अपडेट न करें।
एक्सटेंशन ये MercadoPago भुगतान स्टेटस संभालता है:
Webhook secret signature: वैकल्पिक। your application > Webhooks में दिखाया गया गुप्त हस्ताक्षर। सेट होने पर, वैध x-signature के बिना आने वाली सूचनाएँ अस्वीकार होती हैं (HTTP 401)।
ऑर्डर
OpenCart Confirm Order चरण पर ऑर्डर बिना स्टेटस के बनाता है (अधूरा ऑर्डर)। MercadoPago का उत्तर आने के बाद ही उसे स्टेटस मिलता है। अस्वीकृत कार्ड ऑर्डर को बिना स्टेटस के छोड़ देता है (एक नोट कारण समझाता है) और ग्राहक Confirm Order चरण पर रहता है। नीचे का हर फ़ील्ड आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध करता है।
Order Status After Payment: MercadoPago ने भुगतान स्वीकृत किया और उसकी राशि व मुद्रा ऑर्डर से मेल खाती हैं। डिफ़ॉल्ट: प्रक्रिया में।
Awaiting MercadoPago Status: भुगतान MercadoPago में समीक्षा में है (प्रक्रिया में या लंबित); सूचना ऑर्डर पूरा करती है। डिफ़ॉल्ट: लंबित।
On Hold (Review) Status: MercadoPago ने ऑर्डर से अलग राशि या मुद्रा स्वीकृत की, या अनपेक्षित स्टेटस लौटाया। एक नोट बताता है कि MercadoPago पैनल में क्या जाँचना है। डिफ़ॉल्ट: लंबित, क्योंकि OpenCart में On hold स्टेटस नहीं है। प्रतीक्षारत और समीक्षा वाले ऑर्डर अलग करने के लिए आप System > Localisation > Order Statuses में अपने स्टेटस बना सकते हैं।
Payment Failed Status: समीक्षा में रहा भुगतान MercadoPago ने अस्वीकार या रद्द किया। डिफ़ॉल्ट: विफल।
Cancelled Status: इस स्टेटस (या रिफ़ंड स्टेटस) वाला ऑर्डर बंद है: बाद में MercadoPago की स्वीकृति केवल एक नोट जोड़ती है। डिफ़ॉल्ट: रद्द।
Refunded Status: ऑर्डर पेज से भुगतान पूरी तरह रिफ़ंड होने पर यह सेट होता है। आंशिक रिफ़ंड केवल एक नोट जोड़ते हैं। डिफ़ॉल्ट: रिफ़ंड किया गया।
उन्नत
Debug log: MercadoPago अनुरोध और सूचनाएँ OpenCart के लॉग फ़ोल्डर (storage/logs) में wc_mpg_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खोली जा सकती। त्रुटियाँ हमेशा दर्ज होती हैं, यह सेटिंग बंद होने पर भी। एक्सेस टोकन, कार्ड टोकन और भुगतानकर्ता का डेटा दर्ज नहीं होता। डिफ़ॉल्ट: बंद।
Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।
Delete data on uninstall: चालू होने पर एक्सटेंशन हटाने से गेटवे सेटिंग्स और लॉग हट जाते हैं। MercadoPago भुगतान रिकॉर्ड और रिफ़ंड हमेशा बने रहते हैं, ताकि री-इंस्टॉल के बाद भी पहले भुगतान किए गए ऑर्डर का रिफ़ंड हो सके। डिफ़ॉल्ट: बंद।
इंपोर्ट / एक्सपोर्ट
Export: Download JSON सेटिंग्स को JSON फ़ाइल के रूप में सहेजता है। एक्सेस टोकन और webhook सीक्रेट एक्सपोर्ट नहीं होते।
Import: पहले एक्सपोर्ट किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सहेजे गए गुप्त मान बने रहते हैं।
चेकआउट
Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit or debit card (MercadoPago))। OpenCart Confirm Order चरण पर ऑर्डर बनाता है, तब भी बिना स्टेटस के। वहाँ ग्राहक आपका विवरण देखता है और कार्ड फ़ील्ड भरता है: Card number, Expiry (MM/YY), Security code और Cardholder name। देश और कार्ड के अनुसार ग्राहक Document type भी चुनता है और Document number भरता है, Card issuer चुनता है और Installments की संख्या चुनता है। किश्त के विकल्प और ब्याज ऑर्डर कुल के लिए MercadoPago से आते हैं।
OpenCart 4 में ग्राहक Payment method options विंडो में, भुगतान विधि ब्लॉक के Choose बटन से भुगतान विधि चुनता है। इसके बाद कार्ड फ़ील्ड चेकआउट पेज के नीचे, ऑर्डर पुष्टि ब्लॉक में, Confirm Order बटन के ऊपर दिखते हैं।
जब ग्राहक Confirm Order पर क्लिक करता है, MercadoPago कार्ड को एकल-उपयोग टोकन में बदल देता है, और आपका स्टोर ऑर्डर की मुद्रा में ऑर्डर कुल के लिए सर्वर पर भुगतान बनाता है। ग्राहक का ईमेल, नाम और दस्तावेज़ MercadoPago को भेजे जाते हैं; भुगतान MercadoPago में Order #, ऑर्डर नंबर और आपके स्टोर के नाम के रूप में दिखता है। CLP और COP राशियाँ बिना दशमलव के ली जाती हैं।
स्वीकृत भुगतान OpenCart के सामान्य तरीके से ऑर्डर स्टेटस सेट करता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ; कार्ट खाली हो जाता है और ग्राहक OpenCart का ऑर्डर सफलता पेज देखता है। समीक्षा में रहा भुगतान Awaiting MercadoPago Status सेट करता है, और पेज पर MercadoPago is reviewing your payment. Your order will be updated automatically as soon as MercadoPago confirms it. भी दिखता है। समीक्षा स्टेटस वाला ऑर्डर Your payment is being reviewed. We will update your order as soon as the review is complete. दिखाता है।
अस्वीकृत कार्ड ऑर्डर को बिना स्टेटस के छोड़ देता है। ग्राहक Confirm Order चरण पर संक्षिप्त कारण के साथ रहता है, जैसे Your card has insufficient funds. Please use another card or payment method. या Please check the security code of your card. ग्राहक डेटा सुधार सकता है या कोई दूसरा कार्ड उपयोग कर सकता है; हर प्रयास पर नया कार्ड टोकन बनता है। कार्ड डेटा अधूरा हो तो Please fill in all card fields. दिखता है।
यदि MercadoPago उत्तर नहीं देता, तो ग्राहक को We could not confirm your payment with MercadoPago. Please wait a minute before trying again — if the payment went through, your order will be updated automatically. दिखता है। अगला प्रयास पहले भुगतान की स्थिति देखता है, ताकि कार्ड दोबारा न कटे। कार्ट का भुगतान होते समय दूसरा क्लिक This order is already being paid. Please wait a moment and check your e-mail before trying again. दिखाता है। OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर नया ऑर्डर बनाता है, OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और अस्वीकृत कार्ड के बाद ग्राहक उसी ऑर्डर को चुकाता है। दोनों में से किसी भी तरीके में, भुगतान किए गए या प्रतीक्षारत ऑर्डर वाले कार्ट से दोबारा शुल्क नहीं लिया जाता; ग्राहक को सफलता पेज पर भेज दिया जाता है।
OpenCart 4 में ऑर्डर तब तक चेकआउट में रहता है जब तक सफलता पेज नहीं दिखता। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद हो गया हो (उदाहरण के लिए आपने उसे रद्द किया), तो उसका भुगतान नहीं होता, और ग्राहक Your previous order was cancelled without a payment. Please reload the checkout page and confirm the order again — the payment will be made with a new order. देखता है। यदि वह ऑर्डर पहले ही दिया जा चुका है और तब से कार्ट बदल गया है, तो संदेश है Your previous order has already been placed. Your cart has changed since — please reload the checkout page and confirm the order again to pay for the current cart with a new order. कार्ट में कोई भी बदलाव, नई मात्रा सहित, एक नए कार्ट के रूप में गिना जाता है जिसे अपने भुगतान की ज़रूरत है।
स्टोर मेंटेनेंस मोड में भी सूचना URL काम करता है: OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को आने देता है, और OpenCart 4 पर एक्सटेंशन इसके लिए एक startup action जोड़ता है।
एक्सटेंशन केवल क्रेडिट और डेबिट कार्ड स्वीकार करता है। इसमें Checkout Pro रीडायरेक्ट, MercadoPago वॉलेट या खाते की राशि, नकद भुगतान (Rapipago, OXXO, boleto और अन्य), Pix, PSE या Yape, सेव किए गए कार्ड या सदस्यताएँ, अलग प्राधिकरण और कैप्चर, 3-D Secure चुनौती और मुद्रा परिवर्तन नहीं है।
ऑर्डर और रिफ़ंड
ऑर्डर स्टेटस
No status (missing order): कार्ड अस्वीकृत हुआ, या MercadoPago ने अभी उत्तर नहीं दिया। Sales > Orders में ऐसे ऑर्डर केवल तब दिखते हैं जब Order Status फ़िल्टर Missing Orders पर सेट हो।
Order Status After Payment (डिफ़ॉल्ट प्रक्रिया में): MercadoPago ने भुगतान स्वीकृत किया और राशि व मुद्रा ऑर्डर से मेल खाती हैं। एक नोट भुगतान ID, वातावरण और किश्तों की संख्या दिखाता है।
Awaiting MercadoPago Status (डिफ़ॉल्ट लंबित): भुगतान समीक्षा में है (प्रक्रिया में या लंबित) और MercadoPago की सूचना की प्रतीक्षा में है। MercadoPago के स्वीकृत करने पर ऑर्डर Order Status After Payment पर चला जाता है।
On Hold (Review) Status (डिफ़ॉल्ट लंबित): स्वीकृत राशि या मुद्रा ऑर्डर से अलग है, या MercadoPago ने अनपेक्षित स्टेटस लौटाया। नोट इसे समझाता है। ऑर्डर जाँचें और पूरा करें या भुगतान रिफ़ंड करें।
Payment Failed Status (डिफ़ॉल्ट विफल): समीक्षा में रहा भुगतान अस्वीकार या रद्द हुआ। नोट स्टेटस और उसका विवरण दिखाता है।
Refunded Status (डिफ़ॉल्ट रिफ़ंड किया गया): एक्सटेंशन के माध्यम से भुगतान पूरी तरह रिफ़ंड हुआ।
यदि MercadoPago किसी ऐसे ऑर्डर के लिए भुगतान स्वीकृत करता है जो पहले से रद्द या रिफ़ंड हो चुका है, तो स्टेटस नहीं बदलता और एक नोट आपसे ऑर्डर पूरा करने या भुगतान रिफ़ंड करने को कहता है। यदि किसी पहले से भुगतान किए गए ऑर्डर या कार्ट के लिए कोई और भुगतान आता है, तो एक नोट आपसे MercadoPago पैनल में अतिरिक्त भुगतान रिफ़ंड करने को कहता है।
नोट वे प्रविष्टियाँ हैं जो ऑर्डर के History में होती हैं और जिन्हें ग्राहक नहीं देखता।
VibeFox MercadoPago Gateway टैब
Sales > Orders में MercadoPago से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox MercadoPago Gateway टैब Payment ID, भुगतान का Status, Environment (परीक्षण भुगतानों के लिए Test लेबल), Installments, Charged / order राशियाँ, Refunded राशि, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के MercadoPago notes दिखाता है। यह टैब उन उपयोगकर्ताओं को दिखता है जिनके पास एक्सटेंशन की पहुँच है।
रिफ़ंड
VibeFox MercadoPago Gateway टैब में Amount दर्ज करें (जो राशि अभी रिफ़ंड नहीं हुई है वह अपने-आप भर जाती है), वैकल्पिक रूप से Reason (optional), और Refund via MercadoPago पर क्लिक करें। Refund this amount through MercadoPago? This cannot be undone. प्रश्न की पुष्टि करें। पूरा और आंशिक रिफ़ंड समर्थित हैं। आपको एक्सटेंशन बदलने का अधिकार चाहिए (System > Users > User Groups में सेट)। रिफ़ंड उस राशि तक सीमित हैं जो MercadoPago ने वास्तव में काटी थी, इसलिए राशि में अंतर होने पर आप ऑर्डर कुल के बजाय ग्राहक द्वारा वास्तव में चुकाई गई राशि तक ही रिफ़ंड कर सकते हैं। रिफ़ंड उसी वातावरण (परीक्षण या उत्पादन) के क्रेडेंशियल से भेजा जाता है जिसमें भुगतान हुआ था, इसलिए उस वातावरण का एक्सेस टोकन सेट होना चाहिए। यदि MercadoPago रिफ़ंड से इनकार करता है, तो टैब कारण के साथ MercadoPago refused the refund दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। स्वीकृत या प्रक्रिया में चल रहा रिफ़ंड, रिफ़ंड ID के साथ, रिफ़ंड इतिहास और नोट में जुड़ जाता है। पूरा रिफ़ंड ऑर्डर को Refunded Status पर सेट करता है, बिना ग्राहक को सूचित किए और बिना उत्पादों को स्टॉक में वापस लाए, जैसे मैनुअल स्टेटस बदलाव। आंशिक रिफ़ंड स्टेटस नहीं बदलता।
Sales > Returns में उत्पाद वापसी MercadoPago के ज़रिए पैसे वापस नहीं भेजती।
MercadoPago पैनल में किए गए रिफ़ंड, चार्जबैक और मध्यस्थता सूचना के ज़रिए आते हैं और नोट में जुड़ जाते हैं। ऑर्डर स्टेटस अपने-आप नहीं बदलता। ज़रूरत हो तो उसे हाथ से अपडेट करें।
लाइसेंस कुंजी
यह एक्सटेंशन vibefox.net की VibeFox लाइसेंस कुंजी से काम करता है। लाइसेंस ब्लॉक License — VibeFox MercadoPago Gateway, Extensions > Extensions > Payments > VibeFox MercadoPago Gateway > Edit पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को मास्क करके, स्टेटस (जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन) और ये बटन दिखाता है: स्टेटस दोबारा जाँचने के लिए Check now, कोई दूसरी कुंजी डालने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: opencart-payment-mercadopago वाली पंक्ति और Manage licenses and domains in your account लिंक है, जो आपका vibefox.net खाता खोलता है। एक्सटेंशन के लिए Modify अधिकार वाले एडमिन उपयोगकर्ता ही कुंजी बदल सकते हैं। ब्लॉक के पाठ एडमिन की भाषा का पालन करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।
यदि कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, जैसे Key not found, This key belongs to another product, Domain limit reached या किसी तारीख के साथ License expired on। स्टोर का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच न हो, तो एक्सटेंशन अंतिम ज्ञात स्टेटस पर काम करता रहता है।
एक कुंजी एक डोमेन पर काम करती है: OpenCart कॉन्फ़िगरेशन का स्टोर पता। स्टोर से कुंजी हटाने से उसका डोमेन स्लॉट मुक्त नहीं होता। अपने vibefox.net खाते में स्लॉट मुक्त करें।
सक्रिय कुंजी के बिना, चेकआउट पर ग्राहकों को MercadoPago नहीं दिखाया जाता। फिर भी यदि भुगतान शुरू हो जाए, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। उसी ब्राउज़र में एडमिन में लॉग इन एडमिन उपयोगकर्ता को स्टोर में यह भुगतान विधि अब भी दिखती है, जिस पर (unlicensed — visible to admins only) चिह्न होता है, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट करके परख सकें। OpenCart 4 पर यह पूर्वावलोकन उपलब्ध नहीं है: स्टोर एडमिन लॉगिन नहीं देखता, इसलिए बिना सक्रिय कुंजी के भुगतान विधि सभी के लिए छिपी रहती है। Edit पेज एक बार खोलने के बाद एडमिन Dashboard पर एक याद दिलाने वाली सूचना आती है। उसे × से बंद करने पर वह 7 दिनों के लिए छिप जाती है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं वे अब भी पुष्टि होते हैं, और रिफ़ंड काम करते हैं।
लाइसेंस की अवधि समाप्त होने पर एक्सटेंशन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। एडमिन Dashboard या Edit पेज खोलने पर स्टेटस अपने-आप दोबारा जाँचा जाता है: कुंजी डालने के बाद पहले 14 दिनों तक रोज़, फिर हर सप्ताह। कोई cron जॉब ज़रूरी नहीं है। एक्सटेंशन अनइंस्टॉल करने पर लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हट जाते हैं।
समस्या निवारण
चेकआउट पर MercadoPago नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable / Disable चालू है, और वर्तमान मोड में सही उपसर्ग वाले दोनों क्रेडेंशियल हैं: टेस्ट मोड में TEST- की, उत्पादन में APP_USR- की। जाँचें कि ग्राहक MercadoPago खाते की मुद्रा में भुगतान कर रहा है (वह मुद्रा स्टोर में सक्रिय होनी चाहिए), भुगतान पता चुने गए Geo Zone में है, और ऑर्डर सेटिंग्स में दिए Total तक पहुँचता है। सेटिंग्स पेज बताता है कि कौन-सी चीज़ गायब है।
भुगतान हो गया, पर ऑर्डर Awaiting MercadoPago Status में रहता है: सूचना नहीं पहुँची। एक्सटेंशन सूचना URL तभी भेजता है जब आपके स्टोर का सार्वजनिक पता हो (localhost या .local या .test डोमेन नहीं)। Notification URL का URL Payments इवेंट के साथ your application > Webhooks में जोड़ें। यदि Webhook secret signature सेट है, तो जाँचें कि वह उसी एप्लिकेशन का सीक्रेट है। MercadoPago पैनल हर सूचना के लिए आपके स्टोर का उत्तर दिखाता है।
सूचना उत्तर देती है invalid signature: गुप्त हस्ताक्षर किसी दूसरे एप्लिकेशन का है, या सूचना में वैध x-signature नहीं है। सीक्रेट दोबारा कॉपी करें या फ़ील्ड खाली छोड़ें।
सूचना उत्तर देती है no credentials for test या no credentials for live: जिस मोड में भुगतान हुआ था उसका एक्सेस टोकन सेट नहीं है। उसे डालें; MercadoPago सूचना दोबारा भेजेगा।
सूचना उत्तर देती है not for this store: भुगतान इस स्टोर के किसी भुगतान प्रयास का नहीं है। कोई ऑर्डर नहीं बदला जाता।
सूचना उत्तर देती है order busy या payment could not be read: उसी समय कोई दूसरा अनुरोध ऑर्डर अपडेट कर रहा था, या MercadoPago तक पहुँच नहीं हो पाई। MercadoPago सूचना अपने-आप दोबारा भेजता है।
क्रेडेंशियल सहेजे नहीं जाते: त्रुटि must start with बताती है कि मान उस फ़ील्ड के लिए गलत उपसर्ग से शुरू होता है। परीक्षण फ़ील्ड TEST- क्रेडेंशियल लेते हैं, उत्पादन फ़ील्ड APP_USR- क्रेडेंशियल।
ग्राहक को दिखता है «This payment method is not configured correctly. Please choose another payment method or contact the store.»: वर्तमान मोड के क्रेडेंशियल गायब हैं, गलत उपसर्ग के हैं, या MercadoPago ने उन्हें अस्वीकार किया है। सेटिंग्स पेज पर उन्हें जाँचें।
ग्राहक को दिखता है «MercadoPago cannot process payments in»: ऑर्डर की मुद्रा आपके MercadoPago खाते की मुद्रा नहीं है। MercadoPago मुद्राएँ परिवर्तित नहीं करता।
सुरक्षित कार्ड फ़ॉर्म लोड नहीं होता: ग्राहक को The secure card form could not be loaded. Please reload the page or choose another payment method. दिखता है। वर्तमान मोड का Public Key जाँचें।
ग्राहक को दिखता है «Your session has expired. Please reload the page and try again.»: कार्ड फ़ॉर्म अब ग्राहक के चेकआउट सत्र का नहीं रहा। ग्राहक चेकआउट पेज रीलोड करता है।
ग्राहक को दिखता है «Your payment was received, but the order could not be completed automatically»: MercadoPago ने भुगतान ले लिया, पर OpenCart ऑर्डर स्टेटस सेट नहीं कर पाया। एक्सटेंशन पेज पर Log फ़ील्ड देखें: त्रुटियाँ हमेशा दर्ज होती हैं। ग्राहक से दोबारा भुगतान न करने को कहा जाता है; कार्ट के लिए अगला भुगतान प्रयास या सूचना बिना नए शुल्क के स्टेटस सेट करती है।
भुगतान के बाद ऑर्डर समीक्षा स्टेटस में है: ऑर्डर टैब में MercadoPago notes पढ़ें (देखें ऑर्डर स्टेटस), फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।
मोड से जुड़े संदेश के साथ रिफ़ंड विफल होता है: भुगतान परीक्षण या उत्पादन मोड में हुआ था, और उस मोड का एक्सेस टोकन सेट नहीं है। उसे डालें और फिर कोशिश करें।
MercadoPago did not answer the refund request के साथ रिफ़ंड विफल होता है: दोबारा कोशिश करने से पहले MercadoPago पैनल में भुगतान जाँचें।
अनइंस्टॉल
Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox MercadoPago Gateway के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटा दिए जाते हैं। OpenCart एक्सटेंशन की अपनी सेटिंग्स हमेशा हटाता है: Enable / Disable, Sort Order, Geo Zone, Total और Orders सेक्शन के ऑर्डर स्टेटस, जो दोबारा इंस्टॉल करने पर डिफ़ॉल्ट पर लौट आते हैं। एक्सटेंशन का OpenCart इवेंट भी हटा दिया जाता है (OpenCart 4 पर उसका startup action भी, जो मेंटेनेंस मोड में सूचनाओं को आगे जाने देता है)। यदि Delete data on uninstall चालू है, तो बाकी गेटवे सेटिंग्स (शीर्षक, विवरण, खाते का देश, टेस्ट मोड, क्रेडेंशियल, किश्तें, webhook सीक्रेट, लॉगिंग), सहेजी गई खाता जाँच और लॉग हटा दिए जाते हैं। यदि बंद है, तो वे बाद में री-इंस्टॉल के लिए रखे जाते हैं। MercadoPago भुगतान रिकॉर्ड और रिफ़ंड हमेशा बने रहते हैं, ताकि री-इंस्टॉल के बाद भी पहले भुगतान किए गए ऑर्डर का रिफ़ंड हो सके। मौजूदा ऑर्डर अपने भुगतान नोट रखते हैं।
OpenCart 4 पर एक्सटेंशन की फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ और इंस्टॉल किए गए एक्सटेंशनों की सूची में VibeFox MercadoPago Gateway के आगे Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किए गए पैकेज को हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।
MercadoPago अपने-अपने स्वामी का ट्रेडमार्क है। यह एक्सटेंशन MercadoPago से संबद्ध नहीं है और MercadoPago द्वारा समर्थित नहीं है।