VibeFox Conekta for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

मुद्रा: स्टोर की मुद्रा MXN या USD होनी चाहिए। दूसरी मुद्राओं के लिए भुगतान का तरीका छिपा दिया जाता है।

Conekta खाता: आपको अपने Conekta खाते की Private Keys (टेस्ट और लाइव) और Conekta पैनल में एक वेबहुक चाहिए (देखें कॉन्फ़िगरेशन)। केवल Private Keys इस्तेमाल होती हैं। Public Key की ज़रूरत नहीं है, क्योंकि भुगतान Conekta के होस्टेड चेकआउट पर होता है।

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

इंस्टॉलेशन

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

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

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

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

5. अपनी टेस्ट और लाइव Private Keys डालें, मोड चुनें और Conekta पैनल में वेबहुक जोड़ें (देखें कॉन्फ़िगरेशन)।

6. Enable / Disable चालू करें और सेव करें। टेस्ट मोड में एक भुगतान आज़माएँ, फिर Test mode का निशान हटा दें।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Conekta। फ़ील्ड्स के ऊपर पेज चेतावनी देता है जब Conekta चालू हो पर मौजूदा मोड की Private Key खाली हो (तब भुगतान का तरीका चेकआउट पर छिपा रहता है), और जब स्टोर की मुद्रा MXN या USD न हो। टेस्ट मोड चालू होने पर यह Test mode is on: payments are simulated with the test private key. दिखाता है। मौजूदा मोड की कुंजी के बिना सक्रिय गेटवे सेव करने पर एक त्रुटि-संदेश आता है, जो आपसे कुंजी डालने के लिए कहता है।

सामान्य

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

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

Description: चेकआउट पर भुगतान तरीके के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely with card, OXXO cash or SPEI transfer. You will be redirected to Conekta to complete your payment.

Payment methods: Conekta भुगतान पेज पर दिए गए तरीके। डिफ़ॉल्ट: कार्ड, नकद और बैंक ट्रांसफ़र। नकद, SPEI और BNPL केवल MXN ऑर्डर के लिए उपलब्ध हैं (USD ऑर्डर पर केवल कार्ड) और आपके Conekta खाते में सक्षम होने चाहिए। कुछ भी चुना न हो, तो कार्ड इस्तेमाल होता है।

API कुंजियाँ

Conekta पैनल में Developers > API keys से अपनी Private Keys कॉपी करें। टेस्ट और लाइव कुंजियाँ अलग-अलग होती हैं।

Test mode: Enable test mode टेस्ट Private Key का उपयोग करता है। कोई वास्तविक पैसा नहीं लिया जाता, और चेकआउट पर TEST MODE बैज दिखता है। रिफ़ंड हमेशा उसी मोड की कुंजी से होते हैं जिसमें भुगतान हुआ था। डिफ़ॉल्ट: चालू।

Test private key: आपके Conekta खाते के टेस्ट मोड की निजी API कुंजी।

Live private key: आपके Conekta खाते के प्रोडक्शन (लाइव) मोड की निजी API कुंजी। इसे गुप्त रखें।

हर Conekta ऑर्डर अपना मोड याद रखता है: सूचनाएँ और रिफ़ंड संबंधित कुंजी का उपयोग करते हैं। जब तक पुराने टेस्ट ऑर्डर खुले हैं, दोनों कुंजियाँ भरी रखें।

वेबहुक

वेबहुक आपके स्टोर को उन भुगतानों के बारे में बताता है जो ग्राहक के Conekta पेज छोड़ने के बाद हुए, जैसे OXXO या SPEI भुगतान। Conekta पैनल में Developers > Webhooks पर जाएँ और इस सेक्शन में दिखाया गया URL टेस्ट और लाइव मोड दोनों के लिए जोड़ें। यह ऐसा दिखता है: https://your-site/wc-api/webhook_wc_conekta/।

ये इवेंट चुनें:

वेबहुक का बॉडी प्लगइन को केवल यह बताता है कि कौन-सा Conekta ऑर्डर बदला है। हर सूचना की जाँच उस मोड की Private Key से Conekta API पर ऑर्डर दोबारा पढ़कर की जाती है; वेबहुक का Digest सिग्नेचर हेडर इस्तेमाल नहीं होता। जिन Conekta ऑर्डरों को इस स्टोर ने उस ऑर्डर के लिए नहीं बनाया, उनकी सूचनाएँ स्वीकार करके अनदेखी की जाती हैं। वेबहुक के बिना, ऑर्डर केवल तब पक्का होता है जब ग्राहक भुगतान के बाद स्टोर पर लौटे, या उसी ऑर्डर के अगले भुगतान प्रयास पर।

