VibeFox Paytrail for OpenCart — सहायता

आवश्यकताएँ

OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या 4.0.2 और उसके बाद का संस्करण (4.1.0.3 पर परीक्षण किया गया)।

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

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

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

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

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

इंस्टॉलेशन

डाउनलोड एक zip फ़ाइल है, जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। उसे अपने कंप्यूटर पर अनज़िप करें। उसमें README.txt, OpenCart 3 का पैकेज wcp_paytrail_gateway-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज wcp_paytrail_gateway.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।

OpenCart 3

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_paytrail_gateway-oc3-(version).ocmod.zip चुनें। इस एक्सटेंशन में कोई OCMOD बदलाव नहीं है, इसलिए Extensions > Modifications को रीफ़्रेश करने की ज़रूरत नहीं है। इंस्टॉलर की जगह आप इस पैकेज के upload फ़ोल्डर की सामग्री को अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।

2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Paytrail Gateway ढूँढें और Install पर क्लिक करें (हरा + बटन)। आपके एडमिन उपयोगकर्ता के पास भुगतान एक्सटेंशन की सूची बदलने का अधिकार होना चाहिए।

3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। पेज के ऊपर वाले लाइसेंस ब्लॉक में License key में अपनी VibeFox लाइसेंस कुंजी चिपकाएँ और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।

4. पहले एक्सटेंशन आज़माने के लिए Test mode चालू करें। असली भुगतान के लिए उसे बंद करें और अपनी Merchant ID तथा Secret key डालें। Paytrail में कोई कॉलबैक URL सेट करने की ज़रूरत नहीं है।

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

OpenCart 4

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_paytrail_gateway.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।

2. इंस्टॉल किया गया पैकेज उसी पेज पर इंस्टॉल किए गए एक्सटेंशनों की सूची में दिखता है। उसके बगल में Install (हरा + बटन) पर क्लिक करें।

3. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Paytrail Gateway ढूँढें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर क्लिक करें।

4. लाइसेंस कुंजी और Paytrail सेटिंग्स वैसे ही डालें जैसे OpenCart 3 के चरण 3 से 5 में बताया गया है। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल कॉलबैक URL अलग है (देखें Orders)।

नई इंस्टॉलेशन में भुगतान विधि बंद और टेस्ट मोड बंद होता है।

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Paytrail Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। टेस्ट मोड चालू होने पर सेटिंग्स के ऊपर पेज टेस्ट मोड सक्रिय है। भुगतान Paytrail के सार्वजनिक परीक्षण खाते से होते हैं — कोई असली राशि नहीं काटी जाती। दिखाता है। लाइव मोड में यह चेतावनी देता है यदि मर्चेंट ID या सीक्रेट कुंजी गायब है, या यदि मर्चेंट ID सार्वजनिक परीक्षण खाता 375917 है; इन मामलों में चेकआउट पर Paytrail नहीं दिखता। यह चेतावनी भी देता है यदि स्टोर की डिफ़ॉल्ट मुद्रा EUR नहीं है: तब Paytrail केवल तभी दिखाया जाता है जब ग्राहक EUR में भुगतान करे। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

सेव करते समय Title खाली नहीं हो सकता और 128 अक्षरों से लंबा नहीं हो सकता, Sort Order पूर्ण संख्या होनी चाहिए (ऋणात्मक संख्याएँ स्वीकार्य हैं), Total 0 या उससे अधिक की संख्या होनी चाहिए, और geo zone तथा ऑर्डर स्टेटस मौजूद होने चाहिए; अन्यथा कुछ भी सेव नहीं होता। अंकों के अलावा कुछ भी रखने वाली मर्चेंट ID सेव नहीं होती: त्रुटि Paytrail मर्चेंट ID में केवल अंक होने चाहिए। पिछला मान रखा गया है। दिखती है, और बाकी सेटिंग्स सेव हो जाती हैं।

Paytrail

