VibeFox Eupago for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

PHP: 8.0 या उसके बाद का संस्करण। मॉड्यूल पुराने PHP संस्करणों पर इंस्टॉल नहीं होगा।

मुद्रा: यूरो (EUR)। Eupago केवल यूरो में शुल्क लेता है, इसलिए अन्य मुद्राओं वाले कार्ट के लिए चेकआउट पर यह भुगतान विधि छिपी रहती है।

Eupago खाता: आपको अपने Eupago channel की API कुंजी और उस Webhook 2.0 की कुंजी चाहिए जिसे आप Eupago backoffice में बनाते हैं (देखें Configuration)। Live backoffice clientes.eupago.pt है, sandbox backoffice sandbox.eupago.pt है। Sandbox और live अलग खाते हैं जिनकी कुंजियाँ भी अलग होती हैं।

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

इंस्टॉलेशन

1. Back office में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।

2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox Eupago Gateway खोजकर Configure पर क्लिक करें।

3. Configure पेज के ऊपर वाले लाइसेंस ब्लॉक में License key के अंतर्गत अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।

4. अपने Eupago channel की API कुंजी दर्ज करें, Eupago backoffice में एक Webhook 2.0 बनाएँ और उसकी कुंजी चिपकाएँ (देखें Configuration)।

5. Payment Method चुनें, Enable/Disable चालू करें और Save पर क्लिक करें। Sandbox मोड में एक परीक्षण ऑर्डर दें, फिर Sandbox Mode बंद करें।

इंस्टॉल होने पर मॉड्यूल दो ऑर्डर स्टेटस बनाता है: Awaiting Eupago payment और Eupago payment on hold। PrestaShop सभी मुद्राओं, देशों और ग्राहक समूहों के लिए एक नई भुगतान मॉड्यूल की पेशकश करता है। इन्हें आप Payment > Preferences में सीमित कर सकते हैं; यूरो मॉड्यूल के लिए अनुमति में बना रहना चाहिए।

Configuration

सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox Eupago Gateway > Configure। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सेव करता है। जब भुगतान विधि चालू होती है और मौजूदा मोड की API कुंजी खाली होती है, तो पेज फ़ील्ड्स के ऊपर चेतावनी देता है (तब भुगतान विधि चेकआउट पर छिपी रहती है), या जब तक sandbox मोड चालू है, तब तक Sandbox mode: no real payments are taken. दिखाता है।

Eupago

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

Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखते हैं। ऑर्डर में भी यही भुगतान विधि नाम सेव होता है। डिफ़ॉल्ट: Eupago। आवश्यक: खाली शीर्षक पर Enter a title for the payment method. दिखता है।

Description: चेकआउट पर भुगतान विधि के नीचे दिखाया जाने वाला पाठ। डिफ़ॉल्ट: Pay securely via Eupago.

Payment Method: चेकआउट पर दी जाने वाली एकमात्र Eupago विधि।

Order Status After Payment: भुगतान की पुष्टि होने पर सेट होने वाला ऑर्डर स्टेटस।

Eupago खाता

Eupago backoffice में अपने channel की API कुंजी और Webhook 2.0 कुंजी प्राप्त करें: clientes.eupago.pt (live) या sandbox.eupago.pt (sandbox)। Sandbox और live अलग खाते हैं जिनकी कुंजियाँ अलग होती हैं।

Sandbox Mode: sandbox.eupago.pt और sandbox कुंजियों का उपयोग करता है। कोई वास्तविक भुगतान नहीं लिया जाता। डिफ़ॉल्ट: चालू। Live कुंजियों से वास्तविक भुगतान लेने के लिए इसे बंद करें। चालू रहने पर ग्राहक भुगतान विधि के नीचे SANDBOX / TEST MODE देखते हैं।

Live API Key: आपके live Eupago channel की API कुंजी (clientes.eupago.pt)।

Live Webhook Key: आपके live Webhook 2.0 की एन्क्रिप्शन कुंजी। आवश्यक: बिना मान्य हस्ताक्षर की सूचनाएँ अस्वीकार की जाती हैं।