उन्नत

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

Delete data on uninstall: Remove the settings, Conekta order references and logs when the plugin is deleted। डिफ़ॉल्ट: बंद।

चेकआउट

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

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Conekta पुष्टि कर दे: प्लगइन वेबहुक आने पर और ग्राहक के लौटने पर Conekta API से ऑर्डर पढ़ता है। यदि भुगतान की अभी पुष्टि नहीं हो सकी, तो «ऑर्डर प्राप्त हुआ» पेज पर We are confirming your payment with Conekta. The order will be updated automatically — please do not pay again. दिखता है। यदि ग्राहक ने OXXO या SPEI चुना और भुगतान संदर्भ मिला, तो ऑर्डर «होल्ड पर» चला जाता है और पेज पर Your Conekta payment reference has been issued. The order will be confirmed as soon as the payment is received. दिखता है।

यदि भुगतान अस्वीकार होता है, तो ऑर्डर «विफल» चिह्नित होता है और ग्राहक Pay for order पेज पर लौटता है, जहाँ The Conekta payment was not completed. Please try again or choose another payment method. दिखता है। यदि चेकआउट की समय-सीमा समाप्त हो गई या वह रद्द कर दिया गया, तो ग्राहक को The Conekta payment has expired or was cancelled. Please place the order again. दिखता है। जब ग्राहक किसी ऑर्डर का दोबारा भुगतान करता है, तो उसी राशि वाला खुला Conekta चेकआउट दोबारा इस्तेमाल होता है; अन्यथा नया बनाने से पहले पिछला Conekta में रद्द कर दिया जाता है, ताकि पुराना लिंक दो बार भुगतान में इस्तेमाल न हो सके। यदि पिछला चेकआउट पहले ही भुगतान किया जा चुका था, तो दोबारा चार्ज करने के बजाय भुगतान दर्ज कर लिया जाता है।

यदि Conekta भुगतान शुरू नहीं कर पाता, तो ग्राहक को एक छोटा संदेश दिखता है, जैसे The payment could not be started. Please try again in a moment or choose another payment method. तकनीकी कारण लॉग में लिखा जाता है।

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

प्लगइन भुगतान केवल Conekta पेज पर लेता है। आपके चेकआउट पेज पर कार्ड फ़ॉर्म नहीं है; सेव किए गए कार्ड, सब्सक्रिप्शन, प्री-ऑथराइज़ेशन और कैप्चर या मासिक किस्तें (MSI) नहीं हैं।

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

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

Pending payment: ग्राहक को Conekta पर भेजा गया है और उसने अभी भुगतान नहीं किया है। ऑर्डर नोट में Conekta ऑर्डर और मोड दिखता है।

Processing: Conekta ने उसी राशि और मुद्रा के साथ भुगतान की पुष्टि की है (केवल डाउनलोड होने वाले वर्चुअल उत्पादों वाले ऑर्डर WooCommerce के डिफ़ॉल्ट के अनुसार «पूर्ण» हो जाते हैं)। ऑर्डर नोट में भुगतान का तरीका (उदाहरण के लिए कार्ड ब्रांड और अंतिम चार अंक, OXXO / नकद या SPEI बैंक ट्रांसफ़र), Conekta ऑर्डर और चार्ज दिखते हैं। ऑर्डर का ट्रांज़ैक्शन ID Conekta का charge ID है।

On hold, waiting for OXXO or SPEI: ग्राहक को भुगतान संदर्भ मिल गया है। Conekta द्वारा भुगतान की सूचना मिलने पर ऑर्डर «प्रोसेसिंग» हो जाता है।

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

Failed: भुगतान अस्वीकार हुआ। नोट में कारण दिखता है। ग्राहक फिर से भुगतान कर सकता है।

Cancelled: मौजूदा Conekta चेकआउट की समय-सीमा समाप्त हो गई या वह रद्द कर दिया गया।

