VibeFox Wompi for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

स्टोर मुद्रा: कोलंबियाई पेसो (COP)। Wompi Colombia केवल COP में शुल्क लेता है, और अन्य मुद्राओं के ऑर्डरों के लिए भुगतान तरीका छिपा रहता है।

Wompi खाता: एक Wompi Colombia मर्चेंट खाता। हर वातावरण (सैंडबॉक्स और प्रोडक्शन) में चार कुंजियाँ होती हैं: public key, private key, events secret और integrity secret। ये Wompi मर्चेंट डैशबोर्ड (comercios.wompi.co) में developers सेक्शन में मिलती हैं। Wompi El Salvador और Panama अलग APIs इस्तेमाल करते हैं और समर्थित नहीं हैं।

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

इंस्टॉलेशन

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

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

3. WooCommerce > Settings > General में स्टोर मुद्रा को कोलंबियाई पेसो (COP) पर सेट करें।

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

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

6. Wompi मर्चेंट डैशबोर्ड से सैंडबॉक्स और प्रोडक्शन की कुंजियाँ पेस्ट करें और Wompi में Events URL सेट करें (देखें कॉन्फ़िगरेशन)।

7. Enable/Disable चालू करें। सैंडबॉक्स मोड में एक भुगतान का परीक्षण करें, फिर असली भुगतान स्वीकार करने के लिए Sandbox mode का चिह्न हटा दें।

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

सारी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Wompi। फ़ील्ड के ऊपर एक स्टेटस बॉक्स मौजूदा मोड दिखाता है, SANDBOX या PRODUCTION। जब इस मोड की कोई कुंजी गायब होती है, तो बॉक्स उसे सूचीबद्ध करता है और बताता है कि इस वातावरण की सारी कुंजियाँ सेट होने तक चेकआउट पर भुगतान तरीका छिपा रहेगा। जब सारी कुंजियाँ सेट हो जाती हैं, तो बॉक्स बताता है कि असली भुगतान लिए जाएँगे या नहीं। सेव करते समय, अगर कोई कुंजी अपने सेक्शन के उपसर्ग से शुरू नहीं होती, या अगर Wompi सक्षम है पर कुंजियाँ न होने के कारण चेकआउट पर छिपा है, तो प्लगइन चेतावनी देता है। भुगतान तरीकों की सूची में, जब तक मौजूदा मोड की चारों कुंजियाँ न हों, Wompi को सेटअप की ज़रूरत वाले के रूप में चिह्नित किया जाता है। संस्करण 1.0 की कुंजियाँ अपडेट पर अपने-आप संबंधित Sandbox या Production सेक्शन में चली जाती हैं।

सामान्य

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

Title: वह नाम जो ग्राहक चेकआउट पर भुगतान तरीके के लिए देखते हैं। डिफ़ॉल्ट: Wompi।

Description: चेकआउट पर भुगतान तरीके के नीचे दिखाया जाने वाला पाठ। डिफ़ॉल्ट: Pay securely with Wompi: cards, PSE, Nequi, Bancolombia and more.

Wompi खाता

Wompi मर्चेंट डैशबोर्ड (comercios.wompi.co) में developers सेक्शन से कुंजियाँ कॉपी करें। हर वातावरण की अपनी public key, private key, events secret और integrity secret होती है।

Sandbox mode: Use the Wompi sandbox (sandbox keys, no real money)। यह कुंजियों और Wompi API (sandbox.wompi.co या production.wompi.co) दोनों को बदलता है। ऑर्डर उस वातावरण को बनाए रखते हैं जिसमें उनका भुगतान हुआ था। डिफ़ॉल्ट: चालू। असली भुगतान स्वीकार करने के लिए चिह्न हटा दें।

सैंडबॉक्स कुंजियाँ

Wompi सैंडबॉक्स की चार कुंजियाँ। ये क्रमशः pub_test_, prv_test_, test_events_ और test_integrity_ से शुरू होती हैं।