इस सेक्शन की शुरुआत Paytrail भुगतान पेज के बारे में एक छोटे नोट से होती है, और इस नियम से कि ऑर्डर को स्टेटस तभी मिलता है जब Paytrail भुगतान की पुष्टि कर दे।

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

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

Description: Confirm Order चरण पर पुष्टि बटन के ऊपर, Paytrail आइकन के बगल में ग्राहक को दिखाया जाने वाला पाठ। डिफ़ॉल्ट: Pay securely with Finnish online banking, card, mobile payment or invoice on the Paytrail payment page.

Sort Order: चेकआउट पर भुगतान विधियों के बीच Paytrail की स्थिति। खाली छोड़ें या पूर्ण संख्या लिखें।

Geo Zone: Paytrail केवल चुने हुए geo zone के भुगतान पते के लिए दिखाएँ। डिफ़ॉल्ट: All zones। Geo zones System > Localisation > Geo Zones में सेट होते हैं।

Total: स्टोर की डिफ़ॉल्ट मुद्रा में चेकआउट की वह कुल राशि जिस तक पहुँचने पर ही Paytrail दिया जाए। किसी भी राशि पर Paytrail दिखाने के लिए खाली छोड़ें।

API क्रेडेंशियल

आपकी मर्चेंट ID और सीक्रेट कुंजी Paytrail Merchant Panel (खाते या इंटीग्रेशन के विवरण) में दिखती हैं। इस सेक्शन में Paytrail का लिंक है। केवल EUR भुगतान समर्थित हैं।

Test mode: नए भुगतानों के लिए आपके अपने क्रेडेंशियल की जगह Paytrail का सार्वजनिक परीक्षण खाता (मर्चेंट ID 375917) उपयोग करता है। कोई असली राशि नहीं काटी जाती, और कोई कुंजी आवश्यक नहीं है। ग्राहकों को Confirm Order चरण पर टेस्ट मोड: कोई असली भुगतान नहीं किया जाएगा। दिखता है। परीक्षण खाते की सीक्रेट कुंजी सार्वजनिक है, इसलिए कोई भी टेस्ट मोड में किए गए भुगतान की नकल कर सकता है। लाइव स्टोर में टेस्ट मोड कभी चालू न रखें। डिफ़ॉल्ट: बंद।

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

Secret key: आपकी Paytrail सीक्रेट कुंजी। यह तब उपयोग होती है जब टेस्ट मोड बंद हो। सेव की गई कुंजी दोबारा कभी नहीं दिखाई जाती। फ़ील्ड खाली रहता है और सेव की गई — रखने के लिए खाली छोड़ें। दिखाता है। केवल तभी नया मान लिखें जब उसे बदलना हो। सेव की गई सीक्रेट कुंजी हटाने के लिए फ़ील्ड के नीचे Clear saved secret key पर टिक करें और Save पर क्लिक करें।

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

ऑर्डर

OpenCart, Confirm Order चरण पर ऑर्डर बिना स्टेटस के बनाता है (एक लापता ऑर्डर, missing order)। Paytrail द्वारा भुगतान की पुष्टि के बाद ही ऑर्डर को स्टेटस मिलता है। नीचे का हर स्टेटस फ़ील्ड आपके OpenCart ऑर्डर स्टेटस की सूची दिखाता है।

Callback URL: वह URL दिखाता है जिस पर Paytrail हर भुगतान की सर्वर-से-सर्वर पुष्टि करता है। OpenCart 3 में यह https://your-store/index.php?route=extension/payment/wcp_paytrail_gateway/callback जैसा दिखता है, और OpenCart 4 में https://your-store/index.php?route=extension/wcp_paytrail_gateway/payment/wcp_paytrail_gateway.callback जैसा। यह हर भुगतान के साथ भेजा जाता है, इसलिए Paytrail पैनल में कुछ भी कॉन्फ़िगर नहीं करना होता, पर स्टोर इंटरनेट से पहुँच योग्य होना चाहिए।

Order status after payment: भुगतान किए गए ऑर्डर का स्टेटस। डिफ़ॉल्ट: Processing। यदि हर भुगतान किया हुआ ऑर्डर तुरंत पूरा होना चाहिए, तो Complete चुनें।

