VibeFox Paytrail for WooCommerce — सहायता

आवश्यकताएँ

WordPress: 6.0 या उसके बाद का संस्करण।

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

PHP: 8.0 या उसके बाद का संस्करण।

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

आपकी साइट तक इंटरनेट पहुँच: Paytrail प्रत्येक भुगतान की पुष्टि सर्वर-टू-सर्वर कॉलबैक के साथ करता है, इसलिए साइट इंटरनेट से सुलभ होनी चाहिए। कॉलबैक के बिना भी, जब ग्राहक Paytrail से वापस आता है तब ऑर्डर की पुष्टि हो जाती है।

Paytrail खाता: आपको अपने Merchant ID और Secret key की आवश्यकता है, जो Paytrail Merchant Panel (खाता या एकीकरण विवरण) में दिखाई देते हैं। परीक्षण के लिए किसी खाते की आवश्यकता नहीं है: टेस्ट मोड Paytrail के सार्वजनिक टेस्ट खाते का उपयोग करता है। भुगतान विधियाँ स्वयं आपके Paytrail खाते में सक्षम की जाती हैं।

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

इंस्टॉलेशन

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

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

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

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

5. पहले प्लगइन आज़माने के लिए, Test mode पर टिक करें। वास्तविक भुगतानों के लिए, टिक हटाएँ और अपनी Merchant ID तथा Secret key दर्ज करें। Paytrail में कोई कॉलबैक URL कॉन्फ़िगर करने की आवश्यकता नहीं है।

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

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

सभी सेटिंग्स एक पेज पर हैं: WooCommerce > Settings > Payments > Paytrail। टेस्ट मोड चालू रहने के दौरान फ़ील्ड के ऊपर पेज Test mode is active. दिखाता है। लाइव मोड में यह चेतावनी देता है जब Merchant ID या Secret key गायब हो, और यह चेतावनी देता है जब स्टोर मुद्रा EUR न हो। दोनों ही मामलों में चेकआउट पर Paytrail प्रदर्शित नहीं होता है। भुगतान विधियों की सूची में, जब तक लाइव मोड में क्रेडेंशियल नहीं होते, Paytrail को सेटअप की आवश्यकता के रूप में चिह्नित किया जाता है।

सहेजते समय, जिस Merchant ID में अंकों के अलावा कुछ भी शामिल होता है, वह सहेजा नहीं जाता: एक त्रुटि दिखाई देती है और पिछला मान बना रहता है।

General

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

Title: चेकआउट के दौरान ग्राहकों को दिखाया जाने वाला शीर्षक। डिफ़ॉल्ट: Paytrail।

Description: चेकआउट के दौरान ग्राहकों को दिखाया जाने वाला विवरण। डिफ़ॉल्ट: Pay securely with Finnish online banking, card, mobile payment or invoice on the Paytrail payment page.

API credentials

आपकी Merchant ID और Secret key, Paytrail Merchant Panel (खाता या एकीकरण विवरण) में दिखाई देती हैं। केवल EUR भुगतान समर्थित हैं।

Test mode: Use the Paytrail test account। नए भुगतान आपके स्वयं के क्रेडेंशियल के बजाय Paytrail के सार्वजनिक टेस्ट खाते (Merchant ID 375917) का उपयोग करते हैं। कोई वास्तविक पैसा नहीं लिया जाता है। ग्राहक चेकआउट पर Test mode: no real payment will be made. देखते हैं। टेस्ट खाते की Secret key सार्वजनिक है, इसलिए कोई भी टेस्ट मोड में बनाए गए ऑर्डर के लिए भुगतान का अनुकरण कर सकता है। लाइव शॉप में कभी भी टेस्ट मोड चालू न रखें। डिफ़ॉल्ट: बंद।

Merchant ID: आपकी Paytrail Merchant ID (केवल अंक)। जब टेस्ट मोड बंद हो तब उपयोग किया जाता है।

Secret key: आपकी Paytrail Secret key। जब टेस्ट मोड बंद हो तब उपयोग किया जाता है।

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

Orders

यह अनुभाग कॉलबैक URL दिखाता है, जो https://your-site/wc-api/ptg_paytrail/ जैसा दिखता है। Paytrail इस URL पर सर्वर-टू-सर्वर प्रत्येक भुगतान की पुष्टि करता है। यह प्रत्येक भुगतान के साथ भेजा जाता है, इसलिए Paytrail पैनल में कुछ भी कॉन्फ़िगर करने की आवश्यकता नहीं है, लेकिन साइट इंटरनेट से सुलभ होनी चाहिए।

Order status after payment: भुगतान किए गए ऑर्डर की स्थिति। स्थिति एक चरण में सेट की जाती है, ताकि ग्राहक को ई-मेल का एक सेट मिले।

Advanced

Debug log: Log API requests and callbacks। व्यक्तिगत डेटा या कुंजियों के बिना WooCommerce > Status > Logs, स्रोत wcp_paytrail_gateway में लिखा जाता है। त्रुटियाँ हमेशा लॉग की जाती हैं। डिफ़ॉल्ट: बंद।

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