Public key: सैंडबॉक्स public key (pub_test_...)। यह Wompi Web Checkout पर आपके खाते की पहचान करती है।

Private key: सैंडबॉक्स private key (prv_test_...)। इसका उपयोग Wompi API से लेन-देन पढ़ने के लिए होता है।

Events secret: सैंडबॉक्स events secret (test_events_...)। यह Wompi इवेंट के हस्ताक्षर की पुष्टि करता है।

Integrity secret: सैंडबॉक्स integrity secret (test_integrity_...)। यह Web Checkout को भेजे गए भुगतान अनुरोध पर हस्ताक्षर करता है।

प्रोडक्शन कुंजियाँ

Wompi प्रोडक्शन वातावरण की चार कुंजियाँ। ये क्रमशः pub_prod_, prv_prod_, prod_events_ और prod_integrity_ से शुरू होती हैं।

Public key: प्रोडक्शन public key (pub_prod_...)।

Private key: प्रोडक्शन private key (prv_prod_...)।

Events secret: प्रोडक्शन events secret (prod_events_...)।

Integrity secret: प्रोडक्शन integrity secret (prod_integrity_...)।

Events URL (webhook)

Wompi इवेंट आपके स्टोर को बताते हैं कि कोई लेन-देन बदल गया है। Wompi मर्चेंट डैशबोर्ड के developers सेक्शन में, सेटिंग्स के इस भाग में दिखाया गया Events URL सैंडबॉक्स और प्रोडक्शन दोनों के लिए सेट करें। यह कुछ ऐसा दिखता है: https://your-site/wc-api/wompi_p/। URL को ठीक वैसे ही कॉपी करें जैसा सेटिंग्स में दिखता है।

प्लगइन यह इवेंट इस्तेमाल करता है:

अन्य इवेंट का जवाब Ignored से दिया जाता है। हर इवेंट की जाँच उसके वातावरण (सैंडबॉक्स या प्रोडक्शन) के events secret से होती है। मान्य हस्ताक्षर न होने वाले इवेंट अस्वीकार किए जाते हैं। जाँच के बाद लेन-देन Wompi API से पढ़ा जाता है, और केवल वही डेटा इस्तेमाल होता है। Events URL के बिना, ऑर्डर तभी पुष्ट होता है जब ग्राहक भुगतान के बाद स्टोर पर लौटता है।

एडवांस्ड

Debug log: Log payment and webhook activity भुगतान और इवेंट की गतिविधि को WooCommerce > Status > Logs में, स्रोत wcp_wompi_payment के साथ लिखता है। यह विकल्प बंद होने पर भी त्रुटियाँ हमेशा लॉग होती हैं। कुंजियाँ, secrets और ग्राहक डेटा कभी लॉग नहीं होते। डिफ़ॉल्ट: बंद।

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

चेकआउट

ग्राहक भुगतान तरीका चुनता है (डिफ़ॉल्ट रूप से Wompi) और ऑर्डर देता है। सैंडबॉक्स मोड में, चेकआउट विवरण के नीचे Sandbox mode: no real payment is made. दिखाता है। प्लगइन अपने संदर्भ (WC-, ऑर्डर नंबर और एक टाइमस्टैम्प) के साथ भुगतान प्रयास बनाता है, उसे integrity secret से हस्ताक्षरित करता है, और ग्राहक को COP में ऑर्डर राशि के साथ Wompi Web Checkout पर भेजता है। ग्राहक का बिलिंग ई-मेल और नाम Wompi को भेजे जाते हैं। ऑर्डर पर एक नोट वातावरण, संदर्भ और राशि दर्ज करता है।

