VibeFox Pin Payments for OpenCart — सहायता

आवश्यकताएँ

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

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

Pin Payments खाता: एक Pin Payments मर्चेंट खाता (ऑस्ट्रेलिया या न्यूज़ीलैंड के व्यवसायों के लिए; ग्राहक कहीं से भी भुगतान कर सकते हैं)। आपको इसकी publishable key और secret key चाहिए, लाइव के लिए, और परीक्षण के लिए test environment की। कोई webhook secret आवश्यक नहीं है: एक्सटेंशन webhooks का उपयोग नहीं करता। कार्ड का विवरण Pin.js के ज़रिए ग्राहक के ब्राउज़र से सीधे Pin Payments तक जाता है और कभी आपके स्टोर तक नहीं पहुँचता, इसलिए स्टोर PCI SAQ A-EP के अंतर्गत आता है।

मुद्रा: AUD, USD, NZD, SGD, EUR, GBP, CAD, HKD, JPY, MYR, THB, PHP, ZAR या IDR। ऑर्डर उसकी अपनी मुद्रा में चार्ज होता है।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. Pin Payments डैशबोर्ड में Account > API Keys खोलें और अपनी परीक्षण कुंजियाँ Test publishable key और Test secret key में कॉपी करें। Test mode चालू रहने दें, Enable/Disable चालू करें और Save पर क्लिक करें।

5. Pin Payments के परीक्षण कार्ड से एक परीक्षण ऑर्डर दें। जब सब कुछ काम करने लगे, तब लाइव कुंजियाँ दर्ज करें, Test mode बंद करें और सहेजें।

OpenCart 4

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

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

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

4. लाइसेंस कुंजी और Pin Payments कुंजियाँ वैसे ही डालें जैसे OpenCart 3 के चरण 3 से 5 में बताया गया है। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं।

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Pin Payments Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सहेजता है। सेटिंग्स के ऊपर पेज, जब test mode चालू हो, यह दिखाता है: Pin Payments TEST MODE में है: test API और test keys का उपयोग हो रहा है, कोई असली शुल्क नहीं लिया जाता। जब वर्तमान मोड की publishable key या secret key खाली हो, तो एक त्रुटि दिखती है (तब चेकआउट पर भुगतान विधि छिपी रहती है); और जब Pin Payments स्टोर की डिफ़ॉल्ट मुद्रा का समर्थन न करे, तो समर्थित मुद्राओं की सूची के साथ एक त्रुटि दिखती है। एक्सटेंशन बदलने के अधिकार के बिना पेज सेटिंग्स दिखाता है, पर उन्हें सहेज नहीं सकता।

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

Pin Payments

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

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

Description: Confirm Order चरण पर कार्ड फ़ॉर्म के ऊपर ग्राहक को दिखाया गया पाठ। डिफ़ॉल्ट: Pay with your credit card via Pin Payments.

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

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

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

API कुंजियाँ

आपकी कुंजियाँ Pin Payments डैशबोर्ड में Account > API Keys के अंतर्गत मिलती हैं (यह पेज dashboard.pinpayments.com से लिंक करता है)। परीक्षण कुंजियाँ केवल test API के साथ और लाइव कुंजियाँ केवल live API के साथ काम करती हैं। publishable key ग्राहक के ब्राउज़र में Pin.js उपयोग करता है। secret key आपके सर्वर से कभी बाहर नहीं जाती।

Test mode: Pin Payments के test environment (test-api.pinpayments.com) और test keys का उपयोग करता है। कोई असली शुल्क नहीं लिया जाता, और ग्राहकों को कार्ड फ़ॉर्म के ऊपर TEST MODE — no real charges will be made. दिखता है। बंद होने पर live API और live keys का उपयोग होता है। किसी ऑर्डर का रिफ़ंड हमेशा उसी environment की keys से होता है जिसमें ऑर्डर का भुगतान हुआ था। डिफ़ॉल्ट: चालू।

Test publishable key: आपके Pin Payments परीक्षण खाते की publishable key।

Test secret key: आपके Pin Payments परीक्षण खाते की secret key।

