VibeFox MakeCommerce for WooCommerce — सहायता

आवश्यकताएँ

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

WooCommerce: 7.0 या उसके बाद का संस्करण, स्थापित और सक्रिय। WooCommerce के बिना प्लगइन सक्रिय होने से मना कर देता है।

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

आपकी साइट तक इंटरनेट पहुँच: MakeCommerce आपके स्टोर को भुगतान सूचनाएँ भेजता है, इसलिए साइट का इंटरनेट से सुलभ होना आवश्यक है (HTTPS अनुशंसित)। फ़ायरवॉल, रखरखाव मोड या बुनियादी प्रमाणीकरण (basic authentication) उन्हें रोक सकते हैं।

MakeCommerce खाता: आपको MakeCommerce Merchant Portal (Settings > API) से Shop ID और Secret key की आवश्यकता होती है। परीक्षण और लाइव वातावरण के अलग-अलग खाते और कुंजियाँ होती हैं। कौन से भुगतान तरीके और मुद्राएँ उपलब्ध हैं, यह आपके MakeCommerce अनुबंध द्वारा परिभाषित किया जाता है (बैंक लिंक EUR में होते हैं)। तीन दशमलव वाली मुद्राएँ, जैसे कि KWD या BHD, उपलब्ध नहीं कराई जाती हैं।

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

स्थापना

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

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

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

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

5. परीक्षण वातावरण की Shop ID और Secret key दर्ज करें और वास्तविक भुगतानों के लिए लाइव कुंजियाँ दर्ज करें (कॉन्फ़िगरेशन देखें)। Merchant Portal में कुछ भी कॉन्फ़िगर करने की आवश्यकता नहीं है।

6. Enable/Disable चालू करें। Test mode चालू रखकर एक भुगतान का परीक्षण करें, फिर वास्तविक भुगतान स्वीकार करने के लिए इसे अनचेक करें।

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

सभी सेटिंग्स एक ही पृष्ठ पर हैं: WooCommerce > Settings > Payments > MakeCommerce। परीक्षण मोड चालू रहने के दौरान पृष्ठ फ़ील्ड के ऊपर Test mode is on: payments are created in the MakeCommerce test environment and no real money is charged. दिखाता है। यदि विधि सक्षम है लेकिन वर्तमान वातावरण की Shop ID या Secret key खाली है, और जब स्टोर मुद्रा को MakeCommerce द्वारा चार्ज नहीं किया जा सकता है, तो यह आपको चेतावनी देता है। दोनों ही मामलों में चेकआउट पर यह विधि छिप जाती है। भुगतान विधियों की सूची में, MakeCommerce को तब तक सेटअप की आवश्यकता के रूप में चिह्नित किया जाता है जब तक कि वर्तमान वातावरण में उसकी कुंजियाँ न हों। सहेजते समय कुंजियों से रिक्त स्थान हटा दिए जाते हैं।

General

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

Title: वह भुगतान विधि नाम जो ग्राहक चेकआउट पर देखते हैं। डिफ़ॉल्ट: Bank link or card (MakeCommerce)।

Description: चेकआउट पर भुगतान विधि के नीचे दिखाया जाने वाला पाठ। डिफ़ॉल्ट: Pay with your Estonian, Latvian, Lithuanian or Finnish bank, or by card. You will be redirected to the secure MakeCommerce payment page.

MakeCommerce account

Shop ID और Secret key, MakeCommerce Merchant Portal में Settings > API के अंतर्गत हैं। परीक्षण पोर्टल और लाइव पोर्टल के अलग-अलग खाते और कुंजियाँ हैं। इस अनुभाग में दोनों पोर्टलों और MakeCommerce साइन-अप पृष्ठ के लिंक हैं।

Test mode: Use the MakeCommerce test environment (no real money is charged)। नए भुगतान चयनित वातावरण में उसकी कुंजियों के साथ बनाए जाते हैं। प्रत्येक ऑर्डर उस वातावरण को याद रखता है जिसमें उसका भुगतान किया गया था: स्थिति की जाँच और रिफ़ंड हमेशा वहीं जाते हैं। चेकआउट पर TEST MODE — MakeCommerce test environment, no real money is charged. पंक्ति दिखाई जाती है। डिफ़ॉल्ट: चालू।

