VibeFox ifthenpay for PrestaShop — सहायता
आवश्यकताएँ
PrestaShop: 8.0 से 9.x।
PHP: 8.0 या उसके बाद का संस्करण। पुराने PHP संस्करणों पर मॉड्यूल इंस्टॉल नहीं होता।
मुद्रा: केवल यूरो (EUR)। जब कार्ट की मुद्रा EUR न हो, तब भुगतान विधि छिपा दी जाती है। ifthenpay 0.01 से 99,999.99 EUR तक की राशि स्वीकार करता है।
ifthenpay खाता: ifthenpay.com पर साइन अप करें। आपको उस विधि की कुंजी चाहिए जो आप देते हैं: Multibanco, MB WAY या Credit Card (प्रारूप ABC-123456)। कुंजियाँ ifthenpay बैकऑफ़िस (backoffice.ifthenpay.com) में दिखती हैं, या जब आपके खाते के लिए विधि सक्रिय होती है तब ifthenpay उन्हें भेजता है। आपकी कुंजी के लिए कॉलबैक ifthenpay को भी सक्रिय करना होगा (देखें कॉन्फ़िगरेशन), और आपका स्टोर इंटरनेट से पहुँच योग्य होना चाहिए।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक ही डोमेन पर काम करती है।
इंस्टॉलेशन
1. बैक ऑफिस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।
2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox ifthenpay Gateway ढूँढकर Configure पर क्लिक करें। मॉड्यूल इंस्टॉल होने पर अपनी एंटी-फ़िशिंग कुंजी बनाता है।
3. Configure पेज के ऊपर लाइसेंस ब्लॉक में License key फ़ील्ड में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें (लाइसेंस कुंजी देखें)।
4. Payment Method चुनें, उसकी ifthenpay कुंजी दर्ज करें और Save पर क्लिक करें, ताकि Callback URL चुनी गई विधि से मेल खाए।
5. सेटिंग्स में दिखाई गई Anti-phishing Key और Callback URL कॉपी करें और ifthenpay से अपनी कुंजी के लिए कॉलबैक सक्रिय करने को कहें (बैकऑफ़िस में या ifthenpay सपोर्ट के माध्यम से)।
6. Enable/Disable चालू करें और Save पर क्लिक करें।
इंस्टॉल होने पर मॉड्यूल दो ऑर्डर स्थितियाँ बनाता है: Awaiting ifthenpay payment और ifthenpay payment on hold। PrestaShop सभी मुद्राओं, देशों और ग्राहक समूहों के लिए एक नया भुगतान मॉड्यूल देता है। आप इन्हें Payment > Preferences में सीमित कर सकते हैं; EUR अनुमत रहना चाहिए।
कॉन्फ़िगरेशन
सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox ifthenpay Gateway > Configure। Save बटन वाला हर सेक्शन पूरा पेज सेव करता है। चुनी गई विधि की कुंजी के बिना चेकआउट पर भुगतान विधि नहीं दिखती। इस कुंजी के बिना गेटवे चालू होने पर पेज पर ifthenpay: enter the key of the selected payment method, otherwise the method is not shown at checkout. दिखता है।
ifthenpay
Enable/Disable: Enable ifthenpay Payment भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: off।
Title: चेकआउट पर दिखने वाला भुगतान विधि का शीर्षक। यही ऑर्डर में सेव होने वाला भुगतान विधि का नाम भी है। डिफ़ॉल्ट: ifthenpay।
Description: चेकआउट पर दिखने वाला भुगतान विधि का विवरण। डिफ़ॉल्ट: Pay via Multibanco, MB WAY or Credit Card। इसे अपनी दी गई विधि के अनुसार बदलें।
Payment Method: चेकआउट पर दी जाने वाली विधि। केवल इसी विधि की कुंजी आवश्यक है।
ifthenpay कुंजियाँ
कुंजियाँ (प्रारूप ABC-123456) ifthenpay बैकऑफ़िस में दिखती हैं, या जब आपके खाते के लिए भुगतान विधि सक्रिय होती है तब ifthenpay उन्हें भेजता है।
Multibanco Key: डायनामिक संदर्भों के लिए आपकी ifthenpay Multibanco (MB) कुंजी।
MB WAY Key: आपकी ifthenpay MB WAY कुंजी।
Credit Card Key: आपकी ifthenpay Credit Card कुंजी। यह कार्ड पेज से ग्राहक की वापसी के हस्ताक्षर की पुष्टि भी करती है।
सहेजी गई कुंजियाँ फिर कभी नहीं दिखतीं। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें।
Clear saved keys: किसी कुंजी पर टिक लगाकर उसे हटाने के लिए Save पर क्लिक करें। खाली फ़ील्ड सहेजे गए मान को बनाए रखता है।
Callback (भुगतान सूचनाएँ)
कॉलबैक आपके स्टोर को बताता है कि भुगतान हो गया है। आप जिस भी कुंजी का उपयोग करते हैं, उसके लिए ifthenpay से नीचे दी गई एंटी-फ़िशिंग कुंजी और कॉलबैक URL के साथ कॉलबैक सक्रिय करने को कहें। Multibanco और MB WAY ऑर्डर केवल कॉलबैक से पुष्ट होते हैं; कार्ड भुगतान कार्ड पेज की हस्ताक्षरित वापसी से भी पुष्ट होते हैं।
Anti-phishing Key: मॉड्यूल द्वारा बनाई जाती है और कॉपी करने के लिए दिखाई जाती है। ifthenpay इसे हर कॉलबैक में वापस भेजता है; इसके बिना आने वाले कॉलबैक अस्वीकार कर दिए जाते हैं।
Callback URL: चुनी गई भुगतान विधि का कॉलबैक URL, ifthenpay के प्लेसहोल्डर सहित, कॉपी करने के लिए दिखाया जाता है। फ़्रेंडली URL के साथ यह कुछ इस तरह शुरू होता है: https://your-shop/module/wcp_ifthenpay_gateway/callback, संभवतः /en/ जैसा भाषा कोड भी हो सकता है, और उसके बाद विधि के पैरामीटर आते हैं। पूरा URL ठीक वैसा ही कॉपी करें जैसा सेटिंग्स में दिखता है।
हर कॉलबैक की एंटी-फ़िशिंग कुंजी आपकी कुंजी से मिलाई जाती है। गायब या गलत कुंजी पर 403 उत्तर मिलता है और ऑर्डर नहीं बदलता। कॉलबैक को इस मॉड्यूल के किसी भुगतान से भी मेल खाना होगा: Multibanco के लिए एंटिटी और संदर्भ से, MB WAY के लिए कार्ट और उसके किसी MB WAY अनुरोध से, Credit Card के लिए कार्ट और उसके किसी कार्ड अनुरोध से। काम करने वाले कॉलबैक के बिना Multibanco और MB WAY ऑर्डर कभी पुष्ट नहीं होते, और कार्ड भुगतान केवल हस्ताक्षरित वापसी से पुष्ट होते हैं। कॉलबैक स्टोर के मेंटेनेंस मोड में भी काम करता है और आपके स्टोर के देश-प्रतिबंध से नहीं रुकता।
एडवांस्ड
Test Mode: Credit Card और Multibanco ifthenpay सैंडबॉक्स एंडपॉइंट्स का उपयोग करते हैं; कोई वास्तविक धन नहीं काटा जाता, और आप ifthenpay द्वारा दी गई टेस्ट कुंजियों का उपयोग करते हैं। MB WAY का कोई सैंडबॉक्स नहीं है: इसे ifthenpay की टेस्ट कुंजी से परखें। चेकआउट पर TEST MODE बैज दिखता है। डिफ़ॉल्ट: off।
Order Status After Payment: पुष्ट भुगतान के बाद सेट होने वाली ऑर्डर स्थिति, जिसमें एक ही स्थिति-बदलाव होता है।
Debug Log: API अनुरोध और कॉलबैक मॉड्यूल फ़ोल्डर में logs/ifthenpay_p_debug.log.php पर लिखे जाते हैं। यह फ़ाइल वेब से नहीं खोली जा सकती। त्रुटियाँ हमेशा दर्ज होती हैं। कुंजियाँ, एंटी-फ़िशिंग कुंजी और पूरे फ़ोन नंबर कभी दर्ज नहीं होते। डिफ़ॉल्ट: off।
Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।
Delete Data on Uninstall: चालू होने पर मॉड्यूल हटाने से मॉड्यूल सेटिंग्स, एंटी-फ़िशिंग कुंजी और लॉग हट जाते हैं। ऑर्डर और ifthenpay भुगतान रिकॉर्ड हमेशा बने रहते हैं। डिफ़ॉल्ट: off।
चेकआउट
Multibanco। चेकआउट पर ग्राहक को You will receive a Multibanco reference to complete the payment. दिखता है। जब ग्राहक पुष्टि करता है, तो मॉड्यूल कार्ट की कुल राशि के लिए एक डायनामिक Multibanco संदर्भ बनाता है, और ऑर्डर Awaiting ifthenpay payment में बनता है। ऑर्डर पुष्टि पेज पर Multibanco Payment Details दिखता है: एंटिटी, संदर्भ और राशि, साथ में Please use these details to pay at any Multibanco ATM or through your online banking. वही विवरण ऑर्डर पुष्टि ईमेल में भी जोड़े जाते हैं। जब ifthenpay भुगतान कॉलबैक भेजता है, तब ऑर्डर का भुगतान हो जाता है।
MB WAY। ग्राहक MB WAY phone number (912 345 678, +351 912 345 678, या अन्य देशों के लिए 351#912345678) दर्ज करता है; बिलिंग पते का फ़ोन अपने-आप भर जाता है। मॉड्यूल उस फ़ोन पर भुगतान अनुरोध भेजता है, और ऑर्डर Awaiting ifthenpay payment में बनता है। ऑर्डर पुष्टि पेज पर लिखा होता है: A payment request has been sent to your phone via MB WAY. Please confirm it in the MB WAY app. जब ifthenpay कॉलबैक भेजता है, तब ऑर्डर का भुगतान होता है। केवल मास्क किया गया फ़ोन नंबर सहेजा जाता है।
क्रेडिट कार्ड। ग्राहक को You will be redirected to a secure page to enter your card details. दिखता है और वह ifthenpay कार्ड पेज पर भेजा जाता है। अभी कोई ऑर्डर नहीं है, और कार्ट सुरक्षित रहता है। सफल भुगतान के बाद ग्राहक आपके स्टोर पर लौट आता है। वापसी केवल तब स्वीकार होती है जब मान्य ifthenpay हस्ताक्षर, कार्ट की सुरक्षित कुंजी, उस प्रयास का गुप्त मान और कार्ट का कार्ड अनुरोध मेल खाते हों; तब ऑर्डर भुगतान-किया हुआ बनता है और ग्राहक को मानक ऑर्डर पुष्टि पेज दिखता है। यदि वापसी सत्यापित नहीं हो सकती, तो कुछ नहीं बदलता, और Payment confirmation पेज पर Your card payment is being confirmed by ifthenpay. 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. के साथ चेकआउट पर लौट आता है। कार्ट के हर कार्ड प्रयास को सुरक्षित रखा जाता है, इसलिए पिछले टैब में किया गया भुगतान भी स्वीकार होता है।
ऑर्डर को भुगतान-किया हुआ तभी चिह्नित किया जाता है जब ifthenpay भुगतान की पुष्टि करे, और राशि ऑर्डर कुल से सेंट तक मिलाई जाती है। यदि भुगतान शुरू नहीं हो सकता, तो ग्राहक चेकआउट पर एक छोटे संदेश के साथ रहता है, उदाहरण के लिए The Multibanco reference could not be created. Please try again or choose another payment method., The MB WAY payment request could not be sent. Please check that the phone number is linked to MB WAY, or choose another payment method. या The payment service is temporarily unavailable. Please try again in a few minutes. तकनीकी कारण लॉग में लिखा जाता है।
मॉड्यूल एक समय में एक ही ifthenpay विधि देता है। इसमें Payshop, Cofidis Pay, Apple Pay, Google Pay, PIX या Pay-by-Link नहीं हैं, सब्सक्रिप्शन या सेव किए गए कार्ड नहीं हैं, बिना भुगतान वाले Multibanco संदर्भों की स्वचालित समाप्ति या रद्दीकरण नहीं है, और भुगतान स्थिति की पोलिंग भी नहीं है।
ऑर्डर
ऑर्डर स्थितियाँ
No order yet: कार्ड भुगतान शुरू हुआ था और अभी पुष्ट नहीं है, या विफल हुआ या रद्द हुआ। केवल कार्ट मौजूद है।
Awaiting ifthenpay payment: एक Multibanco संदर्भ जारी हुआ या MB WAY अनुरोध भेजा गया। ऑर्डर बनने पर PrestaShop स्टॉक घटाता है। बिना भुगतान वाले संदर्भ और अस्वीकृत MB WAY अनुरोध ऑर्डर को अपने-आप रद्द नहीं करते; ज़रूरत हो तो ऐसे ऑर्डर आप स्वयं रद्द करें।
Payment accepted or Delivered: भुगतान पुष्ट हो गया है। स्थिति Order Status After Payment का पालन करती है। भुगतान को Multibanco संदर्भ, MB WAY अनुरोध ID या कार्ड अनुरोध ID के साथ लेन-देन ID के रूप में दर्ज किया जाता है, और एक नोट बताता है कि उसकी पुष्टि कैसे हुई।
ifthenpay payment on hold: प्राप्त राशि ऑर्डर कुल से अलग थी (उदाहरण के लिए, कार्ड भुगतान शुरू होने के बाद कार्ट बदला गया), या ऑर्डर रद्द होने के बाद भुगतान आया। नोट इसे समझाता है, और ग्राहक से दोबारा भुगतान करने को नहीं कहा जाता। ifthenpay बैकऑफ़िस में भुगतान जाँचें और ऑर्डर को मैन्युअल रूप से पूरा करें या रिफ़ंड करें। ऐसे ऑर्डर पर बाद में आया सही भुगतान उसे नहीं बदलता।
पहले से भुगतान हो चुके ऑर्डर पर दूसरा भुगतान केवल एक नोट जोड़ता है, ताकि आप ifthenpay बैकऑफ़िस में डुप्लिकेट भुगतान जाँच सकें। रिफ़ंड किए गए ऑर्डर और भुगतान के बाद रद्द किए गए ऑर्डर कभी दोबारा नहीं खुलते।
ifthenpay भुगतान ब्लॉक
ऑर्डर पेज पर ifthenpay payment ब्लॉक दिखता है, जिसमें ऑर्डर के भुगतान प्रयास होते हैं (तिथि, विधि, टेस्ट भुगतानों के लिए Sandbox बैज, राशि, Multibanco एंटिटी और संदर्भ या मास्क किया गया MB WAY फ़ोन, ifthenpay अनुरोध ID और स्थिति), जब ऑर्डर ifthenpay payment on hold में हो तब Manual review चेतावनी, और ऑर्डर के ifthenpay notes।
रिफ़ंड
PrestaShop से रिफ़ंड समर्थित नहीं हैं। ifthenpay बैकऑफ़िस में भुगतान रिफ़ंड करें और PrestaShop में उसे मैन्युअल रूप से दर्ज करें। रिफ़ंड किया गया (DEVOLVIDO) कॉलबैक केवल एक नोट जोड़ता है। ifthenpay द्वारा बताई गई अन्य स्थितियाँ भी केवल एक नोट जोड़ती हैं।
लाइसेंस कुंजी
मॉड्यूल vibefox.net की VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox ifthenpay Gateway, Modules > Module Manager > VibeFox ifthenpay Gateway > Configure पर पहला ब्लॉक है, सेटिंग्स के ऊपर। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक कुंजी को मास्क करके दिखाता है, स्थिति (जैसे वह तारीख जब तक लाइसेंस सक्रिय है और आपका डोमेन) और ये बटन: Check now स्थिति दोबारा जाँचने के लिए, Change key दूसरी कुंजी दर्ज करने के लिए और Remove key इस स्टोर से कुंजी हटाने के लिए। उनके नीचे पंक्ति Product: presta-payment-ifthenpay और लिंक 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 खाते में मुक्त करें।
सक्रिय कुंजी के बिना चेकआउट पर ग्राहकों को ifthenpay नहीं दिखाया जाता। अगर फिर भी भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। PrestaShop स्टोरफ़्रंट नहीं जानता कि आप बैक ऑफ़िस में लॉग इन हैं, इसलिए भुगतान विधि आपसे भी छिपी रहती है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, लेकिन चेकआउट पर उसे परख नहीं सकते। Modules > Module Manager पर Alerts टैब में एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं, वे अब भी पुष्ट होते हैं।
लाइसेंस समाप्त होने पर मॉड्यूल काम करता रहता है, पर अपडेट और सपोर्ट के लिए नवीनीकरण चाहिए। बैक ऑफ़िस में काम करते समय स्थिति अपने-आप दोबारा जाँची जाती है: कुंजी दर्ज करने के बाद पहले 14 दिनों में रोज़ एक बार, फिर हर हफ़्ते एक बार। कोई cron जॉब ज़रूरी नहीं है। मॉड्यूल अनइंस्टॉल या रीसेट करने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हट जाती हैं।
समस्या निवारण
चेकआउट पर ifthenpay दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, चुनी गई Payment Method की कुंजी भरी है, कार्ट की मुद्रा EUR है, और कुल राशि 0.01 से 99,999.99 EUR के बीच है। Payment > Preferences में जाँचें कि मॉड्यूल EUR, ग्राहक के देश और ग्राहक के समूह के लिए अनुमत है।
ग्राहक ने भुगतान किया, लेकिन ऑर्डर Awaiting ifthenpay payment में रहता है या कोई ऑर्डर नहीं बना: कॉलबैक आपके स्टोर तक नहीं पहुँच रहा है। जाँचें कि ifthenpay ने आपकी कुंजी के लिए कॉलबैक URL और एंटी-फ़िशिंग कुंजी सक्रिय की है, और URL चुनी गई विधि का है। स्टोर इंटरनेट से पहुँच योग्य होना चाहिए, localhost पर नहीं और लॉगिन के पीछे नहीं। मॉड्यूल पेज के Log फ़ील्ड में Callback rejected वाली पंक्तियाँ खोजें।
कॉलबैक 403 Forbidden देता है: कॉलबैक में एंटी-फ़िशिंग कुंजी नहीं है या सेटिंग्स की कुंजी से अलग है। सेटिंग्स में दिखाई गई कुंजी ifthenpay को फिर से भेजें।
कॉलबैक 503 Not configured देता है: एंटी-फ़िशिंग कुंजी अभी तक नहीं बनी है। मॉड्यूल सेटिंग्स एक बार खोलें; ifthenpay कॉलबैक दोबारा आज़माएगा।
कॉलबैक 503 Busy देता है: उसी समय वही कार्ट किसी दूसरे अनुरोध से प्रोसेस हो रहा था। ifthenpay कॉलबैक दोबारा आज़माएगा।
कॉलबैक Order not found देता है: संदर्भ या अनुरोध इस मॉड्यूल के किसी भुगतान का नहीं है, या कार्ट किसी दूसरी भुगतान विधि से ऑर्डर किया गया था।
भुगतान किया हुआ ऑर्डर होल्ड पर क्यों गया? प्राप्त राशि ऑर्डर कुल से अलग थी, या ऑर्डर रद्द होने के बाद भुगतान आया। ifthenpay payment ब्लॉक के नोट पढ़ें, ifthenpay बैकऑफ़िस में भुगतान जाँचें और ऑर्डर को मैन्युअल रूप से पूरा करें या रिफ़ंड करें।
MB WAY अनुरोध नहीं भेजा जा सका: फ़ोन नंबर MB WAY से जुड़ा नहीं है या प्रारूप गलत है। 912 345 678 का उपयोग करें, या अन्य देशों के नंबरों के लिए 351#912345678 का।
टेस्ट मोड और MB WAY: ifthenpay के पास MB WAY सैंडबॉक्स नहीं है; ifthenpay द्वारा दी गई टेस्ट कुंजी का उपयोग करें।
अनइंस्टॉल
Modules > Module Manager पर जाएँ, VibeFox ifthenpay Gateway के बगल वाला मेनू खोलें और Uninstall चुनें। इस मॉड्यूल की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती हैं। यदि Delete Data on Uninstall चालू है, तो मॉड्यूल सेटिंग्स, एंटी-फ़िशिंग कुंजी और लॉग हट जाते हैं; दोबारा इंस्टॉल करने पर नई एंटी-फ़िशिंग कुंजी बनती है, जिसे फिर से ifthenpay को भेजना होगा। यदि यह बंद है, तो बाद में दोबारा इंस्टॉल करने के लिए सारी सेटिंग्स रखी जाती हैं। ifthenpay भुगतान रिकॉर्ड (संदर्भ और अनुरोध ID) और ऑर्डर स्थितियाँ Awaiting ifthenpay payment तथा ifthenpay payment on hold हमेशा रखी जाती हैं, ताकि पहले जारी संदर्भों के कॉलबैक दोबारा इंस्टॉल होने के बाद भी अपने ऑर्डर ढूँढ सकें। मौजूदा ऑर्डर अपने भुगतान नोट और लेन-देन ID रखते हैं।
ifthenpay उसके संबंधित स्वामी का ट्रेडमार्क है। यह मॉड्यूल ifthenpay से संबद्ध नहीं है और उसके द्वारा अनुमोदित नहीं है।