Sandbox API Key: आपके sandbox channel की API कुंजी (sandbox.eupago.pt)।

Sandbox Webhook Key: आपके sandbox Webhook 2.0 की एन्क्रिप्शन कुंजी।

सेव की गई कुंजियाँ फिर कभी नहीं दिखाई जातीं। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलना हो तो ही नया मान दर्ज करें।

Clear saved keys: किसी कुंजी पर टिक लगाएँ और उसे हटाने के लिए Save पर क्लिक करें। खाली फ़ील्ड सेव किया हुआ मान बनाए रखता है।

Webhook URL

Webhook आपके स्टोर को बताता है कि भुगतान हो चुका है। Eupago backoffice में इस सेक्शन में दिखाए गए URL, POST मेथड और चालू एन्क्रिप्शन के साथ एक Webhook 2.0 बनाएँ। Friendly URLs के साथ यह इस तरह दिखता है: https://your-shop/module/wcp_eupago_gateway/webhook, संभवतः /pt/ जैसे भाषा कोड के साथ। URL को ठीक वैसे ही कॉपी करें जैसे सेटिंग्स उसे दिखाती हैं। Sandbox backoffice में एक webhook और live backoffice में दूसरा webhook बनाएँ।

हर webhook की कुंजी को Sandbox Webhook Key या Live Webhook Key में कॉपी करें। बिना मान्य हस्ताक्षर वाले webhooks अस्वीकार किए जाते हैं। बिना एन्क्रिप्शन वाला webhook केवल तभी स्वीकार होता है जब Eupago उस पर हस्ताक्षर करे, इसलिए एन्क्रिप्शन चालू रखें। सूचना पर उसी मोड की कुंजी से हस्ताक्षर होना चाहिए जिसमें भुगतान शुरू हुआ था, इसलिए sandbox सूचना कभी live भुगतान नहीं करती। मॉड्यूल इन सूचना स्टेटस पर प्रतिक्रिया देता है:

अन्य स्टेटस में कोई कार्रवाई आवश्यक नहीं है। उसी URL पर Eupago का legacy GET callback भी स्वीकार होता है; यह API कुंजी से प्रमाणित होता है और हमेशा एक भुगतान की सूचना देता है। सूचनाओं के बिना ऑर्डर कभी भुगतान किए हुए चिह्नित नहीं होते: मॉड्यूल Eupago से पोल नहीं करता, और ग्राहक की वापसी से कोई ऑर्डर भुगतान नहीं होता। Webhook स्टोर के maintenance मोड में भी काम करता है और आपके स्टोर की देश सीमा से अवरुद्ध नहीं होता।

Advanced

Debug Log: API कॉल और सूचनाएँ मॉड्यूल फ़ोल्डर में logs/eupago_p_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खोली जा सकती। कुंजियाँ, ईमेल और पूरे फ़ोन नंबर लॉग नहीं होते। त्रुटियाँ हमेशा लॉग होती हैं। डिफ़ॉल्ट: बंद।

Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।

Delete Data on Uninstall: चालू होने पर मॉड्यूल अनइंस्टॉल करने से गेटवे सेटिंग्स, इस मॉड्यूल के Eupago भुगतान रिकॉर्ड और लॉग हट जाते हैं। ऑर्डर और उनका भुगतान डेटा सुरक्षित रहते हैं। डिफ़ॉल्ट: बंद।

चेकआउट

ग्राहक भुगतान चरण पर भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Eupago) और ऑर्डर देता है। इसके बाद क्या होता है, वह Payment Method पर निर्भर करता है।

