VibeFox Eupago for WooCommerce — सहायता
आवश्यकताएँ
WordPress: 6.0 या उसके बाद का संस्करण।
WooCommerce: 7.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय।
PHP: 8.0 या उसके बाद का संस्करण।
स्टोर मुद्रा: यूरो (EUR)। Eupago केवल यूरो में शुल्क लेता है, इसलिए अन्य मुद्राओं के लिए चेकआउट पर भुगतान विधि छिपा दी जाती है।
Eupago खाता: आपको अपने Eupago channel की API कुंजी और उस Webhook 2.0 की कुंजी चाहिए जिसे आप Eupago backoffice में बनाते हैं (देखें कॉन्फ़िगरेशन)। लाइव backoffice clientes.eupago.pt है, sandbox backoffice sandbox.eupago.pt है। Sandbox और live अलग खाते हैं, जिनकी कुंजियाँ भी अलग हैं।
VibeFox लाइसेंस कुंजी: vibefox.net पर खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से wcp_eupago_gateway फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।
2. Activate पर क्लिक करें।
3. सेटिंग्स खोलें: WooCommerce > Settings > Payments > Eupago > Manage, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।
4. पेज के ऊपर वाले लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें।
5. अपने Eupago channel की API कुंजी दर्ज करें, Eupago backoffice में Webhook 2.0 बनाएँ और उसकी कुंजी चिपकाएँ (देखें कॉन्फ़िगरेशन)।
6. Payment Method चुनें, Enable/Disable चालू करें, sandbox मोड में एक टेस्ट ऑर्डर दें, फिर Sandbox Mode का टिक हटा दें।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Eupago। गेटवे चालू होने पर, यदि वर्तमान मोड की API कुंजी खाली है तो पेज चेतावनी देता है (तब गेटवे चेकआउट पर छिपा रहता है), या sandbox मोड चालू होने पर Sandbox mode: no real payments are taken. दिखाता है। भुगतान विधियों की सूची में, वर्तमान मोड की API कुंजी सेट होने तक Eupago पर कार्रवाई की ज़रूरत का चिह्न लगा रहता है, और sandbox मोड में टेस्ट मोड बैज दिखता है।
सामान्य
Enable/Disable: Enable Eupago Gateway भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: off।
Title: चेकआउट पर ग्राहकों को दिखने वाला भुगतान विधि का नाम। डिफ़ॉल्ट: Eupago।
Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला टेक्स्ट। डिफ़ॉल्ट: Pay securely via Eupago।
Payment Method: चेकआउट पर दी जाने वाली एकमात्र Eupago विधि।
Order Status After Payment: भुगतान की पुष्टि होने पर सेट होने वाला ऑर्डर स्टेटस: Processing (डिफ़ॉल्ट) या Completed। स्टेटस तुरंत सेट होता है, एक ही स्टेटस बदलाव और एक ही ईमेल के साथ।
Eupago खाता
Eupago backoffice में अपने channel की API कुंजी और Webhook 2.0 कुंजी प्राप्त करें: clientes.eupago.pt (लाइव) या sandbox.eupago.pt (sandbox)।
Sandbox Mode: Enable sandbox/test mode sandbox.eupago.pt और sandbox कुंजियों का उपयोग करता है। कोई वास्तविक भुगतान नहीं लिया जाता। डिफ़ॉल्ट: on। लाइव कुंजियों से असली भुगतान लेने के लिए इसका टिक हटाएँ।
Live API Key: आपके लाइव Eupago channel की API कुंजी (clientes.eupago.pt)।
Live Webhook Key: आपके लाइव Webhook 2.0 की एन्क्रिप्शन कुंजी। अनिवार्य: बिना मान्य हस्ताक्षर की सूचनाएँ अस्वीकार की जाती हैं।
Sandbox API Key: आपके sandbox channel की API कुंजी (sandbox.eupago.pt)।
Sandbox Webhook Key: आपके sandbox Webhook 2.0 की एन्क्रिप्शन कुंजी।
Webhook URL
Webhook आपके स्टोर को बताता है कि भुगतान हो गया है। Eupago backoffice में सेटिंग्स के इस भाग में दिखाए गए URL, method POST और एन्क्रिप्शन चालू के साथ एक Webhook 2.0 बनाएँ। URL इस तरह दिखता है: https://your-site/wc-api/eupago_payment_callback/। sandbox backoffice में एक webhook और live backoffice में दूसरा webhook बनाएँ।
हर webhook की कुंजी Sandbox Webhook Key या Live Webhook Key में कॉपी करें। बिना मान्य हस्ताक्षर वाले webhook अस्वीकार होते हैं। बिना एन्क्रिप्शन वाला webhook तभी स्वीकार होता है जब Eupago उस पर हस्ताक्षर करता है, इसलिए एन्क्रिप्शन चालू रखें। प्लगइन इन सूचना स्थितियों पर प्रतिक्रिया देता है:
अन्य स्थितियों में कोई कार्रवाई आवश्यक नहीं है। उसी URL पर Eupago का legacy GET callback भी स्वीकार होता है; यह API कुंजी से प्रमाणित होता है और हमेशा एक भुगतान की सूचना देता है। सूचनाओं के बिना ऑर्डर कभी भुगतान किए हुए नहीं माने जाते: प्लगइन Eupago से पूछताछ नहीं करता, और ग्राहक की वापसी से ऑर्डर भुगतान नहीं होता।
उन्नत
Debug Log: Enable logging API कॉल और सूचनाएँ WooCommerce > Status > Logs में लिखता है, स्रोत wcp_eupago_gateway। कुंजियाँ, ईमेल और पूरे फ़ोन नंबर लॉग नहीं होते। त्रुटियाँ हमेशा लॉग होती हैं। डिफ़ॉल्ट: off।
Delete Data on Uninstall: Delete all plugin data when uninstalling। टिक होने पर प्लगइन हटाने पर गेटवे सेटिंग्स और लॉग हट जाते हैं। ऑर्डर और उनका भुगतान डेटा सुरक्षित रहता है। डिफ़ॉल्ट: off।
चेकआउट
ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Eupago) और ऑर्डर देता है। sandbox मोड में चेकआउट पर SANDBOX / TEST MODE दिखता है। इसके बाद क्या होता है, वह Payment Method पर निर्भर करता है।
Multibanco: चेकआउट पर ग्राहक को You will receive Multibanco payment details after placing the order. दिखता है। प्लगइन ऑर्डर कुल के लिए एक Multibanco reference बनाता है। ऑर्डर होल्ड पर चला जाता है, स्टॉक घटता है और कार्ट खाली हो जाता है। ऑर्डर प्राप्ति पेज पर entity, reference और राशि के साथ Multibanco Payment Details दिखता है। जब तक ऑर्डर भुगतान का इंतज़ार कर रहा है, वही विवरण ग्राहक के ऑर्डर ईमेल में भी जोड़ा जाता है। ग्राहक ATM पर या होम बैंकिंग से भुगतान करता है।
MB WAY: चेकआउट पर ग्राहक MB WAY Phone Number दर्ज करता है, जो बिलिंग फ़ोन से पहले से भरा होता है। पुर्तगाली नंबर +351 के बिना दर्ज किए जा सकते हैं। गलत नंबर पर Please enter a valid MB WAY phone number (e.g. 912 345 678 or +351 912 345 678). दिखता है। प्लगइन भुगतान अनुरोध MB WAY ऐप को भेजता है। ऑर्डर होल्ड पर चला जाता है, स्टॉक घटता है और कार्ट खाली हो जाता है। ऑर्डर प्राप्ति पेज ग्राहक से MB WAY ऐप खोलने और 5 मिनट के भीतर अनुरोध स्वीकृत करने को कहता है।
Credit Card: चेकआउट पर ग्राहक को You will be redirected to a secure payment page to enter your card details. दिखता है। ग्राहक को Eupago के कार्ड पेज पर भेजा जाता है, जो साइट की भाषा के अनुसार पुर्तगाली, स्पेनिश या अंग्रेज़ी में होता है। ऑर्डर Pending payment पर रहता है और कार्ट सुरक्षित रहता है। भुगतान के बाद ग्राहक ऑर्डर प्राप्ति पेज पर लौटता है, जो सूचना आने तक Your card payment is being confirmed by Eupago. You will receive an e-mail as soon as it is confirmed. दिखाता है। यदि कार्ड भुगतान विफल हो या छोड़ दिया जाए, तो ग्राहक Pay for order पेज पर पहुँचता है, जहाँ The card payment was not completed. You can try again or choose another payment method. या The card payment was cancelled. You can try again or choose another payment method. दिखता है।
हर विधि में, ऑर्डर तभी भुगतान किया हुआ माना जाता है जब Eupago उसकी सत्यापित सूचना से पुष्टि करे। ग्राहक Pay for order पेज से बिना भुगतान वाले ऑर्डर का दोबारा भुगतान कर सकता है; ऑर्डर के लिए बनाए गए हर भुगतान reference की जाँच के लिए मान्य रहते हैं।
यदि Eupago भुगतान शुरू नहीं कर पाता, तो ग्राहक को एक छोटा संदेश दिखता है, जैसे The payment could not be started because Eupago is temporarily unavailable. Please try again in a few minutes or choose another payment method. ऑर्डर नहीं बदलता, और विवरण लॉग में होते हैं।
यह भुगतान विधि क्लासिक चेकआउट, Checkout ब्लॉक और Pay for order पेज पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है। ग्राहकों को दिखने वाले टेक्स्ट पुर्तगाली में अनुवादित हैं।
प्लगइन प्रति इंस्टॉलेशन एक Eupago विधि देता है। इसमें WooCommerce से रिफ़ंड, सेव किए गए कार्ड, सब्सक्रिप्शन या प्री-ऑथराइज़ेशन नहीं हैं; PayShop, Cofidis Pay, Bizum या अन्य Eupago विधियाँ नहीं हैं; SMS रिमाइंडर, Multibanco की समाप्ति तिथि और स्टेटस पोलिंग नहीं है।
ऑर्डर
ऑर्डर स्टेटस
Pending payment: कार्ड भुगतान शुरू हुआ था और Eupago ने उसकी अभी पुष्टि नहीं की है।
On hold, awaiting payment: एक Multibanco reference या MB WAY अनुरोध बनाया गया। ऑर्डर नोट में entity और reference, या मास्क किया हुआ फ़ोन नंबर दिखता है।
Processing or Completed: भुगतान की पुष्टि हो गई। स्टेटस Order Status After Payment के अनुसार होता है। ऑर्डर नोट में विधि, Eupago transaction ID और reference दिखते हैं। ऑर्डर का transaction ID ही Eupago transaction ID है।
On hold, manual review: Eupago ने ऐसा भुगतान बताया जिसकी राशि या मुद्रा अलग है, जिसका reference इस ऑर्डर के लिए नहीं बना था, या ऐसे ऑर्डर के लिए जो इस बीच रद्द या विफल हो चुका था (उदाहरण के लिए देर से भुगतान हुआ Multibanco reference)। नोट इसकी व्याख्या करता है। भुगतान और स्टॉक जाँचें, फिर ऑर्डर मैन्युअल रूप से पूरा करें या ग्राहक को रिफ़ंड करें। इस भुगतान की बाद की सूचनाएँ आपकी जानकारी के बिना ऑर्डर पूरा नहीं करतीं।
Cancelled: बिना भुगतान वाले ऑर्डर के मौजूदा भुगतान प्रयास के लिए Eupago ने भुगतान रद्द या समाप्त होने की सूचना दी।
Failed: बिना भुगतान वाले ऑर्डर के मौजूदा भुगतान प्रयास के लिए Eupago ने त्रुटि की सूचना दी।
यदि Eupago किसी पहले से भुगतान किए गए ऑर्डर के लिए कोई और भुगतान बताए (उदाहरण के लिए, पुराना Multibanco reference भी भुगतान हो गया), तो ऑर्डर नहीं बदलता। एक नोट आपको डुप्लिकेट भुगतान जाँचने और Eupago backoffice में उसे रिफ़ंड करने को कहता है। भुगतान हो चुके और बाद में रद्द या रिफ़ंड किए गए ऑर्डर को भुगतान सूचना कभी फिर से नहीं खोलती।
रिफ़ंड: WooCommerce से रिफ़ंड समर्थित नहीं हैं। Eupago backoffice में ग्राहक को रिफ़ंड करें और Refund manually से WooCommerce में रिफ़ंड दर्ज करें।
लाइसेंस कुंजी
प्लगइन vibefox.net से प्राप्त VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Payments > Eupago के सबसे ऊपर है। कुंजी License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्टेटस दिखाता है, जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्टेटस फिर से जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस साइट से कुंजी हटाने के लिए Remove key का उपयोग करें। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।
एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने से उसका डोमेन स्लॉट मुक्त नहीं होता। अपने vibefox.net खाते में स्लॉट मुक्त करें।
सक्रिय कुंजी के बिना Eupago चेकआउट पर ग्राहकों को नहीं दिखाया जाता। फिर भी यदि भुगतान शुरू हो जाए, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। लॉग-इन स्टोर मैनेजर को भुगतान विधि (unlicensed — visible to admins only) चिह्न के साथ दिखती रहती है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट कर सकें और परख सकें। Plugins पेज और WooCommerce पेजों पर एक रिमाइंडर दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं, उनकी पुष्टि अब भी होती है।
लाइसेंस की अवधि समाप्त होने पर प्लगइन काम करना जारी रखता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। स्थिति पृष्ठभूमि में अपने-आप फिर से जाँची जाती है।
समस्या निवारण
चेकआउट पर Eupago दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, वर्तमान मोड की API कुंजी सेट है (sandbox मोड में Sandbox API Key, लाइव मोड में Live API Key) और स्टोर मुद्रा EUR है। Multibanco के लिए ऑर्डर कुल 1 € से 999 999.99 € के बीच होना चाहिए।
भुगतान हो गया, लेकिन ऑर्डर Pending payment या On hold पर है: Eupago की सूचना नहीं पहुँची या अस्वीकृत हुई। जिस मोड का आप उपयोग करते हैं, उसके Eupago backoffice में जाँचें कि Webhook 2.0 मौजूद है, उसका URL सेटिंग्स में दिखाए गए URL से हूबहू मेल खाता है, method POST है और एन्क्रिप्शन चालू है। जाँचें कि उसकी कुंजी सही फ़ील्ड (Sandbox Webhook Key या Live Webhook Key) में है। Debug Log चालू करें और WooCommerce > Status > Logs में स्रोत wcp_eupago_gateway देखें। यदि सूचना बिल्कुल नहीं आती, तो Eupago backoffice में भुगतान की जाँच करें।
Webhook का उत्तर Invalid signature या Missing signature है: प्लगइन में webhook कुंजी, webhook की कुंजी से मेल नहीं खाती, या webhook बिना एन्क्रिप्शन और बिना हस्ताक्षर के है। कुंजी दोबारा कॉपी करें और एन्क्रिप्शन चालू रखें।
Webhook का उत्तर Webhook key not configured है: दोनों webhook कुंजियाँ सेट नहीं हैं। कुंजी चिपकाने के बाद Eupago सूचना दोबारा भेजता है।
Webhook का उत्तर Decryption failed है: हस्ताक्षर मान्य है, लेकिन बॉडी डिक्रिप्ट नहीं हो सकी। Eupago backoffice में Webhook 2.0 की सेटिंग्स जाँचें।
Webhook का उत्तर Environment mismatch है: सूचना उस मोड से अलग मोड की कुंजी से हस्ताक्षरित है जिसमें ऑर्डर दिया गया था। sandbox की सूचना कभी लाइव ऑर्डर का भुगतान नहीं करती, और इसका उलटा भी सही है।
Legacy callback का उत्तर Invalid API key है: Eupago द्वारा भेजी गई API कुंजी Live API Key या Sandbox API Key से मेल नहीं खाती।
ग्राहक को The MB WAY payment could not be started दिखता है: जाँचें कि फ़ोन नंबर MB WAY से जुड़ा है, फिर दोबारा प्रयास करें।
भुगतान के बाद ऑर्डर On hold पर है: ऑर्डर नोट पढ़ें। राशि या मुद्रा अलग थी, reference अज्ञात था, या भुगतान ऑर्डर रद्द होने के बाद आया। Eupago backoffice में भुगतान सत्यापित करें, फिर ऑर्डर पूरा करें या ग्राहक को रिफ़ंड करें।
लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक का संदेश देखें और उसके अनुसार चलें। उदाहरण के लिए, यदि कुंजी किसी दूसरे डोमेन पर पहले से उपयोग में है, तो अपने vibefox.net खाते में स्लॉट मुक्त करें और Check now पर क्लिक करें। यदि साइट का पता बदला है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक नहीं पहुँचा जा सकता, तो प्लगइन अंतिम ज्ञात स्थिति पर काम करता रहता है।
डेवलपर्स के लिए, प्लगइन दस्तावेज़ में फ़िल्टर eupago_p_icon (चेकआउट आइकन) और eupago_p_card_language (Eupago कार्ड पेज की भाषा: PT, EN या ES) सूचीबद्ध हैं।
अनइंस्टॉल
प्लगइन को निष्क्रिय करने पर सारा डेटा सुरक्षित रहता है। इसे हटाने के लिए, Plugins पेज पर निष्क्रिय करके हटाएँ। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती है। गेटवे सेटिंग्स और लॉग केवल तभी हटते हैं जब Delete Data on Uninstall चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए रहते हैं। ऑर्डर और उनके Eupago reference हमेशा सुरक्षित रहते हैं। मौजूदा ऑर्डर अपने भुगतान नोट और transaction ID रखते हैं।
Eupago उसके संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन Eupago से संबद्ध नहीं है और Eupago द्वारा समर्थित नहीं है।