Mercado Pago Terminal गेटवे

Mercado Pago Terminal गेटवे आपको WCPOS से Mercado Pago Point Smart टर्मिनलों पर आमने-सामने भुगतान स्वीकार करने देता है। भुगतान WooCommerce से शुरू होता है और टर्मिनल पर पूरा किया जाता है; Mercado Pago की पुष्टि ऑर्डर में दर्ज हो जाती है।

0.1.0 में नया

Mercado Pago Terminal for WooCommerce एक नया एक्सटेंशन है और 0.1.0 इसकी पहली रिलीज़ है। इसे बीटा मानें: असली भुगतान लेने से पहले Mercado Pago के सैंडबॉक्स वर्चुअल टर्मिनल के साथ Test मोड शुरू करें और एक परीक्षण भुगतान करें।

सुविधाएँ

Point Smart हार्डवेयर

Mercado Pago Point Smart 1 और 2 टर्मिनलों पर आमने-सामने भुगतान स्वीकार करें

लाइव टर्मिनल सूची

टर्मिनलों की जानकारी आपके खाते से लाइव प्राप्त की जाती है; सेटिंग्स में एक क्लिक से Switch to PDV कार्रवाई उपलब्ध है

विश्वसनीय पूर्णता

हर 2 सेकंड में पोलिंग, Mercado Pago webhook और 5-मिनट की बैकग्राउंड जाँच भुगतान की पुष्टि करते हैं, भले ही ब्राउज़र बंद हो गया हो

WooCommerce से रिफंड

WooCommerce ऑर्डर स्क्रीन से पूरे या आंशिक रिफंड भेजें

अंतर्निहित डायग्नोस्टिक्स

सेटिंग्स में कनेक्शन और webhook स्थिति जाँचें और समस्या निवारण के लिए सपोर्ट बंडल डाउनलोड करें

यह कैसे काम करता है

यह गेटवे Mercado Pago के क्लाउड Orders API for Point का उपयोग करता है। भुगतान शुरू करने पर पूरे WooCommerce ऑर्डर कुल राशि का Mercado Pago ऑर्डर बनता है और चुने गए टर्मिनल पर भेजा जाता है। Mercado Pago ऑर्डर 5 मिनट बाद समाप्त हो जाता है।

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

टर्मिनल PDV (एकीकृत) मोड में होना चाहिए। टर्मिनल STANDALONE मोड में आते हैं, इसलिए भुगतान लेने से पहले गेटवे सेटिंग्स में PDV पर स्विच करें और टर्मिनल पुनः आरंभ करें।

सेटअप

1

Mercado Pago Terminal for WooCommerce इंस्टॉल करें

GitHub रिलीज़ पेज से plugin zip asset डाउनलोड करें (GitHub स्रोत-कोड zip नहीं)। इसे Plugins > Add New > Upload Plugin के ज़रिए अपलोड करें और WooCommerce इंस्टॉल व सक्रिय होने पर सक्रिय करें।

2

अपने Mercado Pago क्रेडेंशियल जोड़ें

1. WP Admin > WooCommerce > Settings > Payments पर जाएँ और Mercado Pago Terminal खोलें
2. Mode चुनें: Test सैंडबॉक्स वर्चुअल टर्मिनल चलाता है; Live असली टर्मिनल चलाता है
3. अपने एप्लिकेशन का Access token (APP_USR-…) Mercado Pago → Your integrations → Credentials से कॉपी करके पेस्ट करें

Live मोड में अपना टोकन जाँचें

Live मोड में TEST- टोकन भुगतान को सैंडबॉक्स में भेजता है। सेटिंग्स स्क्रीन इस संयोजन के बारे में चेतावनी देती है; असली भुगतान लेने से पहले अपना प्रोडक्शन टोकन पेस्ट करें।

3

webhook रजिस्टर करें

1. Mercado Pago में Your integrations → अपना एप्लिकेशन → Webhooks पर जाएँ
2. गेटवे सेटिंग्स स्क्रीन पर दिखाया गया webhook URL जोड़ें
3. Order (Mercado Pago) इवेंट चुनें और सहेजें
4. secret signature कॉपी करके WooCommerce में Webhook secret में डालें