Live publishable key: आपके Pin Payments लाइव खाते की publishable key।

Live secret key: आपके Pin Payments लाइव खाते की secret key।

कुंजियों के आसपास के खाली स्थान हटा दिए जाते हैं। सहेजी गई secret keys दोबारा कभी नहीं दिखाई जातीं। फ़ील्ड खाली रहता है और सहेजा गया — रखने के लिए खाली छोड़ें। दिखाता है। केवल बदलने के लिए नया मान दर्ज करें। सहेजी गई secret key हटाने के लिए, फ़ील्ड के नीचे Clear the saved value on save चिह्नित करें और Save पर क्लिक करें।

ऑर्डर

OpenCart Confirm Order चरण पर ऑर्डर बिना स्टेटस के बनाता है (लापता ऑर्डर)। ऑर्डर को स्टेटस तभी मिलता है जब Pin Payments चार्ज का उत्तर दे दे। नीचे का हर फ़ील्ड आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध करता है।

Order Status After Payment: कार्ड से ठीक ऑर्डर की राशि और मुद्रा में शुल्क लिया गया। डिफ़ॉल्ट: Processing।

On Hold (Review) Status: चार्ज की गई राशि या मुद्रा ऑर्डर से अलग है, चार्ज अधिकृत है पर कैप्चर नहीं हुआ है, या Pin Payments से कोई स्पष्ट उत्तर नहीं मिला (टाइमआउट, सर्वर त्रुटि), इसलिए चार्ज मौजूद हो सकता है। एक नोट बताता है कि Pin Payments डैशबोर्ड में क्या जाँचना है। डिफ़ॉल्ट: Pending, क्योंकि OpenCart में On hold स्टेटस नहीं है। आप System > Localisation > Order Statuses में अपना स्टेटस बना सकते हैं और यहाँ चुन सकते हैं।

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

एडवांस्ड

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

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

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

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

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

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

चेकआउट

भुगतान विधि तब दिखती है जब वह सक्षम हो, वर्तमान मोड की दोनों कुंजियाँ सेट हों, ऑर्डर की मुद्रा 14 समर्थित मुद्राओं में से एक हो, भुगतान पता चुने हुए Geo Zone में हो, और ऑर्डर Total तक पहुँचे।

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit card (Pin Payments))। OpenCart Confirm Order चरण पर ऑर्डर बनाता है, तब भी बिना स्टेटस के। वहाँ ग्राहक को आपका विवरण, Visa, Mastercard और American Express के आइकन और कार्ड फ़ॉर्म दिखता है: Card number, Expiry (MM / YY), CVC और Name on card। OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, Payment method options विंडो में भुगतान विधि चुनता है; तब कार्ड फ़ॉर्म चेकआउट पेज के नीचे, Confirm Order बटन के ऊपर, पुष्टि ब्लॉक में दिखता है। भेजने से पहले फ़ॉर्म कार्ड नंबर की लंबाई, समाप्ति का महीना और वर्ष, 3 या 4 अंकों का CVC, और नाम जाँचता है।

जब ग्राहक Confirm Order पर क्लिक करता है, तो Pin.js कार्ड का विवरण और ऑर्डर का भुगतान पता (OpenCart 4 पर, जब चेकआउट भुगतान पता नहीं माँगता, तो शिपिंग पता) ब्राउज़र से सीधे Pin Payments को भेजता है और एक बार उपयोग होने वाला कार्ड टोकन प्राप्त करता है। केवल यह टोकन आपके स्टोर तक आता है। फिर एक्सटेंशन ऑर्डर की मुद्रा में ऑर्डर कुल के लिए एक कैप्चर्ड चार्ज बनाता है, जिसमें ग्राहक का ईमेल और IP पता तथा विवरण <store name> - Order <order number> होता है। Pin Payments उसी अनुरोध में उत्तर देता है।