Awaiting payment status: Paytrail भुगतान को लंबित या विलंबित बताता है (प्रदाता की मंज़ूरी का इंतज़ार करता इनवॉइस या किस्त)। जब Paytrail भुगतान की पुष्टि या अस्वीकृति करता है, तब ऑर्डर अपने-आप अपडेट होता है। डिफ़ॉल्ट: Pending।

Payment on hold status: भुगतान पर आपका ध्यान चाहिए (देखें ऑर्डर स्टेटस)। डिफ़ॉल्ट: Pending, क्योंकि OpenCart में On hold स्टेटस नहीं है। आप System > Localisation > Order Statuses में अपना स्टेटस बना सकते हैं और यहाँ चुन सकते हैं।

Payment failed status: प्रतीक्षारत Paytrail भुगतान विफल होने पर सेट होता है। डिफ़ॉल्ट: Failed।

Refunded status: ऑर्डर पेज से भुगतान की पूरी राशि लौटाने के बाद सेट होता है। डिफ़ॉल्ट: Refunded।

उन्नत

Debug log: API अनुरोधों और कॉलबैक को OpenCart के लॉग फ़ोल्डर (storage/logs) में ptg_debug.log.php में दर्ज करता है। यह फ़ाइल वेब से नहीं खोली जा सकती, और 5 MB पर इसे ptg_debug.old.log.php में ले जाया जाता है। व्यक्तिगत डेटा और कुंजियाँ दर्ज नहीं होतीं। त्रुटियाँ और चेतावनियाँ हमेशा दर्ज होती हैं। डिफ़ॉल्ट: बंद।

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

Delete data on uninstall: चालू होने पर एक्सटेंशन हटाने पर गेटवे सेटिंग्स और लॉग हट जाते हैं। एक्सटेंशन को बंद करने से कुछ भी नहीं हटता। ऑर्डरों के Paytrail लेन-देन डेटा हमेशा रखे जाते हैं, क्योंकि पुराने ऑर्डरों के रिफ़ंड को उसकी ज़रूरत होती है। डिफ़ॉल्ट: बंद।

इंपोर्ट / एक्सपोर्ट

Export: Download JSON सेटिंग्स को JSON फ़ाइल के रूप में सेव करता है। मर्चेंट ID और सीक्रेट कुंजी एक्सपोर्ट नहीं होतीं।

Import: पहले एक्सपोर्ट किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सेव की गई मर्चेंट ID और सीक्रेट कुंजी बनी रहती हैं।

चेकआउट

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

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

सफल भुगतान के बाद ग्राहक को आपका Paytrail भुगतान प्राप्त हो गया है। के साथ OpenCart का ऑर्डर सफलता पेज दिखता है। लंबित भुगतान के लिए पेज दिखाता है: आपका Paytrail भुगतान भुगतान प्रदाता द्वारा पुष्टि की प्रतीक्षा में है। ऑर्डर अपने-आप अपडेट हो जाएगा — कृपया दोबारा भुगतान न करें। यदि कॉलबैक उसी समय भुगतान दर्ज कर रहा हो, तो एक Payment confirmation पेज ग्राहक से दोबारा भुगतान न करने को कहता है और Check again देता है।

रद्द या विफल भुगतान के बाद ग्राहक Paytrail भुगतान रद्द हो गया या विफल हो गया। आप दोबारा प्रयास कर सकते हैं या कोई दूसरी भुगतान विधि चुन सकते हैं। के साथ चेकआउट पर लौटता है। यदि भुगतान अभी पूरा नहीं हुआ है, तो संदेश होता है Paytrail भुगतान अभी पूरा नहीं हुआ है। आप दोबारा प्रयास कर सकते हैं या कोई दूसरी भुगतान विधि चुन सकते हैं। कार्ट सुरक्षित रहता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखाए जाते हैं। ऐसी वापसी जिसे सत्यापित न किया जा सके, Payment verification failed. के साथ एक Payment Error पेज दिखाती है और कुछ नहीं बदलती।

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

