VibeFox Paysera for WooCommerce — सहायता

आवश्यकताएँ

WordPress: 6.0 या बाद का।

WooCommerce: 7.0 या बाद का, इंस्टॉल और सक्रिय। इसके बिना प्लगइन सक्रिय नहीं होता।

PHP: 8.0 या बाद का।

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

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

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

इंस्टॉलेशन

1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से wcp_paysera_payment फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।

2. Activate पर क्लिक करें।

3. सेटिंग खोलें: WooCommerce > Settings > Payments > Paysera > Manage, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।

4. पेज के ऊपर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें।

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

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

7. Enable/Disable चालू करें और सहेजें।

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

सभी सेटिंग एक ही पेज पर हैं: WooCommerce > Settings > Payments > Paysera। फ़ील्ड के ऊपर, प्रोजेक्ट ID या प्रोजेक्ट पासवर्ड में से कोई एक न भरा होने पर पेज जब तक प्रोजेक्ट ID और प्रोजेक्ट पासवर्ड दर्ज नहीं किए जाते, चेकआउट पर Paysera छिपा रहता है। संदेश दिखाता है। साथ ही, जब तक टेस्ट भुगतान या सैंडबॉक्स चालू हैं, यह सूचना देता है कि ग्राहकों से शुल्क नहीं लिया जा रहा है। भुगतान विधियों की सूची में, प्रोजेक्ट कॉन्फ़िगर होने तक Paysera को सेटअप की ज़रूरत वाला चिह्नित किया जाता है, और टेस्ट भुगतान या सैंडबॉक्स चालू होने पर टेस्ट मोड बैज दिखाया जाता है।

सामान्य

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

Title: चेकआउट पर दिखने वाला भुगतान विधि का नाम। डिफ़ॉल्ट: Paysera।

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

Paysera प्रोजेक्ट

प्रोजेक्ट ID और प्रोजेक्ट पासवर्ड आपके Paysera खाते में Projects and activities के अंतर्गत मिलते हैं: अपना प्रोजेक्ट चुनें, फिर General project settings। इस सेक्शन में कॉलबैक URL दिखता है, जो https://your-site/wc-api/wc_psr_payment/ जैसा दिखता है। यह हर भुगतान के साथ अपने आप भेजा जाता है; Paysera में कुछ भी कॉन्फ़िगर नहीं करना होता।

Project ID: आपके Paysera प्रोजेक्ट का संख्यात्मक ID।

Project password: प्रोजेक्ट पासवर्ड (साइन की)। यह भुगतान अनुरोधों पर हस्ताक्षर करता है और Paysera कॉलबैक को सत्यापित करता है।

टेस्टिंग

Test payments: Send payments in test mode (no money is charged)। Paysera ग्राहक से पैसे लिए बिना एक सफल टेस्ट भुगतान लौटाता है। पहले Paysera प्रोजेक्ट सेटिंग में Allow test payments सक्षम करें। जब तक यह विकल्प चालू है, टेस्ट भुगतान ऑर्डर को भुगतान किया हुआ चिह्नित करते हैं; बंद होने पर टेस्ट भुगतान कभी किसी ऑर्डर का भुगतान नहीं करता। डिफ़ॉल्ट: बंद।

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

उन्नत

Debug log: Log payment events। त्रुटियाँ हमेशा लॉग होती हैं। लॉग WooCommerce > Status > Logs में, स्रोत wcp_paysera_payment के अंतर्गत मिलते हैं। पासवर्ड और ग्राहक डेटा कभी नहीं लिखे जाते। डिफ़ॉल्ट: बंद।

Delete data: Delete the plugin settings and logs when the plugin is deleted। प्लगइन को निष्क्रिय करने से कुछ भी नहीं हटता। ऑर्डर डेटा हमेशा रखा जाता है। डिफ़ॉल्ट: बंद।

चेकआउट

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

भुगतान के बाद ग्राहक ऑर्डर प्राप्ति पेज पर लौट आता है। ऑर्डर केवल तब भुगतान किया हुआ चिह्नित होता है जब हस्ताक्षरित Paysera कॉलबैक आता है; ग्राहक का लौटना अपने आप कभी ऑर्डर का भुगतान नहीं करता।

यदि ग्राहक Paysera विंडो में रद्द करता है, तो ऑर्डर WooCommerce के मानक तरीके से रद्द हो जाता है, और ग्राहक दोबारा ऑर्डर कर सकता है। यदि भुगतान शुरू नहीं हो सकता, तो ग्राहक को Paysera भुगतान अस्थायी रूप से उपलब्ध नहीं हैं। कृपया कोई दूसरी भुगतान विधि चुनें। दिखता है। कारण लॉग में लिखा जाता है।

