VibeFox PayPal for OpenCart — सहायता

आवश्यकताएँ

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

PHP: 8.0 या उसके बाद।

PayPal खाता: PayPal Developer Dashboard में REST API ऐप वाला PayPal Business खाता। आपको ऐप की Client ID और Secret चाहिए। Sandbox और live ऐप्स के क्रेडेंशियल अलग होते हैं। वेबहुक की ज़रूरत नहीं है: एक्सटेंशन हर भुगतान को आपके सर्वर पर पुष्ट करता है, जब ग्राहक चेकआउट पर होता है।

मुद्रा: PayPal द्वारा समर्थित मुद्राओं में से एक: AUD, BRL, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HKD, HUF, ILS, JPY, MXN, MYR, NOK, NZD, PHP, PLN, SEK, SGD, THB, TWD या USD।

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

इंस्टॉलेशन

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

OpenCart 3

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

2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox PayPal Gateway खोजें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन यूज़र को payment extensions की सूची बदलने का अधिकार चाहिए।

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

4. PayPal Developer Dashboard में REST API ऐप (sandbox और/या live) बनाएँ और उसकी Client ID व Secret को API credentials सेक्शन में कॉपी करें।

5. Capture या Authorize चुनें, Enable/Disable चालू करें और Save पर क्लिक करें।

6. PayPal sandbox buyer खाते से टेस्ट करें, फिर Sandbox mode बंद करें और live क्रेडेंशियल दर्ज करें।

OpenCart 4

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

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

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

4. OpenCart 3 के चरण 3 से 6 की तरह लाइसेंस कुंजी, PayPal क्रेडेंशियल और भुगतान क्रिया दर्ज करें। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। यह एक्सटेंशन OpenCart 4 के साथ आने वाले PayPal एक्सटेंशन को नहीं छूता: दोनों एक ही स्टोर में इंस्टॉल हो सकते हैं।

नया इंस्टॉल भुगतान तरीका बंद और sandbox मोड चालू के साथ शुरू होता है।

Configuration

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox PayPal Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर पेज चेतावनी देता है जब भुगतान तरीका चालू हो पर चुने गए मोड की Client ID या Secret खाली हो, और जब PayPal स्टोर की डिफ़ॉल्ट मुद्रा को समर्थन न दे। दोनों स्थितियों में चेकआउट पर भुगतान तरीका छिपा रहता है। Sandbox मोड चालू होने पर पेज Sandbox mode is on: payments go to the PayPal sandbox, no real money is moved. दिखाता है। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

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

सामान्य

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

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

Description: Confirm Order चरण पर, PayPal बटन के ऊपर ग्राहक को दिखाया गया पाठ। डिफ़ॉल्ट: Pay with your PayPal account or a card via PayPal.

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

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

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

API credentials

PayPal Developer Dashboard में REST API ऐप बनाएँ और उसकी Client ID व Secret कॉपी करें। इस सेक्शन में sandbox ऐप्स और live ऐप्स के लिंक हैं। केवल चुने गए मोड के फ़ील्ड दिखते हैं; दोनों मोड के क्रेडेंशियल सेव रहते हैं।

Sandbox mode: भुगतान sandbox क्रेडेंशियल से PayPal sandbox पर जाते हैं; कोई असली पैसा नहीं चलता। डिफ़ॉल्ट: चालू। असली भुगतान लेने के लिए इसे बंद करें। कैप्चर, void और रिफ़ंड हमेशा उसी वातावरण का इस्तेमाल करते हैं जिसमें ऑर्डर का भुगतान हुआ था। चालू रहने पर ग्राहक Confirm Order चरण पर Sandbox mode: pay with a PayPal sandbox buyer account — no real money is charged. देखता है।

Sandbox Client ID: आपके sandbox REST API ऐप की Client ID।

Sandbox Secret: आपके sandbox REST API ऐप का Secret।

Live Client ID: आपके live REST API ऐप की Client ID।

Live Secret: आपके live REST API ऐप का Secret।