चेकआउट

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

ग्राहक को Paytrail भुगतान पेज पर भेजा जाता है, वह आपके Paytrail खाते के लिए सक्षम भुगतान विधि चुनता है और भुगतान करता है। Paytrail तब भुगतान की पुष्टि दो बार करता है: यह ग्राहक को आपके स्टोर पर वापस भेजता है और सर्वर-टू-सर्वर कॉलबैक URL को कॉल करता है। दोनों केवल उस भुगतान प्रयास के क्रेडेंशियल से बने मान्य हस्ताक्षर के साथ और केवल उस ऑर्डर के लिए बनाए गए प्रयास के लिए ही स्वीकार किए जाते हैं। भुगतान की गई राशि की तुलना ऑर्डर के कुल योग से की जाती है। Paytrail द्वारा इस तरह से पुष्टि करने के बाद ही ऑर्डर को भुगतान किया हुआ चिह्नित किया जाता है। प्लगइन इन Paytrail स्थितियों को संभालता है:

सफल भुगतान के बाद ग्राहक ऑर्डर प्राप्त पेज देखता है। रद्द या विफल भुगतान के बाद ग्राहक Pay for order पेज पर संदेश The Paytrail payment was cancelled or failed. You can try again or choose another payment method. के साथ जाता है। यदि भुगतान अभी समाप्त नहीं हुआ है, तो संदेश The Paytrail payment has not been completed yet. You can try again or choose another payment method. होता है।

यदि Paytrail भुगतान शुरू नहीं कर सकता है, तो ग्राहक को एक संक्षिप्त संदेश दिखाई देता है, उदाहरण के लिए Could not connect to Paytrail. Please try again in a moment., Paytrail is temporarily unavailable. Please choose another payment method. (गलत क्रेडेंशियल) या Paytrail could not start the payment. Please check your billing details and try again, or choose another payment method.। तकनीकी कारण ऑर्डर नोट और लॉग में जोड़ा जाता है। Paytrail की अधिकतम राशि से ऊपर के ऑर्डर Paytrail से भुगतान नहीं किए जा सकते।

Paytrail भुगतान को API के माध्यम से रद्द नहीं किया जा सकता। यदि ग्राहक एक नया भुगतान शुरू करता है और फिर पुराने, अभी भी खुले भुगतान पेज पर भी भुगतान कर देता है, तो दूसरे भुगतान को रिफ़ंड के लिए डुप्लिकेट के रूप में ऑर्डर नोट में रिपोर्ट किया जाता है।

भुगतान विधि क्लासिक चेकआउट, Checkout ब्लॉक और Pay for order पेज पर काम करती है। यह WooCommerce हाई-परफ़ॉर्मेंस ऑर्डर स्टोरेज (HPOS) के साथ संगत है।

ग्राहक Paytrail पेज पर भुगतान विधि चुनता है, आपके चेकआउट में नहीं। प्लगइन में कोई कार्ड टोकनाइज़ेशन या सेव किए गए कार्ड नहीं हैं, कोई WooCommerce Subscriptions नहीं है, कोई शॉप-इन-शॉप नहीं है, कोई मैन्युअल इनवॉइस सक्रियण नहीं है और कोई सेटलमेंट रिपोर्ट नहीं है।

ऑर्डर और रिफ़ंड

ऑर्डर स्थितियाँ

Pending payment: Paytrail भुगतान बनाया गया था और ग्राहक ने अभी तक भुगतान नहीं किया है। ऑर्डर नोट Paytrail लेन-देन आईडी, राशि और मोड दिखाता है।

Processing or Completed: भुगतान की पुष्टि हो गई। स्थिति Order status after payment का पालन करती है। ऑर्डर नोट लेन-देन, Paytrail पर उपयोग की गई भुगतान विधि और राशि दिखाता है। लेन-देन आईडी Paytrail लेन-देन आईडी है।

On hold: प्रदाता पर भुगतान लंबित है (इनवॉइस या विलंबित भुगतान), भुगतान की गई राशि ऑर्डर के कुल योग से भिन्न है, ऑर्डर रद्द होने के बाद भुगतान आया, या स्टोर लाइव रहने के दौरान एक टेस्ट भुगतान प्राप्त हुआ (कोई वास्तविक पैसा नहीं)। ऑर्डर नोट कारण बताता है। ऑर्डर की जाँच करें, फिर उसे प्रोसेस करें या भुगतान का रिफ़ंड करें।

Failed: नवीनतम भुगतान प्रयास विफल रहा या ग्राहक द्वारा रद्द कर दिया गया। ग्राहक फिर से भुगतान कर सकता है।

दोहराए गए या समानांतर कॉलबैक कभी भी डुप्लिकेट नोट, स्टॉक में कमी या ई-मेल नहीं बनाते हैं। यदि पहले से भुगतान किए गए ऑर्डर के दूसरे प्रयास का भुगतान किया जाता है, तो ऑर्डर फिर से नहीं बदला जाता है; एक Duplicate payment नोट आपको Paytrail Merchant Panel में इसे रिफ़ंड करने के लिए कहता है।