Test Shop ID: आपके परीक्षण खाते की Shop ID, xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx प्रारूप में।

Test Secret key: आपके परीक्षण खाते की Secret key।

Live Shop ID: आपके लाइव खाते की Shop ID।

Live Secret key: आपके लाइव खाते की Secret key।

Payment notifications

Merchant Portal में कुछ भी कॉन्फ़िगर करने की आवश्यकता नहीं है। प्रत्येक लेन-देन इस अनुभाग में दिखाए गए पते (यह https://your-site/wc-api/wc_mkc_payment/ जैसा दिखता है) पर आधारित अपने स्वयं के वापसी, रद्दीकरण और अधिसूचना URL ले जाता है, जिसमें ऑर्डर संख्या और ऑर्डर कुंजी जोड़ी जाती है। MakeCommerce अधिसूचना URL पर (सर्वर से सर्वर) और ग्राहक के ब्राउज़र के साथ वापसी या रद्दीकरण URL पर एक हस्ताक्षरित संदेश भेजता है। हस्ताक्षर की जाँच उस वातावरण की Secret key से की जाती है जिसमें लेन-देन बनाया गया था। बिना वैध हस्ताक्षर वाले संदेशों को अस्वीकार कर दिया जाता है।

प्लगइन इन MakeCommerce लेन-देन स्थितियों को संभालता है:

ग्राहक के स्टोर पर लौटने पर भी भुगतान की पुष्टि हो जाती है। यदि ग्राहक बिना किसी हस्ताक्षरित संदेश के वापस आता है, तो प्लगइन MakeCommerce API से स्थिति पूछता है।

Advanced

Debug log: Log API calls and payment notifications विवरण को WooCommerce > Status > Logs, स्रोत wcp_makecommerce_payment में लिखता है। त्रुटियाँ हमेशा लॉग की जाती हैं। कुंजियाँ और ग्राहक डेटा कभी भी लॉग नहीं किए जाते हैं। डिफ़ॉल्ट: बंद।

Delete data: Delete the gateway settings and logs when the plugin is deleted। ऑर्डर और उनके भुगतान नोट हमेशा रखे जाते हैं। प्लगइन को निष्क्रिय करने से कभी कुछ नहीं हटता। डिफ़ॉल्ट: बंद।

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Bank link or card (MakeCommerce)) और ऑर्डर देता है। प्लगइन ऑर्डर मुद्रा में ऑर्डर कुल के लिए एक MakeCommerce लेन-देन बनाता है और ग्राहक को MakeCommerce भुगतान पृष्ठ पर भेजता है। वहाँ ग्राहक बैंक लिंक या कार्ड चुनता है। बिलिंग ईमेल और देश MakeCommerce को दिए जाते हैं, और यदि MakeCommerce इसका समर्थन करता है तो पृष्ठ स्टोर की भाषा (एस्टोनियाई, अंग्रेज़ी, लातवियाई, लिथुआनियाई, फ़िनिश, रूसी, जर्मन, पोलिश) में खुलता है, अन्यथा अंग्रेज़ी में।

भुगतान करने के बाद, ग्राहक आपके स्टोर के ऑर्डर प्राप्त पृष्ठ पर लौटता है। MakeCommerce द्वारा इसकी पुष्टि करने के बाद ही ऑर्डर को भुगतान किया हुआ चिह्नित किया जाता है: हस्ताक्षरित अधिसूचना द्वारा या ग्राहक की हस्ताक्षरित वापसी द्वारा, MakeCommerce API के माध्यम से लेन-देन की जाँच के साथ।

