VibeFox Paysera for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

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

Paysera प्रोजेक्ट: आपको अपने Paysera प्रोजेक्ट का प्रोजेक्ट ID और प्रोजेक्ट पासवर्ड (sign key) चाहिए। ग्राहक को जो भुगतान विधियाँ दिखती हैं, वे इसी प्रोजेक्ट में सक्षम की गई हैं। कॉलबैक के लिए Paysera में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है: इसका URL हर भुगतान अनुरोध के साथ भेजा जाता है।

पहुँच योग्य स्टोर: ऑर्डर Paysera कॉलबैक द्वारा बनते हैं, इसलिए आपका स्टोर इंटरनेट से पहुँच योग्य होना चाहिए, न कि लॉगिन, बेसिक ऑथेंटिकेशन या फ़ायरवॉल के पीछे। स्टोर मेंटेनेंस मोड में होने पर भी कॉलबैक काम करता है।

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

इंस्टॉलेशन

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

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

3. Configure पेज के शीर्ष पर लाइसेंस ब्लॉक में License key फ़ील्ड में अपनी VibeFox लाइसेंस कुंजी डालें और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।

4. अपने Paysera खाते से Project ID और Project password डालें (कॉन्फ़िगरेशन देखें)।

5. वैकल्पिक: बिना पैसे काटे प्रवाह आज़माने के लिए Paysera प्रोजेक्ट में Allow test payments और मॉड्यूल में Test payments सक्षम करें। बिक्री शुरू करने से पहले इन्हें बंद कर दें।

6. Enable/Disable चालू करें और Save पर क्लिक करें।

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

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

सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox Paysera Payment > Configure। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सेव करता है। फ़ील्ड के ऊपर, जब तक दोनों में से कोई एक खाली हो, पेज Paysera is hidden at checkout until the project ID and the project password are entered. दिखाता है, और जब टेस्ट भुगतान या सैंडबॉक्स चालू हों, तब Test mode is on: customers are not charged. Turn off "Test payments" and select "Production" before accepting real orders. दिखाता है।

Paysera

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

Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखता है। ऑर्डर में भी भुगतान विधि के नाम के रूप में यही सेव होता है। डिफ़ॉल्ट: Paysera। आवश्यक।

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

Paysera प्रोजेक्ट

प्रोजेक्ट ID और प्रोजेक्ट पासवर्ड आपके Paysera खाते में Projects and activities के अंतर्गत, अपने प्रोजेक्ट में, General project settings पर मिलेंगे।

Callback URL: वह पता जिससे Paysera हर भुगतान की पुष्टि करता है। फ़्रेंडली URL के साथ यह ऐसा दिखता है: https://your-shop/module/wcp_paysera_payment/callback, संभव है कि इसके साथ भाषा कोड भी हो। यह हर भुगतान के साथ अपने-आप भेजा जाता है, इसलिए Paysera में कुछ भी सेट करने की ज़रूरत नहीं है, लेकिन यह इंटरनेट से पहुँच योग्य होना चाहिए। ऑर्डर केवल इन हस्ताक्षरित कॉलबैक से बनते हैं।

Project ID: आपके Paysera प्रोजेक्ट का संख्यात्मक ID। केवल अंक स्वीकार होते हैं: कोई और मान डालने पर Project ID must be a number: the numeric ID of your Paysera project. त्रुटि आती है और कुछ भी सेव नहीं होता।

Project password: प्रोजेक्ट पासवर्ड (sign key)। यह भुगतान अनुरोधों पर हस्ताक्षर करता है और Paysera कॉलबैक की पुष्टि करता है। सेव किया गया पासवर्ड दोबारा नहीं दिखाया जाता। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान डालें।

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

टेस्टिंग

Test payments: भुगतान टेस्ट मोड में भेजता है, इसलिए कोई पैसा नहीं काटा जाता। Paysera ग्राहक से शुल्क लिए बिना सफल टेस्ट भुगतान लौटाता है। पहले Paysera प्रोजेक्ट सेटिंग्स में Allow test payments सक्षम करें। जब तक यह विकल्प चालू है, टेस्ट भुगतान ऑर्डर को भुगतान किया हुआ चिह्नित करते हैं; बंद होने पर टेस्ट भुगतान ऑर्डर को होल्ड पर डाल देता है। डिफ़ॉल्ट: off। चालू रहने पर ग्राहक भुगतान विधि के नीचे TEST MODE — no money will be charged. देखते हैं।