Multibanco: चेकआउट पर ग्राहक को You will receive Multibanco payment details after placing the order. दिखता है। मॉड्यूल कार्ट योग के लिए Multibanco reference बनाता है। ऑर्डर तुरंत Awaiting Eupago payment में बनता है, जैसे कोई भी PrestaShop ऑर्डर बनता है, और कार्ट खाली हो जाता है। ऑर्डर कन्फ़र्मेशन पेज पर 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 ऐप को भेजता है और ऑर्डर Awaiting Eupago payment में बनाता है। ऑर्डर कन्फ़र्मेशन पेज ग्राहक से कहता है कि वह मास्क किए गए फ़ोन नंबर वाले MB WAY ऐप को खोले और 5 मिनट के भीतर अनुरोध स्वीकृत करे।

Credit Card: चेकआउट पर ग्राहक को You will be redirected to a secure payment page to enter your card details. दिखता है। ग्राहक को Eupago के कार्ड पेज पर भेजा जाता है, जो कार्ट की भाषा के अनुसार पुर्तगाली, स्पेनिश या अंग्रेज़ी में होता है। अभी कोई ऑर्डर नहीं है, और कार्ट सुरक्षित रहता है। ऑर्डर तभी बनता है जब Eupago भुगतान की पुष्टि करता है। अगर ग्राहक के लौटने तक सूचना आ चुकी है, तो उसे मानक ऑर्डर कन्फ़र्मेशन पेज दिखता है। अन्यथा Payment confirmation पेज पर Your card payment is being confirmed by Eupago. You will receive an e-mail as soon as it is confirmed. और Check again बटन दिखता है। अगर कार्ड भुगतान विफल हो जाए या छोड़ दिया जाए, तो ग्राहक 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 सत्यापित सूचना से भुगतान की पुष्टि करे। भुगतान विवरण केवल तब दिखते हैं जब ऑर्डर Awaiting Eupago payment में हो। अगर Eupago बाद में बताए कि भुगतान रद्द, समाप्त या विफल हो गया, और ऑर्डर भुगतान नहीं हुआ था, तो ऑर्डर कन्फ़र्मेशन पेज पर Your Eupago payment was not completed. Please contact us about this order. दिखता है।

अगर Eupago भुगतान शुरू नहीं कर पाता, तो ग्राहक चेकआउट पर एक छोटे संदेश के साथ रहता है, जैसे The payment could not be started because Eupago is temporarily unavailable. Please try again in a few minutes or choose another payment method. कोई ऑर्डर नहीं बनता, और विवरण लॉग में होते हैं। किसी अन्य मुद्रा के कार्ट पर Eupago only supports payments in EUR. दिखता है।

मॉड्यूल प्रति इंस्टॉलेशन एक Eupago विधि देता है। इसमें PrestaShop से रिफ़ंड, सेव किए गए कार्ड, सब्सक्रिप्शन या प्री-ऑथराइज़ेशन नहीं हैं; PayShop, Cofidis Pay, Bizum या अन्य Eupago विधियाँ नहीं हैं; SMS रिमाइंडर, Multibanco की समाप्ति तिथि और स्टेटस पोलिंग नहीं है।

ऑर्डर

ऑर्डर स्टेटस

No order yet: कार्ड भुगतान शुरू हुआ था और Eupago ने उसकी पुष्टि अभी नहीं की है। केवल कार्ट मौजूद है।

Awaiting Eupago payment: एक Multibanco reference या MB WAY अनुरोध बना है। नोट में entity और reference, या मास्क किया हुआ फ़ोन नंबर दिखता है।

Payment accepted or Delivered: भुगतान की पुष्टि हो गई है। स्टेटस Order Status After Payment का अनुसरण करता है। भुगतान को Eupago ट्रांज़ैक्शन ID के साथ ट्रांज़ैक्शन ID के रूप में दर्ज किया जाता है, और नोट में विधि, ट्रांज़ैक्शन ID और reference दिखते हैं।

Eupago payment on hold: Eupago ने ऐसा भुगतान बताया है जिसकी राशि या मुद्रा अलग है, जिसका reference इस कार्ट के लिए नहीं बना था, या ऐसे ऑर्डर के लिए जो इस बीच रद्द या विफल हो चुका था (जैसे देर से भुगतान हुआ Multibanco reference)। नोट इसकी व्याख्या करता है। भुगतान और स्टॉक की जाँच करें, फिर ऑर्डर मैन्युअली पूरा करें या ग्राहक को रिफ़ंड दें। इस भुगतान की बाद की सूचनाएँ आपकी जानकारी के बिना ऑर्डर पूरा नहीं करतीं।