सफल चार्ज के बाद ऑर्डर को OpenCart के सामान्य तरीके से स्टेटस मिलता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट होता है, कार्ट खाली हो जाता है, और ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है, जिस पर Your card payment has been received. लिखा होता है। यदि ऑर्डर समीक्षा स्टेटस में गया है, तो पेज दिखाता है: आपका कार्ड भुगतान प्राप्त हो गया है और उसकी समीक्षा हो रही है। समीक्षा पूरी होते ही हम आपका ऑर्डर अपडेट करेंगे।

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

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

OpenCart 4 में ऑर्डर सफलता पेज दिखाए जाने तक चेकआउट में रखा जाता है। यदि ग्राहक नई खरीद की पुष्टि करते समय उस ऑर्डर पर पहले से कोई स्टेटस हो (उदाहरण के लिए उसका भुगतान हो गया था पर सफलता पेज कभी नहीं खुला, या आपने उसे रद्द किया), तो ग्राहक चेकआउट पर लौट जाता है, और अगला Confirm Order मौजूदा कार्ट का एक नया ऑर्डर चुकाता है। चेकआउट पेज के ऊपर ग्राहक को Your previous order was cancelled or refunded by the store. Please confirm the order again to pay with a new order. दिखता है, जब ऑर्डर बंद हो चुका हो, या Your previous order #(संख्या) has already been placed. Your cart has changed: please confirm the new order to pay for it. जब वह किसी पिछले कार्ट के लिए दर्ज हुआ हो। किसी अलग कार्ट के लिए भुगतान किया हुआ ऑर्डर कभी भुगतान किया हुआ नहीं दिखाया जाता।

भुगतान विफल होने पर ऑर्डर बिना स्टेटस के रहता है। ग्राहक Confirm Order चरण पर रहता है, कार्ट बना रहता है, और कार्ड फ़ॉर्म के ऊपर इनमें से एक संदेश दिखता है: आपका कार्ड अस्वीकार कर दिया गया। कृपया कोई दूसरा कार्ड उपयोग करें या अपने बैंक से संपर्क करें।; आपके कार्ड में पर्याप्त राशि नहीं है। कृपया कोई दूसरा कार्ड उपयोग करें।; आपके कार्ड की अवधि समाप्त हो गई है। कृपया कोई दूसरा कार्ड उपयोग करें।; कार्ड का सुरक्षा कोड (CVC) गलत है।; यह कार्ड प्रकार स्वीकार नहीं किया जाता। कृपया Visa, Mastercard या American Express उपयोग करें।; भुगतान विफल: अस्वीकृत विवरण के लिए Pin Payments द्वारा दिए गए कारण के साथ; आपके कार्ड का विवरण समाप्त हो गया है। कृपया इसे दोबारा दर्ज करके पुनः प्रयास करें।, जब टोकन उपयोग नहीं किया जा सकता; सुरक्षित कार्ड फ़ॉर्म लोड नहीं हो सका। कृपया पेज दोबारा लोड करें या कोई दूसरी भुगतान विधि चुनें।, जब Pin.js लोड नहीं होता; कार्ड भुगतान अभी अस्थायी रूप से उपलब्ध नहीं हैं। कृपया बाद में पुनः प्रयास करें या कोई दूसरी भुगतान विधि चुनें।, जब Pin Payments secret key अस्वीकार करता है; आपका भुगतान संसाधित नहीं हो सका। कृपया पुनः प्रयास करें या कोई दूसरी भुगतान विधि चुनें।, अन्य त्रुटियों के लिए। तकनीकी कारण लॉग में लिखा जाता है।

इस एक्सटेंशन में 3-D Secure फ़्लो नहीं है। यदि आपके Pin Payments खाते में 3-D Secure आवश्यक है, तो चार्ज लंबित रहता है, ऑर्डर को कोई स्टेटस नहीं मिलता, और ग्राहक को आपका कार्ड भुगतान पूरा नहीं हो सका (अतिरिक्त सत्यापन आवश्यक है)। कृपया कोई दूसरा कार्ड या दूसरी भुगतान विधि आज़माएँ। दिखता है। बाद में कैप्चर के साथ केवल-प्राधिकरण मोड, सेव किए गए कार्ड, सब्सक्रिप्शन, Apple Pay या Google Pay, और webhooks उपलब्ध नहीं हैं।

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