OpenCart 3 हर बार Confirm Order चरण दिखने पर एक नया ऑर्डर बनाता है, OpenCart 4 चेकआउट के ऑर्डर को अपडेट करता है (एक नया प्रयास उसी ऑर्डर का भुगतान करता है)। यदि कार्ट पहले ही किसी दूसरे ऑर्डर से भुगतान किया जा चुका है, तो ग्राहक सीधे सफलता पेज पर जाता है और कोई नया भुगतान शुरू नहीं होता। Paytrail भुगतान API के ज़रिए रद्द नहीं किया जा सकता, इसलिए पुराना भुगतान पेज भी भुगतान योग्य रहता है। यदि ग्राहक उसका भी भुगतान कर देता है, तो दूसरा भुगतान भुगतान किए गए ऑर्डर पर वापस करने योग्य डुप्लिकेट के रूप में दर्ज होता है, और दूसरा ऑर्डर बिना स्टेटस के रहता है। कार्ट में कोई भी बदलाव, जिसमें नई मात्रा भी शामिल है, एक नया कार्ट माना जाता है जिसके लिए अपना भुगतान ज़रूरी है।

OpenCart 4 में ऑर्डर सफलता पेज दिखाए जाने तक चेकआउट में रखा जाता है। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद हो गया (उदाहरण के लिए आपने उसे रद्द किया), तो ग्राहक संदेश Your previous order was cancelled or refunded. Please confirm the order again to pay with a new order. के साथ चेकआउट पर लौट जाता है। यदि उसका लंबित भुगतान विफल हुआ था, तो संदेश The Paytrail payment was cancelled or failed. You can try again or choose another payment method. होता है। अगला Confirm Order एक नए ऑर्डर का भुगतान करता है। यदि वह ऑर्डर किसी पिछले कार्ट के लिए पहले ही भुगतान किया हुआ था और तब से कार्ट बदल गया है, तो ग्राहक चेकआउट पर वापस ले जाया जाता है, और अगला Confirm Order मौजूदा कार्ट के एक नए ऑर्डर का भुगतान करता है। बंद किया गया ऑर्डर कभी भुगतान किया हुआ नहीं दिखाया जाता।

स्टोर मेंटेनेंस मोड में होने पर भी कॉलबैक काम करता है, क्योंकि OpenCart भुगतान एक्सटेंशन के अनुरोधों को जाने देता है (OpenCart 4 पर एक्सटेंशन इसके लिए अपनी स्टार्टअप ऐक्शन जोड़ता है, जो ग्राहक की Paytrail से वापसी को भी जाने देती है)।

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

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

ऑर्डर स्टेटस

कोई स्टेटस नहीं (लापता ऑर्डर): ग्राहक को Paytrail पर भेजा गया और उसने भुगतान नहीं किया, भुगतान विफल हो गया, या Paytrail ने भुगतान की पुष्टि अभी तक नहीं की है। Sales > Orders में ऐसे ऑर्डर केवल तब दिखते हैं जब फ़िल्टर Order Status को Missing Orders पर सेट किया गया हो।

Order status after payment (डिफ़ॉल्ट Processing): भुगतान की पुष्टि हो गई है। एक नोट में Paytrail लेन-देन, Paytrail पर उपयोग की गई भुगतान विधि और राशि दिखती है; टेस्ट भुगतानों के लिए TEST mode — no real money. भी होता है।

Awaiting payment status (डिफ़ॉल्ट Pending): भुगतान प्रदाता के पास लंबित है (इनवॉइस या विलंबित भुगतान)। Paytrail भुगतान की पुष्टि करने पर ऑर्डर भुगतान किए गए स्टेटस में चला जाता है, और भुगतान विफल होने पर विफल स्टेटस में।

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

Payment failed status (डिफ़ॉल्ट Failed): एक लंबित Paytrail भुगतान विफल हो गया या रद्द कर दिया गया।