Webhook वैकल्पिक है। इसके बिना पोलिंग से भुगतान पूरे होते हैं, लेकिन secret कॉन्फ़िगर करने से प्लगइन webhook हस्ताक्षर सत्यापित कर सकता है।

4

अपने टर्मिनल सेट अप करें

1. सेटिंग्स स्क्रीन सहेजें और फिर से लोड करें। Default terminal ड्रॉपडाउन और Terminals तालिका आपके खाते के टर्मिनल दिखाते हैं
2. STANDALONE मोड में दिखाए गए टर्मिनल के लिए Switch to PDV पर क्लिक करें, फिर टर्मिनल पुनः आरंभ करें
3. Default terminal चुनें
4. (वैकल्पिक) Enabled terminals को उन डिवाइस तक सीमित करें जिन्हें कैशियर चुन सकते हैं। सभी टर्मिनल उपलब्ध रखने के लिए इसे खाली छोड़ें; सहेजा गया डिफ़ॉल्ट यहाँ चुना न होने पर भी उपलब्ध रहता है
5. (वैकल्पिक) हमेशा डिफ़ॉल्ट टर्मिनल इस्तेमाल करने और कैशियर को इसे बदलने से रोकने के लिए Lock terminal selection सक्षम करें। इसके लिए डिफ़ॉल्ट टर्मिनल आवश्यक है
6. अपनी सेटिंग्स सहेजें

5

WCPOS में सक्षम करें

1. WP Admin > POS > Settings > Checkout पर जाएँ
2. Mercado Pago Terminal गेटवे ढूँढ़ें और इसे POS के लिए सक्षम करें
3. अपनी सेटिंग्स सहेजें

नोट

WooCommerce सेटिंग्स स्क्रीन पर मौजूद Enable/Disable चेकबॉक्स केवल ऑनलाइन स्टोर चेकआउट नियंत्रित करता है। कॉन्फ़िगर होने के बाद WCPOS इस गेटवे का उपयोग करता है, चाहे वह बॉक्स चुना हो या नहीं।

सेटिंग्स संदर्भ

सेटिंग	इसका काम
Enable/Disable	ऑनलाइन स्टोर चेकआउट के लिए गेटवे सक्षम करता है। POS सक्षम करना POS > Settings > Checkout में नियंत्रित होता है
Title	चेकआउट लेबल; डिफ़ॉल्ट Mercado Pago Terminal है
Description	चेकआउट विवरण; डिफ़ॉल्ट Pay in person on a Mercado Pago Point terminal. है
Mode	Test (डिफ़ॉल्ट) सैंडबॉक्स वर्चुअल टर्मिनल का उपयोग करता है; Live लाइव क्रेडेंशियल के साथ असली टर्मिनल का उपयोग करता है
Access token	Mercado Pago → Your integrations → Credentials से आपके एप्लिकेशन का टोकन। सहेजा गया टोकन दोबारा नहीं दिखाया जाता; इसे बनाए रखने के लिए खाली छोड़ें
Webhook secret	Mercado Pago की webhook सेटिंग्स से secret signature, जिसका उपयोग सूचनाएँ सत्यापित करने के लिए होता है
Default terminal	चेकआउट में डिफ़ॉल्ट रूप से इस्तेमाल होने वाला टर्मिनल, जो आपके खाते से लाइव प्राप्त किया जाता है। सूची प्राप्त न हो पाने पर टेक्स्ट फ़ील्ड दिखाई देता है
Enabled terminals	कैशियर जिन टर्मिनलों को चुन सकते हैं उन्हें सीमित करता है। खाली होने पर सभी टर्मिनल उपलब्ध होते हैं; डिफ़ॉल्ट हमेशा उपलब्ध रहता है। सूची लोड न होने पर छिपा रहता है
Lock terminal selection	हमेशा डिफ़ॉल्ट टर्मिनल का उपयोग करता है ताकि कैशियर इसे बदल न सकें। इसके लिए डिफ़ॉल्ट टर्मिनल आवश्यक है
Checkout debug logs	भुगतान पैनल में Show logs, Copy और Clear दिखाता है। डिफ़ॉल्ट रूप से बंद है; सपोर्ट के लिए लॉग जुटाते समय सक्षम करें
Log level	Off, Errors only या Debug। इस रिलीज़ में डिफ़ॉल्ट Debug है; अनुरोध और प्रतिक्रियाएँ रिकॉर्ड होती हैं और secrets हटा दिए जाते हैं