ऑर्डर स्टेटस

कोई स्टेटस नहीं (लापता ऑर्डर): कार्ड अस्वीकार हुआ, चार्ज को 3-D Secure चाहिए था, या ग्राहक ने भुगतान नहीं किया। Sales > Orders में ऐसे ऑर्डर केवल तब दिखते हैं जब Order Status फ़िल्टर Missing Orders पर सेट हो।

Order Status After Payment (डिफ़ॉल्ट Processing): Pin Payments ने ठीक ऑर्डर की राशि और मुद्रा में एक सफल, कैप्चर्ड चार्ज की रिपोर्ट दी। एक नोट राशि और चार्ज टोकन दिखाता है (परीक्षण भुगतानों के लिए TEST MODE भी)।

On Hold (Review) Status (डिफ़ॉल्ट Pending): चार्ज को आपकी समीक्षा चाहिए। नोट कारण बताता है: Pin Payments ने ऑर्डर से अलग राशि या मुद्रा चार्ज की, चार्ज अधिकृत है पर कैप्चर नहीं हुआ (इसे Pin Payments डैशबोर्ड में कैप्चर करें, फिर ऑर्डर स्टेटस बदलें), या Pin Payments से स्पष्ट उत्तर नहीं मिला (ऑर्डर भेजने से पहले Pin Payments डैशबोर्ड में चार्ज का विवरण खोजें)।

Refunded Status (डिफ़ॉल्ट Refunded): चार्ज एक्सटेंशन के माध्यम से पूरी तरह रिफ़ंड किया गया।

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

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

VibeFox Pin Payments Gateway tab

Sales > Orders में Pin Payments से भुगतान किया हुआ ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Pin Payments Gateway टैब में परीक्षण भुगतानों के लिए Test लेबल के साथ Charge टोकन, Status, Card ब्रांड और अंतिम चार अंक, Charged / order / refunded राशियाँ, Charge description, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के Pin Payments notes दिखते हैं। यह टैब उन उपयोगकर्ताओं को दिखता है जिनके पास एक्सटेंशन की पहुँच है।

रिफ़ंड

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

जब ऑर्डर के लिए कोई चार्ज दर्ज नहीं है (Pin Payments से स्पष्ट उत्तर नहीं मिला), तो टैब रिफ़ंड फ़ॉर्म नहीं दिखाता, और बताता है कि Pin Payments डैशबोर्ड में कौन-सा विवरण खोजना है।

Sales > Returns में उत्पाद की वापसी Pin Payments के माध्यम से पैसे वापस नहीं भेजती। Pin Payments डैशबोर्ड में किए गए रिफ़ंड OpenCart में वापस सिंक नहीं होते, इसलिए उन्हें ऑर्डर पेज से करें।

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

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

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

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

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

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

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

चेकआउट पर Pin Payments दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, वर्तमान मोड की दोनों कुंजियाँ भरी हुई हैं (परीक्षण मोड में Test publishable key और Test secret key, अन्यथा लाइव कुंजियाँ), और ऑर्डर की मुद्रा 14 समर्थित मुद्राओं में से एक है। यह भी जाँचें कि भुगतान पता चुने हुए Geo Zone में है और ऑर्डर सेटिंग्स में तय Total तक पहुँचता है। सेटिंग्स पेज कुंजियाँ गायब होने पर और स्टोर की असमर्थित मुद्रा के लिए त्रुटि दिखाता है।

भुगतान हो गया, पर ऑर्डर समीक्षा स्टेटस में है: VibeFox Pin Payments Gateway टैब के नोट पढ़ें (देखें ऑर्डर स्टेटस)। यदि Pin Payments ने स्पष्ट उत्तर नहीं दिया, तो Pin Payments डैशबोर्ड में <store name> - Order <order number> विवरण वाला चार्ज खोजें, फिर ऑर्डर पूरा करें या डैशबोर्ड में चार्ज रिफ़ंड करें।