Canceled: प्रतीक्षारत ऑर्डर के मौजूदा भुगतान प्रयास के लिए Eupago ने भुगतान रद्द या समाप्त होने की सूचना दी।

Payment error: प्रतीक्षारत ऑर्डर के मौजूदा भुगतान प्रयास के लिए Eupago ने त्रुटि की सूचना दी।

अगर Eupago पहले से भुगतान किए गए ऑर्डर के लिए कोई और भुगतान बताए (जैसे कोई पुराना Multibanco reference भी भुगतान हो गया), तो ऑर्डर नहीं बदलता। एक नोट आपसे डुप्लिकेट भुगतान की जाँच करने और उसे Eupago backoffice में रिफ़ंड करने के लिए कहता है। भुगतान की सूचना कभी ऐसे ऑर्डर को फिर से नहीं खोलती जो भुगतान होने के बाद रद्द या रिफ़ंड हो चुका हो।

Eupago भुगतान ब्लॉक

ऑर्डर पेज पर Eupago payment ब्लॉक दिखता है, जिसमें कार्ट के हर भुगतान प्रयास का विवरण होता है: तारीख, विधि, sandbox भुगतानों के लिए Sandbox बैज, राशि, Multibanco entity और reference या MB WAY का मास्क किया हुआ फ़ोन, Eupago ट्रांज़ैक्शन ID और स्टेटस। जब ऑर्डर Eupago payment on hold में होता है, तब ब्लॉक Manual review चेतावनी दिखाता है। उसके नीचे Eupago notes में ऑर्डर पर मॉड्यूल के नोट सबसे नए पहले सूचीबद्ध होते हैं।

रिफ़ंड

PrestaShop से रिफ़ंड समर्थित नहीं हैं। Eupago backoffice में ग्राहक को रिफ़ंड करें और PrestaShop में ऑर्डर को मैन्युअली अपडेट करें। ऑर्डर पेज पर मानक PrestaShop रिफ़ंड बटन Eupago के माध्यम से पैसा वापस नहीं भेजते।

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

मॉड्यूल vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Eupago Gateway, Modules > Module Manager > VibeFox Eupago Gateway > Configure पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक में कुंजी मास्क की हुई दिखती है, स्थिति (जैसे वह तारीख जब तक लाइसेंस सक्रिय है और आपका डोमेन), और ये बटन: स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। उनके नीचे Product: presta-payment-eupago वाली पंक्ति और Manage licenses and domains in your account लिंक है, जो आपका vibefox.net खाता खोलता है। केवल मॉड्यूल के Configure अधिकार वाले कर्मचारी ही कुंजी बदल सकते हैं। ब्लॉक के टेक्स्ट बैक ऑफ़िस की भाषा के अनुसार दिखते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

अगर कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, जैसे Key not found, This key belongs to another product, Domain limit reached या License expired on और एक तारीख। स्टोर का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। अगर लाइसेंस सर्वर तक नहीं पहुँचा जा सकता, तो मॉड्यूल अंतिम ज्ञात स्थिति के आधार पर काम करता रहता है।

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

सक्रिय कुंजी के बिना चेकआउट पर ग्राहकों को Eupago नहीं दिखाया जाता। अगर फिर भी भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। PrestaShop स्टोरफ़्रंट नहीं जानता कि आप बैक ऑफ़िस में लॉग इन हैं, इसलिए भुगतान विधि आपके लिए भी छिपी रहती है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, लेकिन चेकआउट पर उसे परख नहीं सकते। Modules > Module Manager में Alerts टैब पर एक रिमाइंडर दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: पहले से शुरू हुए भुगतान अब भी पुष्टि किए जाते हैं।

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

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