फ़ील्ड के नीचे, Mercado Pago Terminal diagnostics तालिका API जाँच (टर्मिनल और PDV संख्या सहित), अंतिम सत्यापित webhook, सक्रिय परिवेश, क्रेडेंशियल कॉन्फ़िगर हैं या नहीं, डिफ़ॉल्ट टर्मिनल, webhook URL और भुगतान लॉग लिंक दिखाती है।

उपयोग

भुगतान संसाधित करना

1. Add Items: POS में अपने कार्ट में उत्पाद जोड़ें
2. Select Gateway: भुगतान विधि के रूप में Mercado Pago Terminal चुनें
3. Choose Terminal: कोई टर्मिनल चुनें, या चयन लॉक होने पर डिफ़ॉल्ट का उपयोग करें
4. Start Payment: ऑर्डर की कुल राशि टर्मिनल पर भेजने के लिए Start Terminal Payment पर क्लिक करें
5. Customer Payment: ग्राहक द्वारा टर्मिनल पर भुगतान पूरा करते समय स्थिति संदेशों का अनुसरण करें — Sending to terminal… → Waiting for terminal… → Customer is paying on the terminal…
6. Automatic Completion: Mercado Pago द्वारा भुगतान की पुष्टि होने पर ऑर्डर पूरा हो जाता है और POS रसीद पर चला जाता है

भुगतान नियंत्रण

• Start Terminal Payment: चुने गए टर्मिनल को नया भुगतान अनुरोध भेजें
• Cancel Terminal Payment: भुगतान टर्मिनल द्वारा स्वीकार किए जाने से पहले ही रद्द करें। उसके बाद, टर्मिनल पर रद्द करें या 5 मिनट की समाप्ति तक प्रतीक्षा करें
• पेज फिर से लोड करना: पहले से जारी भुगतान फिर शुरू करता है

रसीदें

टर्मिनल कोई टिकट प्रिंट नहीं करता। भुगतान पूरा होने के बाद POS रसीद का उपयोग करें।

रिफंड

WooCommerce ऑर्डर रिफंड स्क्रीन खोलें और पूरा या आंशिक रिफंड भेजने के लिए Refund via Mercado Pago Terminal चुनें। Mercado Pago भुगतान के 90 दिनों तक रिफंड की अनुमति देता है।

कुछ कार्ड अधिग्रहणकर्ता केवल टर्मिनल पर रिफंड की अनुमति देते हैं। ऐसी स्थिति में टर्मिनल पर रिफंड करें और WooCommerce में manual refund दर्ज करें।

लॉग और सपोर्ट बंडल

WooCommerce > Status > Logs में mercadopago-terminal स्रोत के अंतर्गत लॉग देखें। इस रिलीज़ में लॉग स्तर डिफ़ॉल्ट रूप से Debug है। अनुरोध, प्रतिक्रियाएँ, webhooks और भुगतान स्थिति में बदलाव रिकॉर्ड किए जाते हैं; secrets और कार्ड नंबर हटा दिए जाते हैं।

गेटवे सेटिंग्स स्क्रीन पर Download support bundle पर क्लिक करके .txt फ़ाइल डाउनलोड करें और उसे अपने सपोर्ट अनुरोध के साथ संलग्न करें। इसमें परिवेश का विवरण, मास्क किए गए क्रेडेंशियल वाली सेटिंग्स, टर्मिनल सूची और संचालन मोड, 10 सबसे हाल के ऑर्डर के भुगतान प्रयास और लॉग की पिछली 500 पंक्तियाँ होती हैं; इसमें मौजूद किसी भी चीज़ से भुगतान नहीं किया जा सकता।

भुगतान पैनल में Show logs, Copy और Clear जोड़ने के लिए Checkout debug logs सक्षम करें। इस सेटिंग की परवाह किए बिना भुगतान गतिविधि WooCommerce लॉग में रिकॉर्ड होती है।

आवश्यकताएँ

