VibeFox PayPlug for PrestaShop — सहायता
आवश्यकताएँ
PrestaShop: 8.0 से 9.x।
PHP: 8.0 या बाद का संस्करण। मॉड्यूल पुराने PHP संस्करणों पर इंस्टॉल होने से मना कर देता है।
मुद्रा और राशियाँ: यूरो (EUR), प्रति भुगतान 0.99 से 20,000.00, जो PayPlug की डिफ़ॉल्ट सीमाएँ हैं। कार्ट की अलग मुद्रा होने पर या इन सीमाओं से बाहर होने पर भुगतान विधि छिप जाती है।
PayPlug खाता: आपको अपने PayPlug खाते की सीक्रेट की चाहिए: टेस्ट की (sk_test_...) और/या लाइव की (sk_live_...)। कोई और कुंजी आवश्यक नहीं है, और PayPlug में कोई सूचना सेट करनी नहीं होती। सूचनाएँ प्राप्त करने के लिए आपका स्टोर इंटरनेट से पहुँचने योग्य होना चाहिए; अन्यथा ग्राहक के PayPlug से लौटने पर ऑर्डर बनते हैं।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. बैक ऑफिस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।
2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox PayPlug Gateway खोजकर Configure पर क्लिक करें।
3. Configure पेज के ऊपर वाले लाइसेंस ब्लॉक में License key फ़ील्ड में अपनी VibeFox लाइसेंस कुंजी चिपकाएँ और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।
4. PayPlug पोर्टल से अपनी सीक्रेट की चिपकाएँ (देखें कॉन्फ़िगरेशन)।
5. Enable/Disable चालू करें और Save पर क्लिक करें। Test Mode चालू रखकर एक भुगतान का परीक्षण करें, फिर असली भुगतान स्वीकार करने के लिए उसे बंद कर दें।
इंस्टॉल होने पर मॉड्यूल ऑर्डर स्टेटस PayPlug payment on hold बनाता है। PrestaShop सभी मुद्राओं, देशों और ग्राहक समूहों के लिए नया भुगतान मॉड्यूल सक्षम करता है। आप इन्हें Payment > Preferences में सीमित कर सकते हैं।
कॉन्फ़िगरेशन
सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox PayPlug Gateway > Configure। हर सेक्शन का अपना Save बटन है, जो पूरे पेज को सहेजता है। फ़ील्ड्स के ऊपर पेज चेतावनी देता है जब भुगतान विधि सक्षम हो पर वर्तमान मोड की सीक्रेट की खाली हो, और जब स्टोर की डिफ़ॉल्ट मुद्रा EUR न हो। दोनों ही स्थितियों में चेकआउट पर भुगतान विधि छिपा दी जाती है।
चेकआउट
Enable/Disable: Enable PayPlug Gateway भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: off।
Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखता है। यही नाम ऑर्डर में भुगतान विधि के रूप में सहेजा जाता है। डिफ़ॉल्ट: PayPlug। अनिवार्य।
Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला टेक्स्ट। डिफ़ॉल्ट: Pay securely by card via PayPlug।
API कुंजियाँ
अपनी सीक्रेट की PayPlug पोर्टल में Developers > API keys के अंतर्गत मिलेंगी। इस सेक्शन में पोर्टल का लिंक है।
Test Mode: नए भुगतानों के लिए टेस्ट सीक्रेट की का उपयोग करता है। कोई असली भुगतान संसाधित नहीं होता। दूसरे मोड में किए गए भुगतान स्टेटस जाँच और रिफ़ंड के लिए अपने मोड की की का उपयोग जारी रखते हैं। डिफ़ॉल्ट: on। चालू रहने पर ग्राहकों को भुगतान विधि के नीचे Test mode: no real payment will be made. दिखता है।
Test Secret Key: आपकी PayPlug टेस्ट सीक्रेट की। यह sk_test_ से शुरू होती है।
Live Secret Key: आपकी PayPlug लाइव सीक्रेट की। यह sk_live_ से शुरू होती है।
गलत प्रीफ़िक्स वाली कुंजी सहेजी नहीं जाती। पेज उदाहरण के लिए Test Secret Key must start with "sk_test_". The previous value was kept. दिखाता है। सहेजी गई कुंजियाँ फिर कभी नहीं दिखतीं। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। नया मान केवल तभी दर्ज करें जब उसे बदलना हो।
Clear saved keys: किसी कुंजी पर टिक लगाकर उसे हटाने के लिए Save पर क्लिक करें। खाली फ़ील्ड सहेजे गए मान को रखता है।
Notification URL: वह पता जिसे मॉड्यूल हर भुगतान के साथ PayPlug को भेजता है। फ़्रेंडली URL के साथ यह ऐसा दिखता है: https://your-shop/module/wcp_payplug_gateway/webhook। PayPlug पोर्टल में कुछ भी दर्ज करने की आवश्यकता नहीं है। यह URL इंटरनेट से पहुँचने योग्य होना चाहिए; अन्यथा ग्राहक के PayPlug से लौटने पर ऑर्डर बनते हैं।
ऑर्डर
Order Status After Payment: सफल भुगतान के बाद सेट होने वाला ऑर्डर स्टेटस। स्टेटस तुरंत सेट होता है, दूसरे स्टेटस बदलाव की ज़रूरत नहीं।
एडवांस्ड
Logging: API कॉल और सूचनाएँ मॉड्यूल फ़ोल्डर में logs/ppg_debug.log.php में दर्ज करता है। यह फ़ाइल वेब से नहीं खुल सकती। त्रुटियाँ और चेतावनियाँ हमेशा दर्ज होती हैं। सीक्रेट की, कार्ड डेटा और ग्राहक डेटा कभी दर्ज नहीं होते। डिफ़ॉल्ट: off।
Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।
Delete Data on Uninstall: चालू होने पर मॉड्यूल अनइंस्टॉल होने पर उसकी सेटिंग्स और लॉग हटा दिए जाते हैं। ऑर्डर के साथ सहेजे गए PayPlug भुगतान ID और ऑर्डर स्टेटस PayPlug payment on hold बने रहते हैं। डिफ़ॉल्ट: off।
चेकआउट
भुगतान चरण में ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से PayPlug लोगो के साथ PayPlug)। टेस्ट मोड में इस विकल्प पर Test mode: no real payment will be made. दिखता है। पुष्टि होने पर मॉड्यूल कार्ट की कुल राशि के लिए सेंट में एक PayPlug भुगतान बनाता है और ग्राहक को PayPlug भुगतान पेज पर भेजता है। बिलिंग और डिलीवरी पते, ईमेल और कार्ट की भाषा PayPlug को भेजी जाती हैं। वहाँ ग्राहक कार्ड से भुगतान करता है। इस बिंदु पर अभी कोई ऑर्डर नहीं होता।
भुगतान के बाद ग्राहक आपके स्टोर पर लौट आता है। PayPlug की पुष्टि के बाद ही ऑर्डर भुगतान किया हुआ चिह्नित होता है: मॉड्यूल सूचना आने पर और ग्राहक के लौटने पर PayPlug API से भुगतान पढ़ता है। फिर ऑर्डर बनता है और ग्राहक को मानक ऑर्डर पुष्टि पेज दिखता है, जिस पर Your payment with PayPlug has been received. लिखा होता है। यदि ऑर्डर होल्ड पर है, तो पेज पर We are confirming your payment with PayPlug. The order will be updated automatically — please do not pay again. लिखा होता है। यदि ऑर्डर Payment error में है या बिना भुगतान के रद्द हो गया है, तो पेज पर Your PayPlug payment was not completed. Please contact us about this order. लिखा होता है। यदि ग्राहक के लौटने पर PayPlug से पूछा नहीं जा सका, तो Payment confirmation पेज पर वही "we are confirming" टेक्स्ट और Check again बटन दिखता है; सूचना आते ही ऑर्डर बन जाता है।
यदि ग्राहक PayPlug पेज पर रद्द करता है, तो भुगतान पेज PayPlug पर बंद हो जाता है, ताकि उसे बाद में गलती से न चुकाया जा सके। ग्राहक चेकआउट पर लौटकर एक संदेश देखता है: You cancelled the PayPlug payment. You can try again or choose another payment method., The PayPlug payment session has expired. Please try again or choose another payment method., The PayPlug payment failed. Please try again or choose another payment method. या, यदि भुगतान खुला रह गया था, तो Your PayPlug payment was not completed. You can try again or choose another payment method. कार्ट सुरक्षित रहता है।
जब ग्राहक वही कार्ट दोबारा चुकाता है, तो मॉड्यूल पहले पिछले प्रयास को देखता है। यदि वह इस बीच चुका दिया गया है, तो बिना नए भुगतान के ऑर्डर बनता है। यदि वह उसी राशि के लिए अब भी खुला है, तो वही भुगतान पेज दोबारा उपयोग होता है। नहीं तो पुराना पेज PayPlug पर बंद कर दिया जाता है और नया भुगतान बनता है।
यदि PayPlug भुगतान शुरू नहीं कर पाता, तो ग्राहक चेकआउट पर रहता है और एक छोटा संदेश देखता है, उदाहरण के लिए PayPlug could not accept your billing details (postcode). Please check them and try again. या The payment provider could not be reached. Please try again in a moment. तकनीकी कारण लॉग में लिखा जाता है।
स्टोर के मेंटेनेंस मोड में होने पर भी सूचना काम करती है, और स्टोर के देश-प्रतिबंध से उसे रोका नहीं जाता।
भुगतान तुरंत कैप्चर होते हैं। इस मॉड्यूल में Oney इंस्टॉलमेंट, वन-क्लिक सेव्ड कार्ड, एम्बेडेड भुगतान फ़ॉर्म, सब्सक्रिप्शन और डिफ़र्ड कैप्चर नहीं हैं।
ऑर्डर और रिफ़ंड
ऑर्डर स्टेटस
No order yet: ग्राहक को PayPlug पर भेजा गया और उसने भुगतान नहीं किया, या PayPlug ने अभी भुगतान की पुष्टि नहीं की है। केवल कार्ट मौजूद है।
Payment accepted or Delivered: भुगतान की पुष्टि हो गई है। स्टेटस Order Status After Payment का पालन करता है। भुगतान PayPlug भुगतान ID (pay_...) के साथ ट्रांज़ैक्शन ID के रूप में दर्ज होता है, और एक नोट PayPlug भुगतान और उसका मोड दिखाता है।
PayPlug payment on hold: भुगतान की गई राशि या मुद्रा कार्ट से अलग है (नोट amount/currency mismatch, उदाहरण के लिए भुगतान शुरू होने के बाद कार्ट बदला गया); या स्टोर लाइव मोड में होने पर टेस्ट भुगतान किया गया, इसलिए कोई पैसा नहीं मिला और कोई भुगतान दर्ज नहीं होता; या रद्द किए गए ऑर्डर के लिए भुगतान आया; या भुगतान अधिकृत है पर कैप्चर नहीं हुआ (PayPlug पोर्टल में कैप्चर करें; PayPlug के भुगतान को पूरा बताने पर ऑर्डर भुगतान किया हुआ चिह्नित होता है)। नोट बताता है कि क्या जाँचना है।
Payment error: होल्ड ऑर्डर का अधिकृत भुगतान विफल हुआ या रद्द हो गया।
Refunded: भुगतान मॉड्यूल के ज़रिए पूरी तरह रिफ़ंड किया गया।
यदि पहले से भुगतान किए गए कार्ट का दूसरा प्रयास भी चुका दिया गया है, तो ऑर्डर नहीं बदलता। एक नोट आपसे PayPlug पोर्टल में डुप्लिकेट भुगतान रिफ़ंड करने को कहता है। भुगतान किया, रद्द या रिफ़ंड किया गया ऑर्डर बाद की सूचना से फिर कभी नहीं खुलता।
PayPlug भुगतान ब्लॉक
ऑर्डर पेज पर PayPlug payment ब्लॉक दिखता है, जिसमें PayPlug भुगतान ID, भुगतान स्टेटस, भुगतान की गई और रिफ़ंड की गई राशि, टेस्ट भुगतानों के लिए Test mode बैज, रिफ़ंड इतिहास और ऑर्डर के PayPlug notes होते हैं।
रिफ़ंड
PayPlug payment ब्लॉक में राशि दर्ज करें (जो राशि अभी रिफ़ंड नहीं हुई है, वह पहले से भरी होती है), वैकल्पिक रूप से कारण लिखें, और Refund via PayPlug पर क्लिक करें। प्रश्न Refund this amount through PayPlug? This cannot be undone. की पुष्टि करें। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। आपको ऑर्डर संपादित करने का अधिकार चाहिए; Modules पेज तक पहुँच आवश्यक नहीं है। रिफ़ंड PayPlug द्वारा वास्तव में वसूली गई राशि तक किए जाते हैं, इसलिए राशि में बेमेल होने के बाद आप ऑर्डर के कुल योग के बजाय ग्राहक द्वारा दी गई राशि रिफ़ंड कर सकते हैं। रिफ़ंड उसी भुगतान पर जाता है जिसने ऑर्डर वास्तव में चुकाया, और उस मोड (टेस्ट या लाइव) की सीक्रेट की से किया जाता है जिसमें वह भुगतान हुआ था, इसलिए उस मोड की की सेट होनी चाहिए। यदि PayPlug रिफ़ंड स्वीकार नहीं करता, तो ब्लॉक में त्रुटि दिखती है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड PayPlug रिफ़ंड ID और कारण के साथ रिफ़ंड इतिहास और नोट्स में जुड़ता है। पूर्ण रिफ़ंड ऑर्डर को Refunded पर सेट करता है। आंशिक रिफ़ंड स्टेटस नहीं बदलता। रिफ़ंड केवल तब उपलब्ध होते हैं जब PayPlug भुगतान को भुगतान किया हुआ बता चुका हो।
मॉड्यूल क्रेडिट स्लिप नहीं बनाता। ऑर्डर पेज के मानक PrestaShop रिफ़ंड बटन PayPlug के ज़रिए पैसे वापस नहीं भेजते।
PayPlug पोर्टल में किए गए रिफ़ंड सूचना के ज़रिए आते हैं और नोट्स में एक बार जुड़ते हैं। वे ब्लॉक में नहीं गिने जाते और ऑर्डर स्टेटस या क्रेडिट स्लिप नहीं बदलते। ज़रूरत हो तो उन्हें हाथ से दर्ज करें।
लाइसेंस कुंजी
मॉड्यूल vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox PayPlug Gateway, Modules > Module Manager > VibeFox PayPlug Gateway > Configure पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। इसके बाद ब्लॉक में कुंजी मास्क की हुई दिखती है, साथ में स्टेटस (उदाहरण के लिए लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन), और बटन: स्टेटस दोबारा जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: presta-payment-payplug वाली पंक्ति और आपके vibefox.net खाते को खोलने वाला लिंक Manage licenses and domains in your account है। केवल वे कर्मचारी कुंजी बदल सकते हैं जिनके पास मॉड्यूल के लिए Configure अनुमति है। ब्लॉक के टेक्स्ट बैक ऑफ़िस की भाषा के अनुसार दिखते हैं (अंग्रेज़ी और रूसी शामिल हैं)।
यदि कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, जैसे Key not found, This key belongs to another product, Domain limit reached, या तारीख के साथ License expired on। स्टोर का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं हो पाती, तो मॉड्यूल आखिरी ज्ञात स्टेटस पर काम करता रहता है।
एक कुंजी एक डोमेन पर काम करती है: मुख्य स्टोर के डोमेन पर, मल्टीस्टोर सेटअप में भी। स्टोर से कुंजी हटाने पर उसका डोमेन स्लॉट मुक्त नहीं होता। स्लॉट अपने vibefox.net खाते में मुक्त करें।
सक्रिय कुंजी के बिना चेकआउट पर ग्राहकों को PayPlug नहीं दिखाया जाता। यदि फिर भी भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। PrestaShop स्टोरफ़्रंट को पता नहीं होता कि आप बैक ऑफ़िस में लॉग इन हैं, इसलिए भुगतान विधि आपके लिए भी छिपी रहती है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, पर चेकआउट पर उसका परीक्षण नहीं कर सकते। Modules > Module Manager में Alerts टैब पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं उनकी पुष्टि होती रहती है, और रिफ़ंड काम करते हैं।
लाइसेंस समाप्त होने पर मॉड्यूल काम करता रहता है, पर अपडेट और सहायता के लिए नवीनीकरण चाहिए। बैक ऑफ़िस में काम करते समय स्टेटस अपने आप फिर से जाँचा जाता है: कुंजी दर्ज करने के बाद पहले 14 दिनों तक रोज़ एक बार, फिर हर हफ़्ते एक बार। कोई cron job ज़रूरी नहीं है। मॉड्यूल को अनइंस्टॉल या रीसेट करने पर लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हट जाते हैं।
समस्या निवारण
चेकआउट पर PayPlug दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, वर्तमान मोड में सीक्रेट की है (टेस्ट मोड में Test Secret Key, लाइव मोड में Live Secret Key), कार्ट की मुद्रा EUR है, और कार्ट की कुल राशि 0.99 से 20,000.00 EUR के बीच है। Payment > Preferences में जाँचें कि मॉड्यूल कार्ट की मुद्रा, ग्राहक के देश और ग्राहक के समूह के लिए अनुमत है। डेवलपर actionWcpPayplugSupportedCurrencies और actionWcpPayplugAmountLimits हुक से मुद्राएँ और सीमाएँ बदल सकते हैं (मान सेंट में)।
भुगतान हो गया, पर ऑर्डर नहीं बना: सूचना आपके स्टोर तक नहीं पहुँची और ग्राहक वापस नहीं लौटा। जाँचें कि आपका स्टोर सेटिंग्स में दिखाए गए Notification URL पर इंटरनेट से पहुँचने योग्य है, उदाहरण के लिए कोई फ़ायरवॉल या पासवर्ड सुरक्षा उसे रोक तो नहीं रही। Logging चालू करें और अस्वीकृत सूचनाओं के लिए Log फ़ील्ड देखें।
सूचना Verification failed. का जवाब देती है: PayPlug API से भुगतान नहीं पढ़ा जा सका, उदाहरण के लिए PayPlug ने जवाब नहीं दिया या भुगतान के मोड की सीक्रेट की सेट नहीं है। ऑर्डर नहीं बदलता, और PayPlug सूचना फिर भेजता है।
सूचना Temporarily unavailable. का जवाब देती है: उसी समय कार्ट किसी दूसरे अनुरोध से अपडेट हो रहा था, उदाहरण के लिए ग्राहक की वापसी, या ऑर्डर नहीं बन सका (उदाहरण के लिए मॉड्यूल बंद है)। PayPlug सूचना फिर भेजता है। लॉग कारण दिखाता है।
सूचना Unknown payment. या Payment does not belong to the order. का जवाब देती है: भुगतान इस स्टोर ने नहीं बनाया या इस कार्ट के लिए नहीं है, उदाहरण के लिए उसी PayPlug खाते पर किसी दूसरे स्टोर का भुगतान। उसे अनदेखा किया जाता है।
ब्राउज़र में सूचना URL Method not allowed. दिखाता है: यह सामान्य है। यह URL केवल PayPlug के अनुरोध स्वीकार करता है।
ग्राहक PayPlug चुनते समय त्रुटि देखता है: Logging चालू करें और Log फ़ील्ड देखें। गलत कुंजी This payment method is temporarily unavailable. Please choose another payment method. दिखाती है; अन्य संदेश उस बिलिंग फ़ील्ड का नाम बताते हैं जिसे PayPlug ने अस्वीकार किया।
भुगतान के बाद ऑर्डर PayPlug payment on hold में है: PayPlug payment ब्लॉक के नोट पढ़ें (देखें ऑर्डर स्टेटस), फिर ऑर्डर संसाधित करें या भुगतान रिफ़ंड करें।
मोड से संबंधित संदेश के साथ रिफ़ंड विफल: भुगतान टेस्ट या लाइव मोड में हुआ था, और उस मोड की सीक्रेट की कॉन्फ़िगर नहीं है। उसे दर्ज करें और फिर कोशिश करें।
Unexpected response from PayPlug. के साथ रिफ़ंड विफल: PayPlug ने वैध रिफ़ंड के बिना जवाब दिया। कुछ भी दर्ज नहीं हुआ। दोबारा कोशिश करने से पहले PayPlug पोर्टल में रिफ़ंड जाँचें।
अनइंस्टॉल
Modules > Module Manager पर जाएँ, VibeFox PayPlug Gateway के बगल का मेनू खोलें और Uninstall चुनें। इस मॉड्यूल की लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटा दिए जाते हैं। यदि Delete Data on Uninstall चालू है, तो मॉड्यूल की सेटिंग्स और लॉग हटा दिए जाते हैं। यदि बंद है, तो बाद में फिर से इंस्टॉल करने के लिए सभी सेटिंग्स रखी जाती हैं। PayPlug भुगतान और रिफ़ंड रिकॉर्ड और ऑर्डर स्टेटस PayPlug payment on hold हमेशा रखे जाते हैं, ताकि पहले भुगतान किए गए ऑर्डर फिर से इंस्टॉल होने के बाद भी रिफ़ंड किए जा सकें। मौजूदा ऑर्डर अपने भुगतान नोट और ट्रांज़ैक्शन ID रखते हैं।
PayPlug अपने संबंधित स्वामी का ट्रेडमार्क है। यह मॉड्यूल PayPlug से संबद्ध नहीं है और PayPlug द्वारा समर्थित नहीं है।