Environment: वह जगह जहाँ ग्राहक को भेजा जाता है। सामान्य Paysera प्रोजेक्ट के लिए, टेस्ट भुगतान सहित, Production रखें। डिफ़ॉल्ट: Production।

एडवांस्ड

Debug log: भुगतान इवेंट मॉड्यूल फ़ोल्डर में logs/wc_psr_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खुल सकती। त्रुटियाँ और चेतावनियाँ हमेशा लिखी जाती हैं; बाकी चरण केवल तब लिखे जाते हैं जब यह विकल्प चालू हो। पासवर्ड और ग्राहक डेटा कभी नहीं लिखे जाते। डिफ़ॉल्ट: off।

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

Delete data: चालू होने पर मॉड्यूल अनइंस्टॉल करने से मॉड्यूल की सेटिंग्स और लॉग हट जाते हैं। ऑर्डर डेटा (ऑर्डर, Paysera भुगतान रिकॉर्ड, ऑर्डर स्टेटस) हमेशा रखा जाता है। डिफ़ॉल्ट: off।

चेकआउट

भुगतान चरण पर ग्राहक भुगतान विधि (डिफ़ॉल्ट रूप से Paysera) चुनता है और ऑर्डर की पुष्टि करता है। मॉड्यूल कार्ट की मुद्रा की न्यूनतम इकाई में कार्ट का कुल योग, ग्राहक का नाम, ईमेल और बिलिंग पता, तथा स्टोर पेज की भाषा (लिथुआनियाई, लातवियाई, एस्टोनियाई, रूसी, जर्मन, पोलिश; अन्यथा अंग्रेज़ी) वाला हस्ताक्षरित भुगतान अनुरोध बनाता है। ग्राहक Paysera भुगतान विंडो पर भेजा जाता है और वहाँ बैंक, कार्ड या कोई अन्य तरीका चुनता है। इस बिंदु पर अभी कोई ऑर्डर मौजूद नहीं होता।

Paysera सर्वर-से-सर्वर कॉलबैक से भुगतान की पुष्टि करता है। ऑर्डर को तभी भुगतान किया हुआ चिह्नित किया जाता है जब Paysera हस्ताक्षरित कॉलबैक से पुष्टि कर दे; ग्राहक के स्टोर पर लौटने से कोई ऑर्डर कभी नहीं बनता या भुगतान नहीं होता। कॉलबैक के बाद ग्राहक लौटता है तो मानक ऑर्डर पुष्टि पेज दिखाया जाता है। यदि बैंक ने भुगतान आदेश स्वीकार किया है पर अभी निष्पादित नहीं किया है, तो ऑर्डर Awaiting Paysera payment में बनता है और पेज Paysera is confirming your payment. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. दिखाता है। होल्ड वाले ऑर्डर के लिए पेज Your payment is being reviewed. We will contact you if anything else is needed. दिखाता है।

यदि ग्राहक कॉलबैक से पहले लौट आता है, तो Payment confirmation पेज बताता है कि Paysera भुगतान की पुष्टि करते ही ऑर्डर बन जाएगा, और Check again और Back to checkout विकल्प देता है।

यदि ग्राहक Paysera विंडो में रद्द करता है, तो वह The Paysera payment was cancelled. You can try again or choose another payment method. संदेश के साथ चेकआउट पर लौट आता है। यदि Paysera बताता है कि भुगतान निष्पादित नहीं हुआ, तो संदेश The payment was not completed. You can try again or choose another payment method. होता है। दोनों स्थितियों में कार्ट बना रहता है। यदि कार्ट में पहले से ऑर्डर है, तो नया प्रयास दूसरे भुगतान के बजाय सीधे ऑर्डर पुष्टि पर जाता है।

यदि भुगतान शुरू नहीं हो सकता, तो ग्राहक Paysera payments are temporarily unavailable. Please choose another payment method. के साथ चेकआउट पर रहता है, या ऑर्डर राशि अमान्य होने पर This order cannot be paid via Paysera. के साथ। कारण लॉग में लिखा जाता है।