ग्राहक को «Your payment was received, but the order could not be completed automatically» दिखता है: कार्ड पर चार्ज हो गया, पर ऑर्डर स्टेटस सेट नहीं हो सका (उदाहरण के लिए, इस बीच ऑर्डर हटा दिया गया)। कारण लॉग में है। ग्राहक से कहा जाता है कि वह दोबारा भुगतान न करे; वही कार्ट दोबारा भेजने पर बिना नए चार्ज के ऑर्डर को स्टेटस मिल जाता है।

ग्राहक को «This payment method is not available. Please reload the checkout page.» दिखता है: चेकआउट सत्र अब ऑर्डर से मेल नहीं खाता, या भुगतान विधि इस बीच बंद कर दी गई। ग्राहक चेकआउट पेज दोबारा लोड करता है।

ग्राहकों को «Card payments are temporarily unavailable» दिखता है: Pin Payments ने secret key अस्वीकार कर दी, या वर्तमान मोड की कुंजी गायब है। परीक्षण कुंजियाँ केवल परीक्षण मोड में, और लाइव कुंजियाँ केवल लाइव मोड में काम करती हैं। लॉग कारण दिखाता है।

«additional verification is required» के साथ ऑर्डर विफल होते हैं: आपके Pin Payments खाते में 3-D Secure आवश्यक है, जिसे एक्सटेंशन समर्थित नहीं करता। Pin Payments से अनिवार्य 3-D Secure बंद करने को कहें।

सुरक्षित कार्ड फ़ॉर्म लोड नहीं हो सका: Pin Payments के CDN से Pin.js ब्राउज़र में लोड नहीं हुआ, उदाहरण के लिए किसी script blocker या ऐसे एक्सटेंशन के कारण जो scripts को जोड़ता या बदलता है। चेकआउट को ऐसे ऑप्टिमाइज़ेशन से बाहर रखें।

Pin Payments ने उत्तर नहीं दिया: ब्राउज़र में 30 सेकंड के भीतर कार्ड टोकन नहीं बना। ग्राहक कनेक्शन जाँचकर दोबारा प्रयास कर सकता है; कोई शुल्क नहीं लिया गया।

Pin Payments के कारण से भुगतान विफल: Pin Payments ने चार्ज का विवरण अस्वीकार किया, उदाहरण के लिए मुद्रा के न्यूनतम चार्ज से कम राशि। ग्राहक को कारण दिखता है, और लॉग में त्रुटि कोड होता है।

रिफ़ंड विफल होता है: टैब का संदेश पढ़ें। TEST या LIVE मोड से जुड़ा संदेश बताता है कि जिस मोड में ऑर्डर का भुगतान हुआ था उसकी secret key खाली है। Pin Payments did not confirm the refund का अर्थ है कि कोई उत्तर नहीं आया; दोबारा प्रयास करने से पहले Pin Payments डैशबोर्ड में चार्ज जाँचें। at most चार्ज से अभी रिफ़ंड की जा सकने वाली राशि दिखाता है।

परीक्षण भुगतान: परीक्षण मोड test environment और test keys का उपयोग करता है। Pin Payments के डेवलपर दस्तावेज़ों के परीक्षण कार्ड उपयोग करें, जैसे 4200 0000 0000 0000 (सफल), किसी भी भविष्य की समाप्ति तिथि और किसी भी CVC के साथ। ऑर्डर उसी मोड को बनाए रखते हैं जिसमें उनका भुगतान हुआ था, इसलिए मोड बदलने के बाद भी रिफ़ंड सही environment में जाते हैं।

त्रुटियाँ कहाँ मिलेंगी: त्रुटियाँ हमेशा लॉग में लिखी जाती हैं; एक्सटेंशन पेज पर Log फ़ील्ड देखें। हर API कॉल देखने के लिए Debug log चालू करें।

अनइंस्टॉल

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

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

Pin Payments अपने-अपने स्वामी का ट्रेडमार्क है। यह एक्सटेंशन Pin Payments से संबद्ध नहीं है और Pin Payments द्वारा समर्थित नहीं है।