सेव किए गए secret दोबारा कभी नहीं दिखाए जाते। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलना हो तो ही नया मान दर्ज करें। सेव किया गया secret हटाने के लिए फ़ील्ड के नीचे Clear the saved secret on save चेक करें और Save पर क्लिक करें।

भुगतान

Payment action: ग्राहक भुगतान स्वीकृत करे तो क्या होता है। डिफ़ॉल्ट: Capture।

ऑर्डर

OpenCart Confirm Order चरण पर ऑर्डर बिना स्टेटस के बनाता है (एक लापता ऑर्डर)। ऑर्डर को स्टेटस तभी मिलता है जब PayPal आपके सर्वर पर कैप्चर या authorization का जवाब दे दे। अस्वीकृत भुगतान ऑर्डर को बिना स्टेटस के छोड़ देता है, और ग्राहक Confirm Order चरण पर रहता है। नीचे के हर फ़ील्ड में आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध हैं।

Order Status After Payment: कैप्चर पूरा हो गया है, जिसमें authorization कैप्चर होने या ऑर्डर टैब में लंबित कैप्चर पूरा होने पर भी। डिफ़ॉल्ट: Processing।

Awaiting Payment Status: कैप्चर PayPal पर PENDING है (भुगतान समीक्षा में, राशि अभी जमा नहीं हुई)। डिफ़ॉल्ट: Pending।

Authorized Status: भुगतान क्रिया Authorize: राशि रोकी गई है, अभी भुगतान नहीं हुआ। डिफ़ॉल्ट: Pending।

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

Voided Status: ऑर्डर टैब में authorization void किया गया और रोकी गई राशि छोड़ दी गई। डिफ़ॉल्ट: Canceled।

Refunded Status: भुगतान पूरी तरह रिफ़ंड हो गया है। आंशिक रिफ़ंड केवल एक नोट जोड़ते हैं। डिफ़ॉल्ट: Refunded।

Failed Status: PayPal ने लंबित कैप्चर को अस्वीकार कर दिया। डिफ़ॉल्ट: Failed।

Advanced

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

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

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

Import / Export

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

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

चेकआउट

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

ग्राहक PayPal विंडो में PayPal खाते या PayPal द्वारा दिए गए किसी अन्य फ़ंडिंग स्रोत से भुगतान स्वीकृत करता है। चेकआउट तब PayPal payment approved. Completing your order… दिखाता है और ऑर्डर अपने-आप पूरा कर देता है। यदि ग्राहक बिना भुगतान स्वीकृत किए Confirm Order पर क्लिक करता है, तो संदेश होता है Please click the PayPal button and approve the payment first.

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

यदि स्वीकृति के बाद ऑर्डर कुल बदल गया है, तो कुछ भी कैप्चर नहीं होता। ग्राहक को The order total changed after you approved the payment in PayPal. Please click the PayPal button again to approve the new total. दिखता है। यदि PayPal भुगतान अस्वीकार करता है, तो ऑर्डर बिना स्टेटस के रहता है और ग्राहक से PayPal बटन फिर से क्लिक करने या भुगतान का कोई दूसरा तरीका चुनने को कहा जाता है। यदि ग्राहक PayPal विंडो बंद कर देता है, तो चेकआउट पर You cancelled the PayPal payment. दिखता है।

यदि कैप्चर के दौरान PayPal जवाब नहीं देता, तो ग्राहक को We could not confirm your PayPal payment yet. Please try again in a moment — you will not be charged twice. दिखता है। स्वीकृति इस कार्ट के लिए सुरक्षित रहती है, पेज रीलोड होने के बाद भी: चेकआउट पर PayPal payment approved. Click "Confirm Order" to complete it. दिखता है और Confirm Order उसी स्वीकृति को फिर से इस्तेमाल करता है। यदि PayPal ने पिछला प्रयास पूरा कर दिया था, तो वही भुगतान इस्तेमाल होता है और नई स्वीकृति कैप्चर नहीं होती। यदि भुगतान लिया जा चुका है पर ऑर्डर का स्टेटस सेट नहीं हो सका, तो ग्राहक को Your payment was received, but the order could not be completed automatically. Please contact us — do not pay again. दिखता है। अगला प्रयास सेव किए गए भुगतान से स्टेटस सेट करता है, दोबारा शुल्क लिए बिना।

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

