VibeFox MercadoPago for WooCommerce — सहायता

आवश्यकताएँ

WordPress: 6.0 या उसके बाद का संस्करण।

WooCommerce: 8.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। WooCommerce के बिना प्लगइन सक्रिय नहीं होता।

PHP: 8.0 या उसके बाद का संस्करण।

स्टोर की मुद्रा: आपके MercadoPago खाते के देश की मुद्रा: ARS (अर्जेंटीना), BRL (ब्राज़ील), CLP (चिली), COP (कोलंबिया), MXN (मेक्सिको), PEN (पेरू) या UYU (उरुग्वे)। MercadoPago खाते की मुद्रा में चार्ज करता है और रूपांतरण नहीं करता, इसलिए मुद्राएँ मेल न खाने पर भुगतान विधि छिप जाती है।

MercadoPago खाता: MercadoPago developer panel में एक एप्लिकेशन (Your integrations > your application > Credentials) होना चाहिए, जिसके टेस्ट क्रेडेंशियल (TEST- से शुरू) और प्रोडक्शन क्रेडेंशियल (APP_USR- से शुरू) हों: हर एक के लिए एक Public Key और एक Access Token। सूचनाओं की वैकल्पिक हस्ताक्षर जाँच के लिए your application > Webhooks से गुप्त हस्ताक्षर भी चाहिए।

VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।

इंस्टॉलेशन

1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से wcp_mercadopago_gateway फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।

2. Activate पर क्लिक करें।

3. सेटिंग्स खोलें: WooCommerce > Settings > Payments > MercadoPago > Manage, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।

4. पेज के ऊपर के लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें।

5. Account country चुनें, टेस्ट और प्रोडक्शन क्रेडेंशियल दर्ज करें और चाहें तो अपने MercadoPago एप्लिकेशन में सूचनाएँ सेट करें (कॉन्फ़िगरेशन देखें)।

6. Enable / Disable चालू करें और सेव करें। MercadoPago टेस्ट कार्ड से जाँचें (कार्डधारक नाम APRO = स्वीकृत, CONT = लंबित, OTHE = अस्वीकृत), फिर Test mode का निशान हटाएँ।

कॉन्फ़िगरेशन

सारी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > MercadoPago। जब तक टेस्ट मोड चालू है, फ़ील्ड के ऊपर पेज Test mode is on: the TEST- credentials are used and no real money is charged. दिखाता है। यह चेतावनी देता है जब मौजूदा मोड के क्रेडेंशियल गायब हों, जब स्टोर की मुद्रा MercadoPago खाते की मुद्रा न हो (तब चेकआउट पर भुगतान विधि छिप जाती है), और जब क्रेडेंशियल Account country से अलग देश के खाते के हों। भुगतान विधियों की सूची में, जब तक मौजूदा मोड के क्रेडेंशियल न हों, MercadoPago को सेटअप की आवश्यकता वाला दिखाया जाता है।

सेव करते समय, जो क्रेडेंशियल अपेक्षित prefix (टेस्ट फ़ील्ड के लिए TEST-, प्रोडक्शन फ़ील्ड के लिए APP_USR-) से शुरू नहीं होता, वह सेव नहीं होता: एक त्रुटि दिखती है और पिछला मान बना रहता है। प्लगइन MercadoPago से यह भी पूछता है कि Access Token किस देश का है। यदि टोकन की जाँच न हो सके, खाता समर्थित देश में न हो, या देश Account country से मेल न खाए, तो त्रुटि दिखती है। तब प्लगइन खाते के देश का उपयोग करता है।

सामान्य

Enable / Disable: Enable MercadoPago card payments भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: बंद।

Title: चेकआउट पर ग्राहक को दिखने वाला भुगतान विधि का नाम। डिफ़ॉल्ट: Credit or debit card (MercadoPago)।

Description: चेकआउट पर कार्ड फ़ील्ड के ऊपर दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely with your credit or debit card. Card data is sent directly to MercadoPago.

MercadoPago खाता