कॉलबैक स्टोर के मेंटेनेंस मोड में रहने पर भी काम करता है और आपके स्टोर के देश प्रतिबंध से अवरुद्ध नहीं होता।

मॉड्यूल में बैक ऑफिस से रिफ़ंड, चेकआउट पेज पर बैंक या भुगतान विधि का चुनाव, सब्सक्रिप्शन, सहेजे गए कार्ड, और Paysera डिलीवरी या कूरियर सेवाएँ नहीं हैं।

ऑर्डर

ऑर्डर स्टेटस

No order yet: ग्राहक को Paysera पर भेजा गया था और कॉलबैक अभी नहीं आया, या ग्राहक ने रद्द कर दिया। केवल कार्ट मौजूद है।

Payment accepted: Paysera ने मिलती राशि और मुद्रा वाला भुगतान पुष्ट किया। भुगतान Paysera अनुरोध ID को ट्रांज़ैक्शन ID के रूप में दर्ज होता है, और एक नोट में अनुरोध और भुगतान विधि दिखती है, टेस्ट भुगतानों के लिए (TEST — no money charged) चिह्न के साथ।

Awaiting Paysera payment: Paysera ने भुगतान आदेश स्वीकार किया है, लेकिन बैंक ने उसे अभी निष्पादित नहीं किया। Paysera भुगतान की पुष्टि करने पर ऑर्डर Payment accepted में चला जाता है।

Paysera payment on hold: भुगतान की मैन्युअल समीक्षा ज़रूरी है। भुगतान की गई राशि या मुद्रा कार्ट या ऑर्डर कुल से अलग है, Test payments बंद होने के दौरान एक TEST भुगतान आया (कोई पैसा नहीं काटा गया), या ग्राहक द्वारा रद्द करने के बाद भुगतान की पुष्टि हुई। भुगतान दर्ज नहीं होता। नोट इसका कारण बताता है, और Paysera ब्लॉक आपसे कहता है कि अपने Paysera खाते में भुगतान जाँचें, फिर ऑर्डर को Payment accepted पर सेट करें या उसे रद्द करके Paysera में भुगतान रिफ़ंड करें।

Cancelled: रद्द किए गए ऑर्डर के लिए बाद में पुष्ट हुआ भुगतान उसका स्टेटस नहीं बदलता। नोट आपसे ऑर्डर बहाल करने (उसे Payment accepted पर सेट करने) या Paysera में भुगतान रिफ़ंड करने के लिए कहता है। रद्द ऑर्डर पर बाद का TEST भुगतान या राशि का अंतर भी केवल एक नोट जोड़ता है।

यदि पहले से भुगतान किए गए ऑर्डर के लिए कोई और सफल भुगतान आता है, तो ऑर्डर नहीं बदलता, और एक नोट आपसे डुप्लिकेट को अपने Paysera खाते में रिफ़ंड करने के लिए कहता है। अन्य Paysera स्टेटस (भुगतान निष्पादित नहीं हुआ, अतिरिक्त जानकारी) केवल एक नोट जोड़ते हैं।

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

ऑर्डर पेज पर Paysera payment ब्लॉक दिखता है, जिसमें Paysera ऑर्डर ID (कार्ट नंबर और प्रयास), Paysera अनुरोध ID, वातावरण और TEST payment चिह्न, भुगतान स्टेटस, माँगी गई और भुगतान की गई राशियाँ, भुगतान विधि और मॉड्यूल के नोट शामिल होते हैं।

रिफ़ंड

बैक ऑफिस से रिफ़ंड समर्थित नहीं हैं: Paysera भुगतान विंडो प्रोटोकॉल में कोई रिफ़ंड API नहीं है। रिफ़ंड अपने Paysera खाते में करें। जब Paysera कोई रिफ़ंड बताता है, तो ऑर्डर में रिफ़ंड की गई राशि वाला नोट जुड़ जाता है, और ऑर्डर स्टेटस नहीं बदलता। ज़रूरत हो तो PrestaShop में रिफ़ंड मैन्युअली दर्ज करें।

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