Wompi पेज पर ग्राहक आपके Wompi खाते में सक्षम किसी भी भुगतान तरीके से भुगतान करता है। फिर Wompi ग्राहक को आपके स्टोर के ऑर्डर प्राप्ति पेज पर वापस भेजता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Wompi पुष्टि करे: या तो हस्ताक्षरित इवेंट से, या ग्राहक के उस पेज पर पहुँचने पर सर्वर से Wompi API को भेजे गए अनुरोध से। वापसी पते में दिए गए लेन-देन नंबर पर भरोसा नहीं किया जाता। पेज रीलोड होने पर लेन-देन को अधिकतम हर 20 सेकंड में एक बार फिर से जाँचा जाता है।

उस ऑर्डर का भुगतान केवल उसी ऑर्डर के लिए बने लेन-देन कर सकते हैं, और केवल प्रयास के वातावरण में। ग्राहक बिना भुगतान वाले ऑर्डर को फिर से भुगतान कर सकता है, उदाहरण के लिए Pay for order पेज से। हर प्रयास को नया संदर्भ मिलता है।

भुगतान तरीका तभी दिखता है जब लाइसेंस सक्रिय हो, मौजूदा मोड की चारों कुंजियाँ सेट हों, ऑर्डर की मुद्रा COP हो और कुल राशि कम से कम COP 1,500 हो। अगर भुगतान शुरू नहीं हो सकता, तो ग्राहक को एक छोटा संदेश दिखता है और वह कोई और भुगतान तरीका चुन सकता है:

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

प्लगइन WooCommerce से रिफ़ंड नहीं करता। आपकी साइट पर सेव किए गए कार्ड, सब्सक्रिप्शन या कार्ड फ़ील्ड नहीं हैं: सारी भुगतान जानकारी Wompi पर दर्ज होती है।

ऑर्डर

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

Pending payment: ग्राहक को Wompi पर भेजा गया है और उसने अभी भुगतान नहीं किया है, या Wompi ने अभी लेन-देन की पुष्टि नहीं की है।

On hold (pending payment): Wompi ने लेन-देन को लंबित बताया है, जैसे पुष्टि का इंतज़ार कर रहे PSE, Nequi या नकद भुगतान। Wompi के स्वीकृत या अस्वीकृत करने तक ऑर्डर होल्ड पर रहता है।

Processing or Completed: लेन-देन स्वीकृत हो गया है। WooCommerce का मानक लागू होता है: Processing, या केवल वर्चुअल डाउनलोड योग्य उत्पादों वाले ऑर्डरों के लिए Completed। ऑर्डर नोट में Wompi लेन-देन, भुगतान तरीके का प्रकार (जैसे कार्ड, PSE या Nequi) और संदर्भ दिखता है। ऑर्डर की transaction ID, Wompi की transaction ID है।

On hold after payment: Wompi ने ऑर्डर की कुल राशि से अलग राशि या मुद्रा स्वीकृत की है (उदाहरण के लिए, भुगतान शुरू होने के बाद ऑर्डर बदला गया), या ऑर्डर रद्द होने के बाद भुगतान स्वीकृत हुआ। ऑर्डर को भुगतान किया हुआ नहीं माना जाता। ऑर्डर नोट इसका कारण बताता है। Wompi डैशबोर्ड में भुगतान की जाँच करें, फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

Failed: नवीनतम भुगतान प्रयास का लेन-देन अस्वीकृत हुआ या त्रुटि के साथ समाप्त हुआ। Wompi का संदेश नोट में जुड़ जाता है। पुराने प्रयासों के परिणाम ऑर्डर नहीं बदलते।

Cancelled: नवीनतम भुगतान प्रयास का लेन-देन ऑर्डर के भुगतान होने से पहले Wompi में void किया गया था।

अगर पहले से भुगतान किए गए ऑर्डर के लिए दूसरा स्वीकृत भुगतान आता है, तो ऑर्डर नहीं बदलता। एक नोट आपसे Wompi डैशबोर्ड में डुप्लिकेट राशि रिफ़ंड करने को कहता है। अगर भुगतान वाला लेन-देन Wompi में void हो जाता है, तो एक नोट आपसे ऑर्डर की जाँच करने को कहता है। रिफ़ंड किए गए ऑर्डर के लिए देर से आया भुगतान केवल एक नोट जोड़ता है। बार-बार आने वाले इवेंट और ग्राहक की वापसी से नोट, ई-मेल या स्टॉक बदलाव कभी दोहराए नहीं जाते।