MercadoPago developer panel से अपने एप्लिकेशन के क्रेडेंशियल लें: Your integrations > your application > Credentials। टेस्ट क्रेडेंशियल TEST- से और प्रोडक्शन क्रेडेंशियल APP_USR- से शुरू होते हैं।

Account country: आपके MercadoPago खाते का देश। यह चार्ज की जाने वाली मुद्रा, कार्ड फ़ील्ड की भाषा और कार्डधारक का दस्तावेज़ माँगा जाए या नहीं, तय करता है। स्टोर की मुद्रा वही होनी चाहिए, जैसे अर्जेंटीना के लिए ARS। डिफ़ॉल्ट: Argentina (ARS)।

Argentina (ARS), Brazil (BRL), Chile (CLP), Colombia (COP), Mexico (MXN), Peru (PEN), Uruguay (UYU): समर्थित देश। दस्तावेज़ फ़ील्ड मेक्सिको को छोड़कर सभी में दिखता है।

Test mode: Use the test credentials (no real charges)। टेस्ट मोड में TEST- क्रेडेंशियल उपयोग होते हैं और आप MercadoPago टेस्ट कार्ड से भुगतान करते हैं; चेकआउट पर TEST MODE बैज दिखता है। असली कार्ड से प्रोडक्शन क्रेडेंशियल के साथ चार्ज करने के लिए इसका निशान हटाएँ। डिफ़ॉल्ट: चालू। MercadoPago टेस्ट उपयोगकर्ता खाते (APP_USR- क्रेडेंशियल) से जाँचने के लिए, उस खाते के क्रेडेंशियल प्रोडक्शन फ़ील्ड में डालें और टेस्ट मोड बंद करें।

Test Public Key: TEST- से शुरू होती है। ब्राउज़र में कार्ड को टोकन में बदलने के लिए उपयोग होती है।

Test Access Token: TEST- से शुरू होता है। केवल सर्वर पर उपयोग होता है। इसे गुप्त रखें।

Production Public Key: APP_USR- से शुरू होती है।

Production Access Token: APP_USR- से शुरू होता है। केवल सर्वर पर उपयोग होता है। इसे गुप्त रखें।

भुगतान विकल्प

Maximum installments: ग्राहक जितनी अधिकतम किश्तें चुन सकता है, 1 से 24 तक। 1 = केवल एकमुश्त भुगतान, और किश्त फ़ील्ड नहीं दिखता। यह सीमा सर्वर पर भी लागू होती है। डिफ़ॉल्ट: 1।

भुगतान सूचनाएँ (webhooks)

कार्ड भुगतान आम तौर पर तुरंत अंतिम उत्तर पा लेते हैं। जो भुगतान MercadoPago समीक्षा में रखता है (प्रक्रियाधीन या लंबित), वे MercadoPago की सूचनाओं से पूरे होते हैं। जब आपकी साइट का सार्वजनिक पता हो, तो प्लगइन हर भुगतान के साथ सूचना URL भेजता है। आप इसे your application > Webhooks में भी जोड़ सकते हैं, इवेंट Payments के साथ। URL इस सेटिंग्स सेक्शन में दिखता है और ऐसा दिखता है: https://your-site/wc-api/wc_mpg_webhook/?source_news=webhooks।

सूचना को अपने-आप कभी भरोसेमंद नहीं माना जाता। प्लगइन उस वातावरण के Access Token से, जिसमें भुगतान हुआ था, MercadoPago API से भुगतान दोबारा पढ़ता है और ऑर्डर ID व ऑर्डर key से ऑर्डर से जोड़ता है। सूचनाओं के बिना, समीक्षा वाले ऑर्डर तब तक होल्ड पर रहते हैं जब तक आप उन्हें खुद अपडेट न करें।

प्लगइन MercadoPago की ये भुगतान स्थितियाँ संभालता है:

approved: भुगतान स्वीकृत हुआ। राशि और मुद्रा मेल खाने पर ऑर्डर भुगतान किया हुआ चिह्नित होता है।

in_process, pending, authorized: भुगतान समीक्षा में है। ऑर्डर होल्ड पर होता है और बाद की सूचना से पूरा होता है।