OpenCart 4 सफलता पेज दिखने तक चेकआउट में ऑर्डर रखता है। यदि वह ऑर्डर इस बीच बंद हो गया (उदाहरण के लिए आपने उसे रद्द किया या लंबित कैप्चर अस्वीकृत हुआ), या वह पहले के कार्ट के लिए पहले ही भुगतान किया जा चुका था, तो ग्राहक को Your previous order of this checkout is already closed or paid. Please refresh the page and confirm the order again — a new order will be created. दिखता है। पेज रीलोड होने के बाद अगला भुगतान एक नए ऑर्डर का भुगतान करता है। भुगतान किया गया ऑर्डर कभी किसी दूसरे कार्ट के लिए भुगतान किया हुआ नहीं दिखाया जाता।

इस एक्सटेंशन में PayPal वेबहुक, Pay Later संदेश, कार्ड फ़ील्ड, Venmo, Apple Pay, Google Pay या Fastlane, सेव किए गए भुगतान तरीके या सब्सक्रिप्शन, और उत्पाद या कार्ट पेजों पर बटन नहीं हैं। OpenCart चेकआउट में दर्ज किए गए पते इस्तेमाल होते हैं, PayPal से लिया गया पता नहीं।

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

ऑर्डर स्टेटस

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

भुगतान के बाद ऑर्डर स्टेटस (डिफ़ॉल्ट Processing): कैप्चर पूरा हो गया। एक नोट में PayPal ऑर्डर, राशि और कैप्चर दिखते हैं।

Authorized स्टेटस (डिफ़ॉल्ट Pending): भुगतान ऑथराइज़ हुआ और कैप्चर का इंतज़ार कर रहा है (भुगतान क्रिया Authorize)।

Awaiting भुगतान स्टेटस (डिफ़ॉल्ट Pending): कैप्चर PayPal पर PENDING है, उदाहरण के लिए भुगतान समीक्षा में।

On Hold (Review) स्टेटस (डिफ़ॉल्ट Pending): भुगतान की गई राशि या मुद्रा ऑर्डर से अलग है, या PayPal के जवाब से भुगतान पढ़ा नहीं जा सका। नोट इसे समझाता है। ऑर्डर जाँचें और उसे पूरा करें या भुगतान रिफ़ंड करें।

Voided स्टेटस (डिफ़ॉल्ट Canceled): authorization को Void PayPal authorization से void किया गया।

Failed स्टेटस (डिफ़ॉल्ट Failed): लंबित कैप्चर अस्वीकृत या विफल हुआ।

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

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

नोट ऑर्डर के History में वे प्रविष्टियाँ हैं जो ग्राहक को नहीं दिखतीं। ऑर्डर टैब में किए गए स्टेटस बदलाव (कैप्चर, void, स्टेटस जाँच, रिफ़ंड) ग्राहक को बताए बिना और स्टॉक बदले बिना सीधे लिखे जाते हैं।

VibeFox PayPal Gateway टैब

Sales > Orders में PayPal से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox PayPal Gateway टैब में PayPal order ID और intent दिखते हैं (sandbox भुगतानों पर Sandbox लेबल के साथ), Capture ID (आपके PayPal खाते में भुगतान से लिंक, sandbox या live), Authorization ID, भुगतान का Status, Amount, Paid / refunded राशियाँ, रिफ़ंड इतिहास और ऑर्डर के PayPal notes। यह टैब उन उपयोगकर्ताओं को दिखता है जिनके पास एक्सटेंशन की पहुँच है; इसके बटनों के लिए एक्सटेंशन बदलने का अधिकार चाहिए (System > Users > User Groups में सेट)। हर क्रिया का परिणाम टैब में दिखता है।