रिफ़ंड

रिफ़ंड WooCommerce से नहीं भेजे जाते। Wompi मर्चेंट डैशबोर्ड में भुगतान रिफ़ंड या void करें, फिर WooCommerce में मैनुअल रिफ़ंड दर्ज करें। Wompi में किया गया void ऑर्डर में नोट के रूप में जुड़ता है।

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

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

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

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

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

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

Wompi चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और मौजूदा मोड की चारों कुंजियाँ सेट हैं (सेटिंग्स पेज का स्टेटस बॉक्स गायब कुंजियाँ सूचीबद्ध करता है)। यह भी जाँचें कि ऑर्डर की मुद्रा COP है और ऑर्डर की कुल राशि कम से कम COP 1,500 है।

भुगतान हो गया, पर ऑर्डर Pending payment पर अटका है: Events URL काम नहीं कर रहा। Wompi डैशबोर्ड में जाँचें कि जिस वातावरण (सैंडबॉक्स या प्रोडक्शन) का आप उपयोग करते हैं, उसके लिए Events URL सेट है और सेटिंग्स में दिखाए गए URL से बिल्कुल मेल खाता है। जाँचें कि उस वातावरण का events secret सही सेक्शन में है। ग्राहक के भुगतान के बाद स्टोर पर लौटने पर भी ऑर्डर पुष्ट हो जाता है।

Events URL Not configured लौटाता है: इवेंट के वातावरण का events secret खाली है। उसे सेटिंग्स में पेस्ट करें।

Events URL Invalid signature लौटाता है: events secret किसी दूसरे वातावरण या खाते का है। उसे Wompi डैशबोर्ड से फिर से कॉपी करें।

Events URL Transaction lookup failed लौटाता है: Wompi API ने लेन-देन नहीं लौटाया, उदाहरण के लिए गलत private key या नेटवर्क समस्या के कारण। Wompi बाद में इवेंट फिर से भेजता है।

Events URL Busy, retry लौटाता है: उसी समय कोई दूसरा अनुरोध ऑर्डर को अपडेट कर रहा था। Wompi बाद में इवेंट फिर से भेजता है।

Events URL Environment mismatch लौटाता है: सैंडबॉक्स का लेन-देन प्रोडक्शन के भुगतान प्रयास के लिए आया, या इसका उल्टा। सैंडबॉक्स भुगतान कभी प्रोडक्शन ऑर्डर पुष्ट नहीं करते।

सेव करते समय "The key does not start with ..." चेतावनी: कोई कुंजी गलत सेक्शन में पेस्ट हो गई है। सैंडबॉक्स कुंजियाँ pub_test_, prv_test_, test_events_ और test_integrity_ से शुरू होती हैं, प्रोडक्शन कुंजियाँ pub_prod_, prv_prod_, prod_events_ और prod_integrity_ से।

ऑर्डर On hold है और राशि के बारे में नोट है: स्वीकृत राशि या मुद्रा ऑर्डर की कुल राशि से अलग है। Wompi डैशबोर्ड में भुगतान की जाँच करें और ऑर्डर को मैन्युअली पूरा करें या रिफ़ंड करें।

अन्य त्रुटियाँ: ऑर्डर नोट या WooCommerce > Status > Logs खोलें, स्रोत wcp_wompi_payment। त्रुटियाँ हमेशा लॉग होती हैं। अधिक विवरण के लिए Debug log चालू करें। यदि आपका Wompi खाता स्वीकार करता है, तो डेवलपर wompi_p_supported_currencies फ़िल्टर से कोई और मुद्रा अनुमत कर सकते हैं।

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

अनइंस्टॉल

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

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