Mercado Pago खाता: अर्जेंटीना, ब्राज़ील, मेक्सिको, उरुग्वे, कोलंबिया, चिली या पेरू में विक्रेता खाता, जिसमें एप्लिकेशन एक्सेस टोकन हो

संगत हार्डवेयर: PDV मोड में Mercado Pago Point Smart 1 या 2

WCPOS: POS चेकआउट के लिए Pro संस्करण आवश्यक है

सर्वर: WordPress 5.2+, WooCommerce और PHP 7.4+

स्थिर कनेक्शन: API संचार के लिए विश्वसनीय इंटरनेट कनेक्शन

दायरा और सीमाएँ

• टर्मिनल से ऑर्डर की पूरी राशि ली जाती है। टर्मिनल पर ऑर्डर का केवल कुछ हिस्सा चुकाने की सुविधा समर्थित नहीं है
• टिप समर्थित नहीं हैं
• राशियाँ दो दशमलव के साथ भेजी जाती हैं। चिली या कोलंबियाई पेसो में बिक्री करने वाले स्टोर को पहले परीक्षण भुगतान करके इसकी पुष्टि करनी चाहिए
• ऑनलाइन स्टोर का Blocks checkout समर्थित नहीं है
• प्लगइन अभी HPOS compatibility घोषित नहीं करता

समस्या निवारण

आम समस्याएँ

Mercado Pago ने एक्सेस टोकन अस्वीकार किया (HTTP 401)

• एक्सेस टोकन अमान्य या पुराना है
• Your integrations → Credentials से नया टोकन कॉपी करें और उसे Access token में सहेजें

कोई टर्मिनल सूचीबद्ध नहीं है

• यदि खाते से कोई Point टर्मिनल लिंक नहीं है, तो टर्मिनल पर उस Mercado Pago खाते से लॉग इन करें, PDV पर स्विच करें और इसे पुनः आरंभ करें
• यदि Default terminal ड्रॉपडाउन के बजाय टेक्स्ट बॉक्स है, तो सूची प्राप्त नहीं हो सकी। टोकन और डायग्नोस्टिक्स जाँचें, फिर सेटिंग्स स्क्रीन दोबारा लोड करें

टर्मिनल STANDALONE मोड में है

• एकीकृत भुगतान के लिए PDV मोड आवश्यक है
• सेटिंग्स स्क्रीन की Terminals तालिका में Switch to PDV पर क्लिक करें, फिर टर्मिनल पुनः आरंभ करें

भुगतान पहले से टर्मिनल पर है

• टर्मिनल ने भुगतान स्वीकार कर लिया है, इसलिए अब इसे WooCommerce से रद्द नहीं किया जा सकता
• टर्मिनल पर रद्द करें या 5 मिनट की समाप्ति तक प्रतीक्षा करें। भुगतान पेज इसकी स्थिति जाँचता रहता है

webhook कभी सत्यापित नहीं किया गया

• यदि डायग्नोस्टिक्स में Last verified webhook: never दिखता है, तो Mercado Pago में webhook URL और secret जाँचें
• यदि Webhook secret मौजूद नहीं है, तो Mercado Pago से secret signature पेस्ट करें। भुगतान पोलिंग से पूरे होते रहते हैं, लेकिन secret के बिना सूचनाओं के हस्ताक्षर सत्यापित नहीं होते

कार्ड अधिग्रहणकर्ता ने रिफंड अस्वीकार किया

• कुछ अधिग्रहणकर्ता केवल टर्मिनल पर रिफंड की अनुमति देते हैं; Mercado Pago रिफंड को 90 दिनों तक भी सीमित करता है
• टर्मिनल पर रिफंड करें और WooCommerce में manual refund दर्ज करें

टर्मिनल पर भुगतान की समय-सीमा समाप्त हो गई

• Mercado Pago ऑर्डर 5 मिनट बाद समाप्त हो जाते हैं
• भुगतान फिर से शुरू करें

सहायता प्राप्त करें

• गेटवे सेटिंग्स स्क्रीन से support bundle संलग्न करके अपना सपोर्ट अनुरोध भेजें
• समस्याओं की रिपोर्ट करने के लिए GitHub repository पर जाएँ
• खाते और हार्डवेयर से जुड़े प्रश्नों के लिए Mercado Pago सपोर्ट से संपर्क करें