भुगतान विधि क्लासिक चेकआउट, चेकआउट ब्लॉक और Pay for order पेज पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।

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

ऑर्डर

ऑर्डर स्टेटस

Pending payment: ग्राहक को Paysera पर भेजा गया है और कॉलबैक अभी तक नहीं आया है।

Processing: Paysera ने भुगतान की पुष्टि की है (स्टेटस 1)। केवल डाउनलोड योग्य वर्चुअल उत्पाद वाले ऑर्डर WooCommerce के डिफ़ॉल्ट के अनुसार पूर्ण हो जाते हैं। ऑर्डर नोट में Paysera अनुरोध और भुगतान विधि दिखती है। लेन-देन ID Paysera अनुरोध ID है।

On hold: Paysera ने भुगतान आदेश स्वीकार किया है पर उसे अभी निष्पादित नहीं किया है (स्टेटस 2), और Paysera के भुगतान की पुष्टि करने पर ऑर्डर पूर्ण हो जाता है; या भुगतान की गई राशि या मुद्रा ऑर्डर से भिन्न है (नोट amount/currency mismatch); या टेस्ट भुगतान बंद होने के दौरान एक TEST भुगतान प्राप्त हुआ, इसलिए कोई पैसा नहीं काटा गया। ऑर्डर नोट इसका कारण बताता है।

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

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

रिफ़ंड

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

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

यह प्लगइन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Payments > Paysera पेज के ऊपर है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्टेटस दिखाता है, जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्टेटस दोबारा जाँचने के लिए Check now, कोई दूसरी कुंजी दर्ज करने के लिए Change key, और इस साइट से कुंजी हटाने के लिए Remove key का उपयोग करें। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।

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

सक्रिय कुंजी के बिना चेकआउट पर ग्राहकों को Paysera नहीं दिखाया जाता। यदि फिर भी कोई भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। लॉगिन किए हुए स्टोर मैनेजरों को भुगतान विधि अब भी (unlicensed — visible to admins only) चिह्न के साथ दिखती है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट करके उसकी जाँच कर सकें। प्लगइन्स पेज और WooCommerce पेज पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं, उनकी पुष्टि अब भी होती है।

लाइसेंस समाप्त होने पर प्लगइन काम करना जारी रखता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण ज़रूरी है। स्टेटस पृष्ठभूमि में अपने आप दोबारा जाँचा जाता है।

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

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

भुगतान हो गया, पर ऑर्डर Pending payment पर रहता है: ऑर्डर का भुगतान Paysera कॉलबैक से होता है, ग्राहक के लौटने से नहीं। जाँचें कि आपकी साइट सेटिंग में दिखाए गए कॉलबैक URL पर इंटरनेट से पहुँच योग्य है (लॉगिन, मेंटेनेंस मोड या फ़ायरवॉल के पीछे नहीं), और WooCommerce > Status > Logs में स्रोत wcp_paysera_payment देखें।

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

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

कॉलबैक Gateway not configured या Busy से जवाब देता है: प्रोजेक्ट ID या पासवर्ड खाली है, या उसी ऑर्डर के लिए कोई और कॉलबैक अब भी चल रहा है। Paysera कॉलबैक दोबारा भेजता है।

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

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

चेकआउट पर कोई आइकन नहीं: प्लगइन डिफ़ॉल्ट रूप से आइकन नहीं दिखाता। डेवलपर wc_psr_gateway_icon फ़िल्टर से एक आइकन सेट कर सकते हैं।

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

लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक के संदेश का पालन करें। उदाहरण के लिए, यदि कुंजी किसी दूसरे डोमेन पर पहले से उपयोग में है, तो अपने vibefox.net खाते में स्लॉट मुक्त करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन पर कुंजी सक्रिय करने के लिए Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं हो पाती, तो प्लगइन अंतिम ज्ञात स्टेटस पर काम करता रहता है।

अनइंस्टॉल

प्लगइन को निष्क्रिय करने से सारा डेटा सुरक्षित रहता है। हटाने के लिए, Plugins पेज पर उसे निष्क्रिय करके डिलीट करें। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटा दिए जाते हैं। गेटवे सेटिंग और लॉग तभी हटाए जाते हैं जब Delete data चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए रहते हैं। मौजूदा ऑर्डर अपने भुगतान नोट और लेन-देन ID रखते हैं।

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