यदि ग्राहक MakeCommerce पृष्ठ पर रद्द करता है या भुगतान समाप्त हो जाता है, तो ग्राहक चेकआउट (या Pay for order पृष्ठ) पर एक संदेश के साथ वापस आता है, उदाहरण के लिए The payment was cancelled. You can try again or choose another payment method. या The payment session expired. Please try again. यदि भुगतान की अभी पुष्टि नहीं की जा सकती है, तो संदेश होता है We could not confirm your payment yet. If you completed it, your order will be updated automatically; otherwise please try again. ग्राहक फिर से भुगतान कर सकता है। उसी ऑर्डर का पुराना भुगतान लिंक अभी भी काम करता है, और ऑर्डर का दो बार भुगतान नहीं किया जा सकता है।

यदि MakeCommerce भुगतान शुरू नहीं कर सकता है, तो ग्राहक को MakeCommerce is temporarily unavailable. Please try again in a moment or choose another payment method. या MakeCommerce could not start the payment for this order. Please choose another payment method or contact us. दिखाई देता है। तकनीकी कारण ऑर्डर नोट्स और लॉग में जोड़ा जाता है।

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

बैंक या कार्ड का चयन MakeCommerce पृष्ठ पर किया जाता है, आपके चेकआउट में नहीं। इस प्लगइन में सहेजे गए कार्ड, आवर्ती भुगतान या WooCommerce Subscriptions नहीं हैं और MakeCommerce शिपिंग (पार्सल मशीनें, लेबल) शामिल नहीं है।

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

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

Pending payment: ग्राहक को MakeCommerce पर भेजा गया था और उसने अभी तक भुगतान नहीं किया है, या MakeCommerce ने अभी तक भुगतान की पुष्टि नहीं की है। ऑर्डर नोट MakeCommerce लेन-देन, राशि और वातावरण दिखाता है।

Processing: भुगतान की पुष्टि हो गई थी। केवल आभासी डाउनलोड करने योग्य उत्पादों वाले ऑर्डर पूर्ण (Completed) हो जाते हैं, जो कि WooCommerce का डिफ़ॉल्ट है। ऑर्डर नोट राशि, लेन-देन, वातावरण और इसे कैसे सत्यापित किया गया (MakeCommerce API या हस्ताक्षरित अधिसूचना) दिखाता है। लेन-देन ID, MakeCommerce लेन-देन ID है।

On hold: भुगतान की गई राशि या मुद्रा ऑर्डर से भिन्न थी, राशि गायब थी, MakeCommerce में लेन-देन की स्थिति अभी अंतिम नहीं थी, या रद्द किए गए ऑर्डर के लिए भुगतान आया था। ऑर्डर नोट इसे स्पष्ट करता है। ऐसा लेन-देन कभी भी बाद में ऑर्डर का भुगतान नहीं करता है। Merchant Portal में लेन-देन की जाँच करें और मैन्युअल रूप से ऑर्डर पूरा करें या रिफ़ंड करें।

Failed: ऑर्डर का नवीनतम भुगतान रद्द कर दिया गया था, समाप्त हो गया था या विफल हो गया था। ग्राहक फिर से भुगतान कर सकता है।

यदि पहले से भुगतान किए गए ऑर्डर के लिए दूसरा भुगतान आता है, तो ऑर्डर फिर से नहीं बदला जाता है। एक नोट आपसे MakeCommerce Merchant Portal में डुप्लिकेट राशि रिफ़ंड करने का अनुरोध करता है।

Check MakeCommerce payment status

ऑर्डर स्क्रीन पर, ऑर्डर क्रियाओं में Check MakeCommerce payment status चुनें। प्लगइन MakeCommerce API से ऑर्डर के लेन-देन की स्थिति पूछता है (नवीनतम पहले), इसे लागू करता है और परिणाम के साथ एक नोट जोड़ता है। इसका उपयोग तब करें जब ग्राहक द्वारा भुगतान किए जाने के बावजूद ऑर्डर Pending payment में रहे।

रिफ़ंड