rejected, cancelled: भुगतान अस्वीकृत या रद्द हुआ। बिना भुगतान वाला ऑर्डर विफल चिह्नित होता है।

refunded, charged_back, in_mediation: एक नोट जोड़ा जाता है; ऑर्डर की स्थिति नहीं बदलती।

Webhook secret signature: वैकल्पिक। your application > Webhooks में दिखने वाला गुप्त हस्ताक्षर। सेट होने पर, वैध x-signature न रखने वाली सूचनाएँ अस्वीकार होती हैं (HTTP 401)।

उन्नत

Debug log: Log API requests and notifications WooCommerce > Status > Logs में लिखता है, स्रोत wcp_mercadopago_gateway। Access Token, कार्ड टोकन और भुगतानकर्ता का डेटा लॉग नहीं होते। डिफ़ॉल्ट: बंद।

Delete data on uninstall: Remove the gateway settings and logs when the plugin is deleted। ऑर्डर पर सहेजे गए MercadoPago भुगतान ID भुगतान इतिहास हैं और हमेशा रखे जाते हैं। डिफ़ॉल्ट: बंद।

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit or debit card (MercadoPago)) और कार्ड फ़ील्ड भरता है: Card number, Expiry (MM/YY), Security code और Cardholder name। देश और कार्ड के आधार पर ग्राहक Document type चुनता है और Document number दर्ज करता है, Card issuer चुनता है, और Installments की संख्या चुनता है। किश्त विकल्प और ब्याज ऑर्डर कुल के लिए MercadoPago से आते हैं।

ऑर्डर देने पर MercadoPago कार्ड को एक बार उपयोग होने वाले टोकन में बदलता है, और आपका स्टोर ऑर्डर कुल के लिए सर्वर पर भुगतान बनाता है। बिलिंग ईमेल और नाम, दस्तावेज़ और ऑर्डर नंबर MercadoPago को भेजे जाते हैं। CLP और COP की राशि बिना दशमलव के चार्ज होती है और पूर्ण संख्या में राउंड की जाती है, इसलिए इन मुद्राओं के लिए WooCommerce में दशमलव संख्या 0 सेट करें।

स्वीकृत भुगतान तुरंत भुगतान किया हुआ चिह्नित होता है और ग्राहक ऑर्डर प्राप्ति पेज पर जाता है। समीक्षा में रखा गया भुगतान ऑर्डर को होल्ड पर रखता है; ग्राहक भी ऑर्डर प्राप्ति पेज पर जाता है, और ऑर्डर सूचना से पूरा होता है। अस्वीकृत कार्ड चेकआउट पर एक संक्षिप्त कारण दिखाता है, उदाहरण के लिए Your card has insufficient funds. Please use another card or payment method. या Please check the security code of your card. ग्राहक डेटा सुधार सकता है या दूसरा कार्ड उपयोग कर सकता है; हर प्रयास के लिए नया कार्ड टोकन बनता है।

यदि 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. दिखाता है।

यह भुगतान विधि क्लासिक चेकआउट, Checkout ब्लॉक और Pay for order पेज पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।

प्लगइन केवल क्रेडिट और डेबिट कार्ड लेता है। इसमें Checkout Pro रीडायरेक्ट, MercadoPago वॉलेट या खाता राशि, नकद (Rapipago, OXXO, boleto और अन्य), Pix, PSE या Yape, सेव किए गए कार्ड या सब्सक्रिप्शन, अलग-अलग authorize और capture, 3-D Secure चैलेंज और मुद्रा रूपांतरण नहीं है।

ऑर्डर और रिफ़ंड

ऑर्डर स्थितियाँ

Pending payment: ऑर्डर बन गया है और अभी तक कोई भुगतान परिणाम नहीं आया, उदाहरण के लिए टाइमआउट के बाद।

Processing: MercadoPago ने भुगतान स्वीकृत कर दिया है और राशि व मुद्रा मेल खाते हैं। केवल डाउनलोड होने वाले वर्चुअल उत्पादों वाले ऑर्डर WooCommerce के डिफ़ॉल्ट के अनुसार पूर्ण हो जाते हैं। ऑर्डर नोट में MercadoPago भुगतान ID और किश्तों की संख्या दिखती है। लेन-देन ID MercadoPago भुगतान ID है।