Refunded status (डिफ़ॉल्ट Refunded): एक्सटेंशन के माध्यम से भुगतान की पूरी राशि लौटाई गई।

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

नोट ऑर्डर की History की वे प्रविष्टियाँ हैं जिन्हें ग्राहक नहीं देखता।

VibeFox Paytrail Gateway टैब

Sales > Orders में Paytrail से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Paytrail Gateway टैब ऑर्डर के भुगतान प्रयासों की सूची दिखाता है (तारीख, Paytrail लेन-देन और स्टैम्प, जिस पर टेस्ट भुगतानों के लिए Test लेबल होता है, राशि, भुगतान विधि, Paytrail स्टेटस और परिणाम), Paid / refunded राशियाँ, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के Paytrail notes। यह टैब एक्सटेंशन तक पहुँच वाले उपयोगकर्ताओं को दिखाया जाता है।

रिफ़ंड

VibeFox Paytrail Gateway टैब में Amount डालें (जो राशि अभी रिफ़ंड नहीं हुई है, वह अपने-आप भर जाती है), चाहें तो ऑर्डर नोट के लिए कारण लिखें, और Refund via Paytrail पर क्लिक करें। प्रश्न की पुष्टि करें: क्या यह राशि Paytrail के माध्यम से रिफ़ंड करनी है? यह वापस नहीं हो सकता। पूर्ण और आंशिक रिफ़ंड दोनों समर्थित हैं, केवल राशि के आधार पर। आपको एक्सटेंशन बदलने का अधिकार चाहिए (System > Users > User Groups में सेट)। आप केवल उतनी राशि तक रिफ़ंड कर सकते हैं जितनी Paytrail ने वास्तव में ली है, इसलिए राशि के बेमेल होने पर सीमा ऑर्डर का कुल योग नहीं, बल्कि ग्राहक द्वारा दी गई राशि होती है। रिफ़ंड उस मोड के क्रेडेंशियल का उपयोग करता है जिसमें भुगतान हुआ था, इसलिए लाइव भुगतान के लिए लाइव क्रेडेंशियल सेट होने चाहिए। Paytrail द्वारा भुगतान की पुष्टि होने के बाद ही रिफ़ंड उपलब्ध होते हैं।

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

रिफ़ंड तुरंत पूरा हो सकता है या बाद में प्रोसेस हो सकता है। Paytrail की बाद की पुष्टि नोट के रूप में जुड़ती है। यदि Paytrail रिफ़ंड पूरा नहीं कर पाता, तो एक नोट बताता है कि पैसा ग्राहक को वापस नहीं हुआ, और वह रिफ़ंड अब लौटाया गया नहीं माना जाता; ग्राहक को किसी और तरीके से राशि लौटाएँ। यदि Paytrail रिफ़ंड को तुरंत अस्वीकार कर दे, तो टैब त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। पूर्ण रिफ़ंड ग्राहक को सूचित किए बिना और उत्पादों को स्टॉक में वापस किए बिना ऑर्डर को Refunded status पर सेट करता है, जैसे मैनुअल स्टेटस बदलाव। आंशिक रिफ़ंड स्टेटस नहीं बदलता।

Sales > Returns में उत्पाद वापसी से Paytrail के माध्यम से पैसा वापस नहीं जाता। Paytrail Merchant Panel में किए गए रिफ़ंड OpenCart के साथ सिंक नहीं होते।

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

यह एक्सटेंशन vibefox.net की VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Paytrail Gateway Extensions > Extensions > Payments > VibeFox Paytrail Gateway > Edit पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को मास्क करके, स्टेटस (जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन) और ये बटन दिखाता है: स्टेटस दोबारा जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: opencart-payment-paytrail की पंक्ति और Manage licenses and domains in your account लिंक है, जो आपका vibefox.net खाता खोलता है। एक्सटेंशन के लिए Modify अधिकार वाले एडमिन उपयोगकर्ता ही कुंजी बदल सकते हैं। ब्लॉक के पाठ एडमिन की भाषा का पालन करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