भुगतान या रिफ़ंड हो चुका ऑर्डर कभी नीचे नहीं किया जाता और दोबारा नहीं खोला जाता। यदि पहले से भुगतान किए गए ऑर्डर के लिए कोई और Conekta भुगतान आता है, तो एक WARNING नोट आपसे Conekta पैनल में उसका रिफ़ंड करने को कहता है।

रिफ़ंड

ऑर्डर खोलें, Refund पर क्लिक करें, राशि दर्ज करें और Refund via Conekta पर क्लिक करें (बटन पर भुगतान तरीके का शीर्षक दिखता है)। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। रिफ़ंड उस Conekta ऑर्डर पर जाता है जिसमें भुगतान है, और उसी मोड की कुंजी इस्तेमाल करता है जिसमें भुगतान हुआ था, इसलिए वह कुंजी सेट होनी चाहिए। यदि Conekta रिफ़ंड स्वीकार नहीं करता, तो WooCommerce त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड राशि, मोड, Conekta ऑर्डर, रिफ़ंड ID और कारण के साथ ऑर्डर नोट्स में जुड़ता है।

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

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

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

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

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

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

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

Conekta चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable / Disable चालू है, मौजूदा मोड की Private Key भरी है (टेस्ट मोड में Test private key, लाइव मोड में Live private key) और स्टोर की मुद्रा MXN या USD है। सेटिंग्स पेज इनमें से हर शर्त के लिए चेतावनी दिखाता है।

भुगतान हो गया, लेकिन ऑर्डर Pending payment पर रुका है: वेबहुक काम नहीं कर रहा। Conekta पैनल में जाँचें कि जिस मोड (टेस्ट या लाइव) का उपयोग कर रहे हैं उसके लिए वेबहुक मौजूद है, उसका URL सेटिंग्स में दिखाए गए URL से बिल्कुल मेल खाता है, और इवेंट चुने गए हैं। जाँचें कि उस मोड की Private Key सेट है, क्योंकि हर सूचना उसी से जाँची जाती है। ग्राहक के स्टोर पर लौटने पर, या उसी ऑर्डर का भुगतान दोबारा करने की कोशिश पर भी ऑर्डर की पुष्टि हो जाती है।

वेबहुक Temporarily unavailable का उत्तर देता है: Conekta API तक पहुँच नहीं हो सकी, ऑर्डर के मोड की Private Key नहीं है, या ऑर्डर किसी दूसरे अनुरोध द्वारा प्रोसेस हो रहा था। Conekta वेबहुक को दोबारा भेजता है।

वेबहुक Verification failed, Invalid payload या Invalid order id का उत्तर देता है: Conekta API ने ऑर्डर की पुष्टि नहीं की, या सूचना कोई मान्य Conekta ऑर्डर इवेंट नहीं थी।

वेबहुक Ignored का उत्तर देता है: सूचना ऐसे Conekta ऑर्डर से संबंधित है जिसे इस स्टोर ने उस ऑर्डर के लिए नहीं बनाया (उदाहरण के लिए कोई दूसरा स्टोर, या उसी खाते पर कोई भुगतान लिंक), या वह ऑर्डर के अलावा किसी अन्य ऑब्जेक्ट से संबंधित है।

ग्राहक को We could not check the status of your previous payment attempt दिखता है: ऑर्डर के पिछले Conekta चेकआउट को पढ़ा नहीं जा सका, इसलिए दोहरे भुगतान से बचने के लिए नया नहीं बनाया गया। कुछ देर बाद फिर से कोशिश करें।

ग्राहक को Payment gateway is not configured दिखता है: मौजूदा मोड की Private Key नहीं है।

ऑर्डर On hold है: ऑर्डर नोट्स पढ़ें। ग्राहक ने अभी OXXO या SPEI संदर्भ का भुगतान नहीं किया है, राशि या मुद्रा मेल नहीं खाई, या स्टोर के लाइव मोड में होने पर टेस्ट-मोड का भुगतान आया।

टेस्ट या लाइव मोड के संदेश के साथ रिफ़ंड विफल होता है: भुगतान उसी मोड में हुआ था, और उस मोड की Private Key सेट नहीं है। उसे डालें और फिर से कोशिश करें।

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

डेवलपर्स के लिए: readme में मुद्राओं की सूची के लिए फ़िल्टर wc_ckt_supported_currencies दिया गया है।

अनइंस्टॉल

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

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