VibeFox PayPal for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

HTTPS: लाइव भुगतानों के लिए आपकी साइट पर HTTPS होना चाहिए।

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

मुद्रा: 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 से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।

इंस्टॉलेशन

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

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

3. PayPal Developer Dashboard में REST API ऐप (सैंडबॉक्स और/या लाइव) बनाएँ और उसका Client ID और Secret कॉपी करें।

4. सेटिंग्स खोलें: WooCommerce > Settings > Payments > PayPal (Smart Buttons) > Manage, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।

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

6. जिस मोड का उपयोग करना है उसके क्रेडेंशियल डालें, Capture या Authorize चुनें, Enable/Disable चालू करें और सहेजें।

7. PayPal सैंडबॉक्स खरीदार खाते से परीक्षण करें, फिर Sandbox mode का निशान हटाएँ और लाइव क्रेडेंशियल डालें।

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

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

सामान्य

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

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

Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: Pay with your PayPal account or a card via PayPal।

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

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

Sandbox mode: Enable sandbox (test) mode। भुगतान सैंडबॉक्स क्रेडेंशियल के साथ PayPal सैंडबॉक्स को भेजे जाते हैं; कोई वास्तविक धनराशि नहीं चलती। डिफ़ॉल्ट: on। वास्तविक भुगतान स्वीकार करने के लिए इसका निशान हटाएँ।

Sandbox Client ID: आपके सैंडबॉक्स REST API ऐप का Client ID।

Sandbox Secret: आपके सैंडबॉक्स REST API ऐप का Secret।

Live Client ID: आपके लाइव REST API ऐप का Client ID।

Live Secret: आपके लाइव REST API ऐप का Secret।

भुगतान

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

उन्नत

Debug log: Log API requests (errors are always logged)। प्रविष्टियाँ WooCommerce > Status > Logs में, स्रोत wcp_paypal_gateway के साथ सहेजी जाती हैं। क्रेडेंशियल और खरीदार का डेटा कभी लॉग नहीं होता। डिफ़ॉल्ट: off।

Delete data on uninstall: Delete the gateway settings when the plugin is deleted। ऑर्डर का भुगतान डेटा (ऑर्डर में PayPal ID) हमेशा रखा जाता है। डिफ़ॉल्ट: off।

चेकआउट

जब ग्राहक PayPal चुनता है (डिफ़ॉल्ट रूप से PayPal), तो PayPal बटन Place order की जगह ले लेता है। सैंडबॉक्स मोड में चेकआउट पर सैंडबॉक्स मोड: PayPal सैंडबॉक्स खरीदार खाते से भुगतान करें। कोई वास्तविक राशि नहीं काटी जाएगी। दिखता है। बटन पर क्लिक करने से आपके सर्वर पर कार्ट के कुल (या Pay for order पेज पर ऑर्डर के कुल) के लिए PayPal ऑर्डर बनता है। राशि हमेशा सर्वर पर गिनी जाती है, ब्राउज़र में कभी नहीं।

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

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

यदि कैप्चर के दौरान PayPal उत्तर नहीं देता, तो ग्राहक को हम अभी आपका PayPal भुगतान पुष्टि नहीं कर पा रहे हैं। कृपया थोड़ी देर बाद फिर से प्रयास करें — आपसे दोबारा शुल्क नहीं लिया जाएगा। दिखता है। पुनः प्रयास में वही स्वीकृति इस्तेमाल होती है, और यदि PayPal ने पिछला प्रयास पूरा कर लिया था, तो वह भुगतान इस्तेमाल होता है और नई स्वीकृति कैप्चर नहीं होती।

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

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

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

Order statuses

Pending payment: ऑर्डर बन गया है, लेकिन भुगतान अभी कैप्चर नहीं हुआ है, उदाहरण के लिए PayPal से अज्ञात उत्तर मिलने के बाद।

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

On hold: भुगतान ऑथराइज़ हो चुका है और कैप्चर की प्रतीक्षा में है (भुगतान क्रिया Authorize); या PayPal पर कैप्चर PENDING है, उदाहरण के लिए भुगतान समीक्षा में; या भुगतान की गई राशि या मुद्रा ऑर्डर से मेल नहीं खाती; या PayPal के उत्तर से भुगतान पढ़ा नहीं जा सका। ऑर्डर नोट इसका कारण बताता है।

Failed: PayPal ने कैप्चर या ऑथराइज़ेशन अस्वीकार कर दिया।

Cancelled: Void PayPal authorization से ऑथराइज़ेशन रद्द किया गया।

ऑर्डर क्रियाएँ

ऑर्डर खोलें, Order actions में कोई क्रिया चुनें और तीर पर क्लिक करें।

रिफ़ंड

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

केवल ऑथराइज़्ड भुगतान रिफ़ंड नहीं किया जा सकता: उसके बजाय Void PayPal authorization का उपयोग करें। आपके PayPal खाते में किए गए रिफ़ंड, विवाद और रिवर्सल WooCommerce के साथ सिंक नहीं होते।

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

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

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

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

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

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

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

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

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

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

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

ऑथराइज़ेशन का कैप्चर विफल होता है: ऑथराइज़ेशन 29 दिनों से पुराना हो सकता है या पहले ही void किया जा चुका हो। ऑर्डर नोट PayPal की त्रुटि दिखाता है।

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

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

अनइंस्टॉल

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

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