Refunds

VibeFox PayPal Gateway टैब में राशि दर्ज करें (जो राशि अभी तक रिफ़ंड नहीं हुई, वह भर दी जाती है), वैकल्पिक रूप से Reason (optional, sent to the buyer), और Refund via PayPal पर क्लिक करें। प्रश्न Refund this amount through PayPal? This cannot be undone. की पुष्टि करें। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। कारण खरीदार के लिए एक नोट के रूप में PayPal को भेजा जाता है। रिफ़ंड उसी राशि और मुद्रा में होते हैं जो PayPal ने चार्ज की, इसलिए राशि या मुद्रा मेल न खाने के बाद आप ऑर्डर कुल के बजाय उतना ही रिफ़ंड कर सकते हैं जितना ग्राहक ने वास्तव में चुकाया। रिफ़ंड उस PayPal वातावरण (sandbox या live) में भेजा जाता है जिसमें भुगतान हुआ था, इसलिए उस वातावरण के क्रेडेंशियल सेट होने चाहिए। यदि PayPal रिफ़ंड स्वीकार नहीं करता, तो टैब त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड PayPal रिफ़ंड ID और स्टेटस के साथ रिफ़ंड इतिहास और नोट्स में जुड़ता है; PENDING रिफ़ंड को PayPal बाद में पूरा करता है। पूर्ण रिफ़ंड ऑर्डर को Refunded Status पर सेट करता है। आंशिक रिफ़ंड स्टेटस नहीं बदलता।

केवल authorize हुआ भुगतान रिफ़ंड नहीं हो सकता: उसके बजाय Void PayPal authorization का इस्तेमाल करें। Sales > Returns में उत्पाद वापसी PayPal के ज़रिए पैसे वापस नहीं भेजती। आपके PayPal खाते में किए गए रिफ़ंड, विवाद और चार्जबैक OpenCart से सिंक नहीं होते।

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

यह एक्सटेंशन vibefox.net की VibeFox लाइसेंस कुंजी के साथ काम करता है। License — VibeFox PayPal Gateway लाइसेंस ब्लॉक Extensions > Extensions > Payments > VibeFox PayPal Gateway > Edit पेज पर सेटिंग्स से ऊपर पहला ब्लॉक है। कुंजी License key में चिपकाएँ और Activate पर क्लिक करें। इसके बाद ब्लॉक मास्क की गई कुंजी, स्टेटस (जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन) और बटन दिखाता है: Check now स्टेटस फिर से जाँचने के लिए, Change key दूसरी कुंजी दर्ज करने के लिए और Remove key इस स्टोर से कुंजी हटाने के लिए। उनके नीचे Product: opencart-payment-paypal वाली पंक्ति और 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 खाते में स्लॉट खाली करें।

सक्रिय कुंजी के बिना चेकआउट पर ग्राहकों को PayPal नहीं दिखता। फिर भी यदि भुगतान शुरू होता है, तो स्टोर PayPal ऑर्डर बनाने से इनकार करता है और ग्राहक को An error occurred during PayPal checkout. Please try again. दिखता है। उसी ब्राउज़र में एडमिन में लॉग इन एडमिन उपयोगकर्ता को स्टोर में भुगतान तरीका (unlicensed — visible to admins only) चिह्न के साथ दिखता रहता है, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट करके टेस्ट कर सकें। OpenCart 4 पर यह प्रीव्यू उपलब्ध नहीं है: स्टोर एडमिन लॉगिन नहीं देखता, इसलिए सक्रिय कुंजी के बिना भुगतान तरीका सभी से छिपा रहता है। Edit पेज एक बार खोलने के बाद एडमिन Dashboard पर एक याद दिलाने वाला संदेश आता है। × से बंद करें, तो वह 7 दिनों के लिए छिप जाता है। मौजूदा ऑर्डर प्रभावित नहीं होते: रिफ़ंड और ऑर्डर टैब की क्रियाएँ काम करती रहती हैं।

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

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