चेकआउट पर Eupago दिखाई नहीं देता: जाँच करें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और मौजूदा मोड की API कुंजी सेट है (sandbox मोड में Sandbox API Key, live मोड में Live API Key)। कार्ट की मुद्रा EUR होनी चाहिए, और Payment > Preferences में मॉड्यूल यूरो, ग्राहक के देश और ग्राहक के समूह के लिए अनुमत होना चाहिए। Multibanco के साथ ऑर्डर योग 1 € से 999,999.99 € के बीच होना चाहिए।

भुगतान हो गया, लेकिन ऑर्डर Awaiting Eupago payment पर रहता है या कोई ऑर्डर नहीं बना: Eupago की सूचना नहीं पहुँचती या अस्वीकार हो जाती है। जिस मोड का आप उपयोग कर रहे हैं, उसके Eupago backoffice में जाँचें कि Webhook 2.0 मौजूद है, उसका URL Webhook URL में दिखाए गए URL के बिल्कुल समान है, मेथड POST है और एन्क्रिप्शन चालू है। जाँचें कि उसकी कुंजी सही फ़ील्ड (Sandbox Webhook Key या Live Webhook Key) में है। Debug Log चालू करें और मॉड्यूल पेज पर Log फ़ील्ड देखें। अगर सूचना कभी नहीं पहुँचती, तो 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 सूचना कभी live भुगतान नहीं करती, और इसका उल्टा भी सही है। जाँचें कि sandbox और live कुंजियाँ आपस में बदली तो नहीं गईं।

Webhook का उत्तर Order not found है: सूचना ऐसे कार्ट के लिए है जिसका इस स्टोर का कोई Eupago भुगतान नहीं है, उदाहरण के लिए उसी Eupago channel से किसी दूसरे स्टोर पर हुआ भुगतान।

Webhook का उत्तर Busy or Retry है: उसी समय कार्ट किसी दूसरे अनुरोध द्वारा प्रोसेस हो रहा था, या ऑर्डर नहीं बन सका (उदाहरण के लिए, मॉड्यूल अक्षम है)। Eupago सूचना फिर से भेजता है। कारण लॉग में है।

Legacy callback का उत्तर Invalid API key है: Eupago द्वारा भेजी गई API कुंजी Live API Key या Sandbox API Key से मेल नहीं खाती। अगर आप webhook URL ब्राउज़र में खोलते हैं, तो भी यही उत्तर दिखता है; यह सामान्य है।

ग्राहक को The MB WAY payment could not be started दिखता है: जाँचें कि फ़ोन नंबर MB WAY से जुड़ा है, और फिर से प्रयास करें।

भुगतान के बाद ऑर्डर Eupago payment on hold में है: Eupago payment ब्लॉक में Eupago notes पढ़ें। राशि या मुद्रा अलग थी, reference अज्ञात था, या भुगतान ऑर्डर रद्द होने के बाद आया। Eupago backoffice में भुगतान सत्यापित करें, फिर ऑर्डर पूरा करें या ग्राहक को रिफ़ंड दें।

अनइंस्टॉल

Modules > Module Manager पर जाएँ, VibeFox Eupago Gateway के बगल वाला मेन्यू खोलें और Uninstall चुनें। इस मॉड्यूल की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती हैं। अगर Delete Data on Uninstall चालू है, तो गेटवे सेटिंग्स, इस मॉड्यूल के Eupago भुगतान रिकॉर्ड और लॉग हटा दिए जाते हैं। अगर यह बंद है, तो बाद में फिर से इंस्टॉल करने के लिए सभी सेटिंग्स और रिकॉर्ड रखे जाते हैं। ऑर्डर स्टेटस Awaiting Eupago payment और Eupago payment on hold हमेशा रखे जाते हैं। मौजूदा ऑर्डर अपने भुगतान नोट और ट्रांज़ैक्शन ID बनाए रखते हैं।

Eupago उसके संबंधित स्वामी का ट्रेडमार्क है। यह मॉड्यूल Eupago से संबद्ध नहीं है और Eupago द्वारा समर्थित नहीं है।