ऑर्डर खोलें, Refund पर क्लिक करें, राशि दर्ज करें और Refund via Bank link or card (MakeCommerce) पर क्लिक करें (बटन आपका Title दिखाता है)। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। रिफ़ंड उसी वातावरण में भेजा जाता है जिसमें ऑर्डर का भुगतान किया गया था (परीक्षण या लाइव), इसलिए उस वातावरण की कुंजियाँ सेट होनी चाहिए। यदि MakeCommerce रिफ़ंड स्वीकार नहीं करता है, तो WooCommerce त्रुटि दिखाता है, एक नोट जोड़ा जाता है और कोई रिफ़ंड दर्ज नहीं किया जाता है। यदि MakeCommerce अभी भी भुगतान को संसाधित कर रहा है, तो संदेश होता है MakeCommerce is still processing this payment — try the refund again later. सफल रिफ़ंड MakeCommerce रिफ़ंड ID के साथ ऑर्डर नोट्स में जोड़ा जाता है।

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

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

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

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

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

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

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

चेकआउट पर MakeCommerce दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है और वर्तमान वातावरण में उसकी कुंजियाँ हैं: परीक्षण मोड में Test Shop ID और Test Secret key, लाइव मोड में Live Shop ID और Live Secret key। जाँचें कि स्टोर मुद्रा (या Pay for order पृष्ठ पर ऑर्डर मुद्रा) में अधिकतम दो दशमलव हैं। सेटिंग्स पृष्ठ इनमें से प्रत्येक समस्या के लिए एक चेतावनी दिखाता है।

भुगतान हो गया, लेकिन ऑर्डर Pending payment बना हुआ है: सूचनाएं साइट तक नहीं पहुँच सकीं, उदाहरण के लिए फ़ायरवॉल, रखरखाव मोड या बुनियादी प्रमाणीकरण के कारण। ऑर्डर खोलें और ऑर्डर क्रिया Check MakeCommerce payment status चलाएँ। जाँचें कि जिस वातावरण में भुगतान किया गया था उसकी कुंजियाँ सेट हैं: अधिसूचना की जाँच उस वातावरण की Secret key से की जाती है, और इसके बिना MakeCommerce को एक त्रुटि मिलती है और वह पुनः प्रयास करता है।

ऑर्डर MakeCommerce नोट के साथ On hold पर है: भुगतान ऑर्डर (राशि, मुद्रा, स्थिति) से मेल नहीं खाता था या किसी रद्द किए गए ऑर्डर के लिए आया था। Merchant Portal में लेन-देन की जाँच करें और मैन्युअल रूप से ऑर्डर पूरा करें या रिफ़ंड करें।

सूचनाएं अस्वीकार कर दी जाती हैं: गलत हस्ताक्षर वाला, किसी अन्य ऑर्डर, किसी अन्य स्टोर या ऑर्डर के लिए नहीं बनाए गए लेन-देन का संदेश अस्वीकार कर दिया जाता है और ऑर्डर में कोई बदलाव नहीं होता है। जाँचें कि Shop ID और Secret key एक ही MakeCommerce खाते और वातावरण से संबंधित हैं।

ऑर्डर देते समय ग्राहक को एक त्रुटि दिखाई देती है: ऑर्डर नोट्स खोलें या Debug log चालू करें और WooCommerce > Status > Logs, स्रोत wcp_makecommerce_payment देखें। एक मुद्रा जिसे MakeCommerce चार्ज नहीं कर सकता, वह MakeCommerce cannot process payments in और मुद्रा कोड देती है।

वातावरण के बारे में एक संदेश के साथ रिफ़ंड विफल रहता है: ऑर्डर का भुगतान परीक्षण या लाइव वातावरण में किया गया था, और उस वातावरण की कुंजियाँ कॉन्फ़िगर नहीं हैं। उन्हें दर्ज करें और पुनः प्रयास करें।

No MakeCommerce transaction ID found for this order के साथ रिफ़ंड विफल रहता है: ऑर्डर में कोई MakeCommerce लेन-देन नहीं है। Merchant Portal में इसे रिफ़ंड करें।

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

अनइंस्टॉल

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

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