यह मॉड्यूल vibefox.net से ली गई VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Paysera Payment, Modules > Module Manager > VibeFox Paysera Payment > Configure पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी License key में डालें और Activate पर क्लिक करें। इसके बाद ब्लॉक में कुंजी मास्क की हुई दिखती है, साथ में स्टेटस (उदाहरण के लिए लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन), और बटन: स्टेटस दोबारा जाँचने के लिए Check now, दूसरी कुंजी डालने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: presta-payment-paysera वाली पंक्ति और आपके 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 खाते में मुक्त करें।

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

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

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

चेकआउट पर Paysera दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और Project ID तथा Project password दोनों डाले गए हैं। इनमें से कोई खाली होने पर सेटिंग्स पेज चेतावनी दिखाता है। Payment > Preferences में जाँचें कि मॉड्यूल कार्ट की मुद्रा, ग्राहक के देश और ग्राहक समूह के लिए अनुमत है।

भुगतान हो गया, पर ऑर्डर नहीं बना: ऑर्डर Paysera कॉलबैक से बनता है, ग्राहक के लौटने से नहीं। जाँचें कि आपका स्टोर सेटिंग्स में दिखाए Callback URL पर इंटरनेट से पहुँच योग्य है (लॉगिन, बेसिक ऑथेंटिकेशन या फ़ायरवॉल के पीछे नहीं), और मॉड्यूल पेज पर Log फ़ील्ड देखें।

कॉलबैक Invalid signature बताता है: Project password प्रोजेक्ट से मेल नहीं खाता, या कॉलबैक Paysera से नहीं है। प्रोजेक्ट पासवर्ड दोबारा कॉपी करें। यदि आपने प्रोजेक्ट या पासवर्ड बदला है, तो बदलाव से पहले शुरू हुए भुगतान अब सत्यापित नहीं किए जा सकते।

कॉलबैक Project ID mismatch बताता है: सेटिंग्स में Project ID उस प्रोजेक्ट से अलग है जिसने भुगतान किया।

कॉलबैक Order not found बताता है: कॉलबैक की कार्ट का इस स्टोर में कोई Paysera भुगतान नहीं है, उदाहरण के लिए भुगतान उसी प्रोजेक्ट वाले किसी दूसरे स्टोर में शुरू हुआ था।

कॉलबैक Gateway not configured, Busy या Temporary error बताता है: प्रोजेक्ट ID या पासवर्ड खाली है, उसी कार्ट के लिए कोई दूसरा कॉलबैक अभी चल रहा है, या ऑर्डर नहीं बन सका (उदाहरण के लिए मॉड्यूल बंद है)। Paysera कॉलबैक दोबारा भेजता है। कारण देखने के लिए Debug log चालू करें।

Paysera भुगतान विंडो को अस्वीकार करता है या कहता है कि प्रोजेक्ट मौजूद नहीं है: Environment जाँचें। सामान्य Paysera प्रोजेक्ट केवल Production के साथ काम करता है; Sandbox के लिए Paysera सैंडबॉक्स वातावरण में बना प्रोजेक्ट चाहिए।

टेस्ट भुगतान ऑर्डर का भुगतान नहीं करता: TEST भुगतान ऑर्डर का भुगतान केवल तभी करता है जब Test payments चालू हो। अन्यथा ऑर्डर होल्ड पर चला जाता है, साथ में नोट होता है कि कोई पैसा नहीं काटा गया। Paysera प्रोजेक्ट में Allow test payments भी सक्षम करें।

ऑर्डर Paysera payment on hold में है और राशि/मुद्रा के अंतर का नोट है: Paysera ने ऐसा भुगतान पुष्ट किया जिसकी राशि या मुद्रा कार्ट के कुल से अलग है, उदाहरण के लिए ग्राहक द्वारा भुगतान शुरू करने के बाद कार्ट दूसरे टैब में बदला गया था। अपने Paysera खाते में भुगतान की तुलना करें और ऑर्डर स्वीकार करें या भुगतान मैन्युअली रिफ़ंड करें। उसी ऑर्डर के लिए बाद में आने वाला सही भुगतान उसे भुगतान किया हुआ चिह्नित करता है।

ग्राहक को Paysera payments are temporarily unavailable दिखता है: Log फ़ील्ड देखें। प्रोजेक्ट ID या पासवर्ड खाली हो सकता है, या Paysera को भेजे गए स्टोर पतों में से कोई एक 255 अक्षरों से लंबा हो सकता है।

अनइंस्टॉल

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

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