चेकआउट पर PayPal नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, चुने गए मोड की Client ID और Secret भरी हुई हैं, ऑर्डर की मुद्रा PayPal द्वारा समर्थित है, और ऑर्डर कुल शून्य से अधिक है। जब क्रेडेंशियल या स्टोर की मुद्रा समस्या हो, तो सेटिंग्स पेज चेतावनी दिखाता है। यह भी जाँचें कि भुगतान पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स में दिए गए Total तक पहुँचता है।

भुगतान हो गया, पर ऑर्डर बिना स्टेटस के है: एक्सटेंशन में वेबहुक नहीं है, इसलिए भुगतान केवल चेकआउट के दौरान पुष्ट होता है। यह तब होता है जब कैप्चर के दौरान PayPal ने जवाब नहीं दिया या ऑर्डर स्टेटस सेट नहीं हो सका। Debug log चालू करें और Log फ़ील्ड देखें, PayPal खाते में भुगतान जाँचें, या ग्राहक को फिर से कोशिश करने दें: दोबारा प्रयास कभी दोहरा शुल्क नहीं लेता और सेव किए गए भुगतान से स्टेटस सेट करता है।

PayPal लोड नहीं हो सका: ब्राउज़र में PayPal स्क्रिप्ट लोड नहीं हुई, उदाहरण के लिए किसी ब्राउज़र एक्सटेंशन ने www.paypal.com ब्लॉक किया है या नेटवर्क समस्या है।

PayPal अभी उपलब्ध नहीं है: क्रेडेंशियल गलत हैं या दूसरे मोड के हैं। सही ऐप की Client ID और Secret फिर से कॉपी करें।

आपकी PayPal स्वीकृति इस चेकआउट से मेल नहीं खा सकी: PayPal ऑर्डर इस चेकआउट में नहीं बनाया गया, उदाहरण के लिए सेशन समाप्त होने के बाद। ग्राहक PayPal बटन फिर से क्लिक करता है।

आपका सेशन समाप्त हो गया है। कृपया पेज रीफ़्रेश करके फिर से कोशिश करें: चेकआउट पेज बहुत देर तक खुला रहा। ग्राहक पेज रीलोड करता है।

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

भुगतान के बाद ऑर्डर समीक्षा या लंबित स्टेटस में है: VibeFox PayPal Gateway टैब के नोट पढ़ें। भुगतान ऑथराइज़ हुआ है (उसे Capture PayPal payment से कैप्चर करें), कैप्चर PayPal पर PENDING है (बाद में Check PayPal payment status इस्तेमाल करें), या भुगतान की गई राशि या मुद्रा ऑर्डर से मेल नहीं खाती (ऑर्डर पूरा करें या भुगतान की गई राशि रिफ़ंड करें)।

Authorization का कैप्चर विफल होता है: authorization 29 दिन से पुराना हो सकता है या पहले ही void हो चुका हो। टैब और नोट PayPal की त्रुटि दिखाते हैं।

टैब में बटन नहीं हैं: टैब कारण बताता है: आपके उपयोगकर्ता समूह को एक्सटेंशन बदलने का अधिकार नहीं है, भुगतान पूरी तरह रिफ़ंड हो चुका है, या जिस वातावरण में भुगतान हुआ था उसकी Client ID और Secret सेट नहीं हैं।

रिफ़ंड विफल होता है: ऑर्डर में PayPal कैप्चर नहीं है (केवल authorization), राशि बचे हुए रिफ़ंड योग्य हिस्से से अधिक है, या जिस वातावरण में भुगतान हुआ था उसके क्रेडेंशियल गायब हैं। टैब बताता है कि कौन-सा मामला है।

अनइंस्टॉल

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

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

PayPal उसके संबंधित स्वामी का ट्रेडमार्क है। यह एक्सटेंशन PayPal से संबद्ध नहीं है और PayPal द्वारा समर्थित नहीं है।