यदि कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, जैसे Key not found, This key belongs to another product, Domain limit reached, या License expired on के साथ एक तारीख। स्टोर का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक नहीं पहुँचा जा सकता, तो एक्सटेंशन अंतिम ज्ञात स्टेटस पर काम करता रहता है।

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

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

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

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

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

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

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

कॉलबैक Temporarily unavailable उत्तर देता है: उसी समय कोई दूसरा अनुरोध ऑर्डर की पुष्टि कर रहा था, या ऑर्डर स्टेटस सेट नहीं हो सका। Paytrail दोबारा कॉल करेगा। कारण के लिए Log फ़ील्ड देखें।

Confirm Order के बाद ग्राहक को त्रुटि दिखती है: एक्सटेंशन पेज पर Log फ़ील्ड देखें। उदाहरण के लिए, Paytrail API error (401) का अर्थ है गलत क्रेडेंशियल। अधिक विवरण के लिए Debug log चालू करें। This payment method is not available. Please reload the checkout page. का अर्थ है कि इस बीच भुगतान विधि बंद कर दी गई या चेकआउट अब ऑर्डर से मेल नहीं खाता।

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

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

रिफ़ंड विफल होता है: संदेश पढ़ें। This order has no confirmed Paytrail payment. Refund it manually. का अर्थ है कि रिफ़ंड करने के लिए कोई पुष्ट Paytrail भुगतान नहीं है। The live Paytrail credentials used for this payment are missing. Enter them in the Paytrail settings. का अर्थ है कि भुगतान लाइव मोड में हुआ था और लाइव क्रेडेंशियल सेट नहीं हैं। Invalid refund amount: at most … का अर्थ है कि राशि शेष रिफ़ंड योग्य राशि से अधिक है। This payment method supports only e-mail refunds, but the order has no billing e-mail. का अर्थ है कि ऑर्डर को ग्राहक के ईमेल की आवश्यकता है।

डेवलपर्स के लिए: भुगतान अनुरोध पर हस्ताक्षर करके भेजे जाने से पहले, एक्सटेंशन अनुरोध और ऑर्डर के साथ OpenCart इवेंट ptg_payment_request ट्रिगर करता है।

अनइंस्टॉल

Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox Paytrail Gateway के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटा दिए जाते हैं। OpenCart एक्सटेंशन की अपनी सेटिंग्स हमेशा हटा देता है: Enable/Disable, Sort Order, Geo Zone, Total और Orders सेक्शन के ऑर्डर स्टेटस, जो दोबारा इंस्टॉल करने पर अपने डिफ़ॉल्ट मानों पर लौट आते हैं। एक्सटेंशन का OpenCart इवेंट भी हटा दिया जाता है (OpenCart 4 पर उसके इवेंट और स्टार्टअप ऐक्शन भी, जो मेंटेनेंस मोड में कॉलबैक और ग्राहक की वापसी को जाने देती है, हटा दिए जाते हैं)। यदि Delete data on uninstall चालू है, तो बाकी गेटवे सेटिंग्स (शीर्षक, विवरण, टेस्ट मोड, मर्चेंट ID, सीक्रेट कुंजी, लॉगिंग) और लॉग हटा दिए जाते हैं। यदि यह बंद है, तो वे बाद में दोबारा इंस्टॉल करने के लिए रखे जाते हैं। Paytrail लेन-देन और रिफ़ंड हमेशा रखे जाते हैं, इसलिए पहले भुगतान किए गए ऑर्डर दोबारा इंस्टॉल करने के बाद भी रिफ़ंड किए जा सकते हैं। मौजूदा ऑर्डर अपने भुगतान नोट रखते हैं।

OpenCart 4 पर एक्सटेंशन की फ़ाइलें भी हटाने के लिए अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल किए गए एक्सटेंशनों की सूची में VibeFox Paytrail Gateway के बगल में Uninstall (नारंगी − बटन) पर क्लिक करें, और फिर अपलोड किया गया पैकेज हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।

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