On hold: भुगतान समीक्षा में है (प्रक्रियाधीन या लंबित) और MercadoPago की सूचना की प्रतीक्षा है। जब स्वीकृत राशि या मुद्रा ऑर्डर से मेल न खाए, या MercadoPago कोई अप्रत्याशित स्थिति लौटाए, तब भी होल्ड पर सेट होता है। ऑर्डर नोट कारण बताता है।

Failed: भुगतान अस्वीकृत या रद्द हुआ। ऑर्डर नोट स्थिति और उसका विवरण दिखाता है। ग्राहक फिर से भुगतान कर सकता है।

यदि MercadoPago रद्द या रिफ़ंड किए गए ऑर्डर के लिए भुगतान स्वीकृत करता है, तो स्थिति नहीं बदलती और एक नोट आपसे ऑर्डर पूरा करने या भुगतान रिफ़ंड करने को कहता है। यदि पहले से भुगतान किए गए ऑर्डर के लिए कोई और भुगतान आता है, तो एक नोट आपसे MercadoPago panel में अतिरिक्त भुगतान रिफ़ंड करने को कहता है।

रिफ़ंड

ऑर्डर खोलें, Refund पर क्लिक करें, राशि दर्ज करें और Refund via Credit or debit card (MercadoPago) पर क्लिक करें (बटन पर आपका Title दिखता है)। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। रिफ़ंड उसी वातावरण (टेस्ट या प्रोडक्शन) के क्रेडेंशियल से भेजा जाता है जिसमें भुगतान हुआ था, इसलिए उस वातावरण का Access Token सेट होना चाहिए। यदि MercadoPago रिफ़ंड अस्वीकार करता है, तो WooCommerce कारण के साथ MercadoPago refused the refund दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। स्वीकृत या प्रक्रिया में चल रहा रिफ़ंड रिफ़ंड ID के साथ ऑर्डर नोट में जुड़ जाता है।

MercadoPago panel में किए गए रिफ़ंड और चार्जबैक सूचना के जरिए आते हैं और ऑर्डर नोट में जोड़े जाते हैं। वे अपने-आप WooCommerce रिफ़ंड के रूप में दर्ज नहीं होते।

लाइसेंस कुंजी

यह प्लगइन vibefox.net की VibeFox लाइसेंस कुंजी से काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Payments > MercadoPago के ऊपर होता है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, उदाहरण के लिए लाइसेंस कब तक सक्रिय है वह तारीख और आपका डोमेन। Check now से स्थिति दोबारा जाँचें, Change key से दूसरी कुंजी दर्ज करें, और Remove key से इस साइट से कुंजी हटाएँ। लिंक Manage licenses and domains in your account आपका vibefox.net खाता खोलता है।

एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने पर उसकी डोमेन स्लॉट मुक्त नहीं होती। स्लॉट अपने vibefox.net खाते में मुक्त करें।

सक्रिय कुंजी के बिना MercadoPago ग्राहकों को चेकआउट पर नहीं दिखाया जाता। यदि फिर भी भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। लॉग इन स्टोर प्रबंधकों को भुगतान विधि अब भी (unlicensed — visible to admins only) चिह्न के साथ दिखती है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट और टेस्ट कर सकें। प्लगइन्स पेज और WooCommerce पेजों पर एक याद दिलाने वाला संदेश दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: पहले से शुरू किए गए भुगतान अब भी पुष्ट होते हैं और रिफ़ंड काम करते हैं।

जब लाइसेंस की समय-सीमा समाप्त होती है, तो प्लगइन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। स्थिति अपने-आप पृष्ठभूमि में दोबारा जाँची जाती है।

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