रिफ़ंड

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

यदि भुगतान विधि सीधे रिफ़ंड का समर्थन नहीं करती है, तो प्लगइन अपने-आप ई-मेल रिफ़ंड शुरू करता है: Paytrail ग्राहक को बैंक खाता दर्ज करने के लिए एक ई-मेल भेजता है। इसके लिए ऑर्डर पर एक बिलिंग ई-मेल की आवश्यकता होती है। ऑर्डर नोट बताता है कि किस प्रकार का रिफ़ंड शुरू किया गया था।

रिफ़ंड तुरंत पूरा हो सकता है या बाद में संसाधित हो सकता है। Paytrail की बाद की पुष्टि एक नोट के रूप में जोड़ी जाती है। यदि Paytrail रिफ़ंड पूरा नहीं कर सका, तो एक नोट कहता है कि ग्राहक को पैसा वापस नहीं किया गया था: इसे किसी अन्य तरीके से रिफ़ंड करें और WooCommerce रिफ़ंड को हटा दें। यदि Paytrail रिफ़ंड को तुरंत अस्वीकार कर देता है, तो WooCommerce त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं किया जाता है।

Paytrail Merchant Panel में किए गए रिफ़ंड वापस WooCommerce में सिंक नहीं होते हैं।

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

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

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

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

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

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

Paytrail चेकआउट पर दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है और या तो Test mode चालू है या Merchant ID और Secret key भरे हुए हैं। जाँचें कि स्टोर मुद्रा (या Pay for order पेज पर ऑर्डर मुद्रा) EUR है। सेटिंग्स पेज इनमें से प्रत्येक समस्या के लिए एक चेतावनी दिखाता है।

भुगतान हो गया, पर ऑर्डर Pending payment पर रहता है: कॉलबैक आपकी साइट तक नहीं पहुँच सकता, और ग्राहक स्टोर पर वापस नहीं आया। Orders अनुभाग में दिखाया गया कॉलबैक URL इंटरनेट से सुलभ होना चाहिए (कोई रखरखाव मोड, बुनियादी प्रमाणीकरण या रास्ते में फ़ायरवॉल नहीं)।

कॉलबैक या रिटर्न Payment verification failed. उत्तर देता है: हस्ताक्षर अमान्य है, या भुगतान ऑर्डर के किसी भुगतान प्रयास से संबंधित नहीं है। ऑर्डर नहीं बदला जाता है। जाँचें कि Secret key सही है और Merchant ID से संबंधित है।

भुगतान नहीं बनता है: ऑर्डर नोट और लॉग Paytrail त्रुटि दिखाते हैं, उदाहरण के लिए गलत क्रेडेंशियल के लिए Paytrail API error (401): …। Debug log चालू करें और WooCommerce > Status > Logs, स्रोत wcp_paytrail_gateway देखें।

Merchant ID सहेजा नहीं जाता है: इसमें केवल अंक होने चाहिए। इसे Paytrail Merchant Panel से दोबारा कॉपी करें।

ऑर्डर On hold है: ऑर्डर नोट पढ़ें। इसका कारण लंबित या विलंबित भुगतान, भिन्न भुगतान राशि, रद्दीकरण के बाद भुगतान या लाइव मोड में परीक्षण भुगतान है।

रिफ़ंड विफल होता है: संदेश पढ़ें। This order has no confirmed Paytrail payment. Refund it manually. का अर्थ है कि रिफ़ंड के लिए कोई पुष्ट Paytrail भुगतान नहीं है। अनुपलब्ध लाइव क्रेडेंशियल के बारे में संदेश का अर्थ है कि भुगतान लाइव मोड में किया गया था और लाइव क्रेडेंशियल सेट नहीं हैं। यदि भुगतान विधि केवल ई-मेल रिफ़ंड का समर्थन करती है, तो ऑर्डर में एक बिलिंग ई-मेल की आवश्यकता होती है।

डेवलपर हुक: ptg_payment_request फ़िल्टर भुगतान अनुरोध को हस्ताक्षर और भेजे जाने से पहले बदलता है; ptg_icon फ़िल्टर चेकआउट आइकन को बदलता है।

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

अनइंस्टॉल

प्लगइन को निष्क्रिय करने से सभी डेटा बना रहता है। इसे हटाने के लिए, Plugins पेज पर इसे निष्क्रिय करें और हटाएँ। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती है। गेटवे सेटिंग्स, इस प्लगइन का लॉग और ऑर्डर पर संग्रहीत Paytrail डेटा (भुगतान प्रयास, लेन-देन डेटा, रिफ़ंड रिकॉर्ड) केवल तभी हटाए जाते हैं जब Delete data on uninstall चालू था। अन्यथा वे बाद में पुनः इंस्टॉलेशन के लिए बने रहते हैं। मौजूदा ऑर्डर अपने भुगतान नोट और लेन-देन आईडी बनाए रखते हैं; Paytrail डेटा के बिना, पुराने ऑर्डरों का अब WooCommerce से रिफ़ंड नहीं किया जा सकता।

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