MercadoPago does not appear at checkout: जाँचें कि लाइसेंस सक्रिय है, Enable / Disable चालू है, और मौजूदा मोड में सही prefix वाले दोनों क्रेडेंशियल हैं: टेस्ट मोड में TEST- कुंजियाँ, प्रोडक्शन में APP_USR- कुंजियाँ। जाँचें कि स्टोर की मुद्रा (या Pay for order पेज पर ऑर्डर की मुद्रा) MercadoPago खाते की मुद्रा है। सेटिंग्स पेज बताता है कि कौन सी चीज़ गायब है।

भुगतान हो गया, लेकिन ऑर्डर होल्ड पर या भुगतान लंबित पर अटका है: सूचना नहीं पहुँची। प्लगइन सूचना URL केवल तब भेजता है जब आपकी साइट का सार्वजनिक पता हो (localhost या .local या .test डोमेन नहीं)। सेटिंग्स का URL your application > Webhooks में इवेंट Payments के साथ जोड़ें। यदि Webhook secret signature सेट है, तो जाँचें कि वह उसी एप्लिकेशन का गुप्त हस्ताक्षर है। MercadoPago panel हर सूचना पर आपके स्टोर का जवाब दिखाता है।

Notification answers invalid signature: गुप्त हस्ताक्षर किसी दूसरे एप्लिकेशन का है, या सूचना में वैध x-signature नहीं है। गुप्त हस्ताक्षर दोबारा कॉपी करें या फ़ील्ड खाली छोड़ें।

Notification answers not for this store: भुगतान इस स्टोर के ऐसे ऑर्डर का नहीं है जो MercadoPago से चुकाया गया हो। ऑर्डर नहीं बदला जाता।

A credential is not saved: त्रुटि must start with बताती है कि मान का prefix उस फ़ील्ड के लिए गलत है। टेस्ट फ़ील्ड TEST- क्रेडेंशियल लेते हैं, प्रोडक्शन फ़ील्ड APP_USR- क्रेडेंशियल।

The customer sees This payment method is not configured correctly. Please choose another payment method or contact the store.: मौजूदा मोड के क्रेडेंशियल गायब हैं, उनका prefix गलत है, या MercadoPago ने उन्हें अस्वीकार किया। सेटिंग्स पेज पर उन्हें जाँचें।

The customer sees MercadoPago cannot process payments in: ऑर्डर की मुद्रा आपके MercadoPago खाते की मुद्रा नहीं है। MercadoPago मुद्राएँ रूपांतरित नहीं करता।

The secure card form does not load: ग्राहक को The secure card form could not be loaded. Please reload the page or choose another payment method. दिखता है। मौजूदा मोड का Public Key जाँचें। अधिक जानकारी के लिए Debug log चालू करें और WooCommerce > Status > Logs में स्रोत wcp_mercadopago_gateway देखें।

Refund fails with a message about the mode: भुगतान टेस्ट या प्रोडक्शन मोड में हुआ था, और उस मोड का Access Token सेट नहीं है। उसे दर्ज करें और फिर कोशिश करें।

Refund fails with MercadoPago did not answer the refund request: दोबारा कोशिश करने से पहले MercadoPago panel में भुगतान जाँचें।

The license block shows an error: लाइसेंस ब्लॉक का संदेश फ़ॉलो करें। उदाहरण के लिए, यदि कुंजी पहले से किसी दूसरे डोमेन पर उपयोग में है, तो अपने vibefox.net खाते में एक स्लॉट मुक्त करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं है, तो प्लगइन अंतिम ज्ञात स्थिति पर काम करता रहता है।

अनइंस्टॉल

प्लगइन को निष्क्रिय करने पर सारा डेटा रहता है। हटाने के लिए, इसे निष्क्रिय करें और Plugins पेज पर डिलीट करें। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटाई जाती है। गेटवे सेटिंग्स, सहेजी गई खाता जाँच और लॉग केवल तब हटते हैं जब Delete data on uninstall चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए रहते हैं। मौजूदा ऑर्डर अपने भुगतान नोट, MercadoPago भुगतान ID और लेन-देन ID रखते हैं।

MercadoPago उसके संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन MercadoPago से संबद्ध नहीं है और MercadoPago द्वारा समर्थित नहीं है।