VibeFox PagSeguro for WooCommerce — सहायता
आवश्यकताएँ
WordPress: 6.0 या उसके बाद का संस्करण।
WooCommerce: 8.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। इसके बिना प्लगइन सक्रिय नहीं होता।
PHP: 8.0 या उसके बाद का संस्करण।
मुद्रा: ब्राज़ीलियन रियल (BRL)। यदि स्टोर की मुद्रा (या Pay for order पेज पर ऑर्डर की मुद्रा) BRL नहीं है, तो चेकआउट में यह भुगतान तरीका नहीं दिखता।
HTTPS: आपकी साइट इंटरनेट से HTTPS पर पहुँच योग्य होनी चाहिए, ताकि PagBank भुगतान सूचनाएँ भेज सके।
PagBank खाता: वास्तविक भुगतान के लिए एक प्रोडक्शन टोकन, और परीक्षण के लिए एक सैंडबॉक्स टोकन। प्रोडक्शन टोकन: अपने PagBank खाते में लॉग इन करें, Venda online > Integrações खोलें और Gerar token पर क्लिक करें; PagBank टोकन ईमेल से भेजता है। सैंडबॉक्स: PagBank डेवलपर पोर्टल में एक सैंडबॉक्स खाता बनाएँ और उसका टोकन कॉपी करें। सैंडबॉक्स और प्रोडक्शन टोकन केवल अपने-अपने वातावरण में काम करते हैं।
VibeFox लाइसेंस कुंजी: vibefox.net पर खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से wcp_pagseguro_gateway फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।
2. Activate पर क्लिक करें।
3. सेटिंग्स खोलें: WooCommerce > Settings > Payments > PagSeguro / PagBank > Manage, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।
4. पेज के शीर्ष पर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें।
5. सैंडबॉक्स टोकन दर्ज करें, और वास्तविक भुगतान लेने के लिए प्रोडक्शन टोकन दर्ज करें।
6. Enable / Disable चालू करें और सहेजें। Sandbox Mode चालू रखकर परीक्षण भुगतान करें, फिर वास्तविक भुगतान लेने के लिए उसे बंद करें।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > PagSeguro / PagBank। शीर्षक के नीचे पेज वर्तमान मोड दिखाता है: SANDBOX MODE (भुगतान PagBank सैंडबॉक्स में बनते हैं, कोई वास्तविक शुल्क नहीं लगता) या LIVE (भुगतान प्रोडक्शन टोकन से बनते हैं)। यदि वर्तमान मोड का टोकन खाली है (तब चेकआउट में भुगतान तरीका छिपा रहता है) या स्टोर की मुद्रा BRL नहीं है, तो यह चेतावनी देता है। भुगतान तरीकों की सूची में, जब तक वर्तमान मोड का टोकन दर्ज नहीं होता, PagBank को सेटअप की आवश्यकता वाला दिखाया जाता है, और सैंडबॉक्स मोड चालू रहने पर टेस्ट मोड बैज दिखाया जाता है।
सामान्य
Enable / Disable: Enable PagSeguro/PagBank payments भुगतान तरीके को चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: वह भुगतान तरीके का नाम जो ग्राहक चेकआउट पर देखता है। डिफ़ॉल्ट: PagSeguro / PagBank।
Description: चेकआउट पर भुगतान तरीके के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely via PagSeguro/PagBank. You will be redirected to complete your payment.
PagBank खाता
यह अनुभाग बताता है कि टोकन कहाँ से मिलेंगे, और आपके PagBank खाते तथा टोकन पर PagBank के पेज के लिंक देता है।
Sandbox Mode: Enable sandbox/test mode (no real charges)। नए भुगतान सैंडबॉक्स टोकन के साथ PagBank सैंडबॉक्स में जाते हैं, और चेकआउट पर SANDBOX MODE नोट दिखता है। किसी ऑर्डर की स्थिति की जाँच और रिफ़ंड हमेशा उसी वातावरण और टोकन का उपयोग करते हैं जिससे उसका भुगतान बना था। डिफ़ॉल्ट: चालू।
Sandbox token: PagBank सैंडबॉक्स टोकन। सैंडबॉक्स मोड चालू रहने पर इसका उपयोग होता है।
Production token: PagBank प्रोडक्शन टोकन। सैंडबॉक्स मोड बंद होने पर इसका उपयोग होता है। इसे गुप्त रखें।
संस्करण 1.0 का एकल टोकन अपने-आप स्थानांतरित हो जाता है: यदि सैंडबॉक्स मोड चालू था, तो वह सैंडबॉक्स टोकन बन जाता है, अन्यथा प्रोडक्शन टोकन ही रहता है।
भुगतान सूचनाएँ
हर भुगतान PagBank को बताता है कि स्थिति में बदलाव की सूचना कहाँ भेजनी है, इसलिए PagBank में कुछ भी कॉन्फ़िगर नहीं करना होता। यह अनुभाग सूचना URL दिखाता है। यह इस रूप का होता है: https://your-site/wc-api/webhook_wc_pagseguro/। यह पता इंटरनेट से HTTPS पर पहुँच योग्य होना चाहिए।
x-authenticity-token हेडर वाली सूचनाएँ ऑर्डर के वातावरण के टोकन से जाँची जाती हैं; अमान्य हस्ताक्षर वाली सूचना अस्वीकार की जाती है। सूचना का मुख्य भाग कभी भरोसेमंद नहीं माना जाता: प्लगइन ऑर्डर बदलने से पहले हमेशा PagBank API से चेकआउट और PagBank ऑर्डर (स्थिति, राशि और मुद्रा) पढ़ता है।
उन्नत
Debug log: Log API requests and notifications विवरण WooCommerce > Status > Logs में लिखता है, स्रोत wcp_pagseguro_gateway। त्रुटियाँ हमेशा दर्ज होती हैं। लॉग में कोई टोकन या ग्राहक डेटा नहीं होता। डिफ़ॉल्ट: बंद।
Delete Data on Uninstall: Remove the gateway settings and logs when the plugin is deleted। डिफ़ॉल्ट: बंद।
चेकआउट
ग्राहक भुगतान तरीका चुनता है (डिफ़ॉल्ट रूप से PagSeguro / PagBank) और ऑर्डर देता है। प्लगइन ऑर्डर के कुल योग के बराबर राशि के लिए BRL में एक PagBank चेकआउट बनाता है, जिसमें एक ही आइटम होता है, Order # के बाद ऑर्डर नंबर और आपके स्टोर का नाम। फिर ग्राहक को PagBank भुगतान पेज पर भेजता है। ग्राहक का नाम और ईमेल, Brazilian Market on WooCommerce प्लगइन के फ़ील्ड से CPF या CNPJ, और एक ब्राज़ीलियाई फ़ोन नंबर, स्टोर के पास होने पर भर दिए जाते हैं; ग्राहक उन्हें PagBank पेज पर पूरा या सुधार सकता है। ग्राहक आपके PagBank खाते में सक्षम भुगतान तरीकों से भुगतान करता है, जैसे क्रेडिट कार्ड, PIX या boleto।
भुगतान पेज उस समय से 5 मिनट पहले समाप्त हो जाता है जब WooCommerce का Hold stock टाइमर बिना भुगतान वाले ऑर्डर को रद्द करे (कम से कम 10 मिनट), या स्टॉक होल्ड न होने पर 120 मिनट बाद।
भुगतान के बाद ग्राहक स्टोर पर लौट आता है। यह वापसी उसी तरह जाँची जाती है जैसे कोई सूचना: प्लगइन PagBank API से भुगतान पढ़ता है, और अकेली वापसी कभी किसी ऑर्डर को भुगतान किया हुआ नहीं बनाती। भुगतान किया गया ऑर्डर, या लंबित भुगतान (boleto, PIX, जाँच), ऑर्डर प्राप्त पेज पर जाता है; यदि PagBank ने अभी तक सूचना नहीं भेजी है, तो ऑर्डर सूचना से पुष्टि होता है।
यदि भुगतान पूरा नहीं हुआ, तो ग्राहक Pay for order पेज पर लौट आता है, जहाँ ये संदेश दिखते हैं: The PagBank payment was not completed. You can pay the order again below., The PagBank payment page has expired. You can pay the order again below., या The payment was declined by PagBank. Please try again with another card or payment method. यदि भुगतान रद्द हुआ और उसके साथ ऑर्डर भी, तो ग्राहक The PagBank payment was cancelled, so the order was cancelled. संदेश के साथ कार्ट पर पहुँचता है।
जब ग्राहक फिर से भुगतान करता है, तो यदि राशि और वातावरण समान हैं और वह 10 मिनट के भीतर समाप्त नहीं होने वाला है, तो खुला PagBank चेकआउट फिर से उपयोग होता है। अन्यथा पिछला चेकआउट निष्क्रिय हो जाता है और उससे अब भुगतान नहीं किया जा सकता। उससे पहले पिछले पेज पर किया गया भुगतान अब भी ऑर्डर के लिए गिना जाता है।
यदि PagBank भुगतान शुरू नहीं कर पाता, तो ग्राहक को एक छोटा संदेश दिखता है, जैसे PagBank did not accept your billing details (CPF/CNPJ). Please check them and try again. या Could not connect to PagBank. Please try again in a moment. PagBank द्वारा बताया गया कारण ऑर्डर नोट्स में जोड़ा जाता है।
यह भुगतान तरीका क्लासिक चेकआउट, Checkout ब्लॉक और Pay for order पेज पर काम करता है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।
प्लगइन में साइट पर कार्ड फ़ॉर्म, सेव किए गए कार्ड, सब्सक्रिप्शन या आवर्ती भुगतान, स्प्लिट भुगतान या मार्केटप्लेस की सुविधा नहीं है। भुगतान तरीके और EMI वही हैं जो आपके PagBank खाते में कॉन्फ़िगर किए गए हैं।
ऑर्डर और रिफ़ंड
ऑर्डर स्थितियाँ
Pending payment: ग्राहक को PagBank पर भेजा गया है और उसने अभी भुगतान नहीं किया है। एक नोट में PagBank चेकआउट ID और वातावरण दिखता है। यदि भुगतान पेज बिना भुगतान के समाप्त हो जाता है, तो एक नोट यह बताता है और स्थिति नहीं बदलती।
Processing: भुगतान की पुष्टि हो गई है। भुगतान के बाद यह WooCommerce की मानक स्थिति है; केवल वर्चुअल डाउनलोड योग्य उत्पादों वाले ऑर्डर पूर्ण हो जाते हैं। ऑर्डर नोट में राशि, भुगतान तरीका और PagBank चार्ज ID दिखता है, जो ऑर्डर की ट्रांज़ैक्शन ID भी है।
On hold: boleto या PIX बन गया है और भुगतान की प्रतीक्षा है; भुगतान जाँच में है; कार्ड भुगतान अधिकृत हुआ है पर कैप्चर नहीं हुआ (इसे PagBank में कैप्चर करें); भुगतान की गई राशि या मुद्रा ऑर्डर से मेल नहीं खाती; या WooCommerce द्वारा बिना भुगतान वाला ऑर्डर रद्द करने के बाद भुगतान आया (स्टॉक जाँचें, फिर ऑर्डर पूरा करें या PagBank में भुगतान रिफ़ंड करें)। ऑर्डर नोट इसका कारण समझाता है।
Failed: भुगतान अस्वीकार हुआ। ग्राहक Pay for order पेज से फिर से भुगतान कर सकता है।
Cancelled: भुगतान रद्द हुआ, उदाहरण के लिए समाप्त boleto या PIX।
Refunded: PagBank डैशबोर्ड में भुगतान पूरी तरह रिफ़ंड किया गया।
हर PagBank स्थिति केवल एक बार लागू होती है, इसलिए दोहराई गई सूचनाएँ या वापसियाँ नए नोट्स, ईमेल या स्टॉक में कमी नहीं जोड़तीं। यदि पहले से भुगतान किए गए ऑर्डर के लिए दूसरा भुगतान आता है, तो एक नोट आपसे PagBank में उसे रिफ़ंड करने को कहता है।
रिफ़ंड
ऑर्डर खोलें, Refund पर क्लिक करें, राशि दर्ज करें और Refund via PagSeguro / PagBank पर क्लिक करें (बटन पर आपके भुगतान तरीके का शीर्षक दिखता है)। पूर्ण और आंशिक दोनों रिफ़ंड समर्थित हैं। रिफ़ंड उसी वातावरण और टोकन से भेजा जाता है जिससे भुगतान हुआ था। रिफ़ंड केवल तभी दर्ज होता है जब PagBank उसकी पुष्टि करे; अन्यथा WooCommerce त्रुटि दिखाता है, जैसे PagBank refund failed: ... या PagBank did not confirm the refund, और कुछ भी दर्ज नहीं होता। boleto भुगतानों के रिफ़ंड और PIX के आंशिक रिफ़ंड PagBank के नियमों का पालन करते हैं। सफल रिफ़ंड चार्ज ID के साथ ऑर्डर नोट्स में जोड़ा जाता है।
PagBank डैशबोर्ड में किए गए रिफ़ंड WooCommerce रिफ़ंड लाइन के रूप में आयात नहीं होते। पूर्ण रिफ़ंड ऑर्डर को Refunded पर सेट करता है; आंशिक रिफ़ंड रिफ़ंड राशि के साथ एक नोट जोड़ता है, और आप रिफ़ंड को मैन्युअल रूप से ऑर्डर में जोड़ सकते हैं।
लाइसेंस कुंजी
यह प्लगइन vibefox.net से ली गई VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Payments > PagSeguro / PagBank के शीर्ष पर है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now, कोई दूसरी कुंजी दर्ज करने के लिए Change key, और इस साइट से कुंजी हटाने के लिए Remove key का उपयोग करें। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।
एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने से उसका डोमेन स्लॉट मुक्त नहीं होता। अपने vibefox.net खाते में स्लॉट मुक्त करें।
सक्रिय कुंजी के बिना चेकआउट पर ग्राहकों को PagBank नहीं दिखता। यदि फिर भी भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। लॉग इन किए हुए स्टोर मैनेजरों को भुगतान तरीका अब भी (unlicensed — visible to admins only) चिह्न के साथ दिखता है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट अप और टेस्ट कर सकें। प्लगइन पेज और WooCommerce पेजों पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: पहले से शुरू हुए भुगतान अब भी पुष्ट होते हैं और रिफ़ंड काम करते हैं।
जब लाइसेंस समाप्त हो जाता है, तो प्लगइन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। स्थिति पृष्ठभूमि में अपने-आप फिर से जाँची जाती है।
समस्या निवारण
चेकआउट पर PagBank नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable / Disable चालू है, वर्तमान मोड का टोकन भरा है (सैंडबॉक्स मोड में Sandbox token, लाइव मोड में Production token) और स्टोर की मुद्रा BRL है। सेटिंग्स पेज इनमें से हर स्थिति में चेतावनी दिखाता है।
भुगतान हो गया, लेकिन ऑर्डर भुगतान लंबित पर ही रहता है: PagBank ने अभी तक भुगतान की सूचना नहीं दी है, और ग्राहक स्टोर पर वापस नहीं आया। सूचना मिलते ही ऑर्डर अपडेट हो जाता है। जाँचें कि आपकी साइट इंटरनेट से HTTPS पर पहुँच योग्य है, और WooCommerce > Status > Logs देखें, स्रोत wcp_pagseguro_gateway।
सूचना का उत्तर Invalid signature है: x-authenticity-token उस वातावरण के टोकन से मेल नहीं खाता जिसमें ऑर्डर का भुगतान हुआ था। जाँचें कि सेटिंग्स में सही टोकन है।
सूचना का उत्तर Verification failed, retry later है: PagBank API तक पहुँच नहीं हो पाई, ऑर्डर के वातावरण का टोकन नहीं है, या उसी समय कोई दूसरा अनुरोध ऑर्डर को अपडेट कर रहा था। PagBank सूचना दोबारा भेजता है।
सूचना का उत्तर Order not found है: ऑर्डर इस स्टोर में नहीं है, या किसी दूसरे भुगतान तरीके से चुकाया गया है। कुछ नहीं बदला जाता।
ग्राहक को This order is already being processed दिखता है: कोई सूचना या ग्राहक की वापसी उसी समय ऑर्डर अपडेट कर रही थी। ग्राहक थोड़ी देर बाद फिर कोशिश कर सकता है।
ग्राहक को PagBank payments are temporarily unavailable दिखता है: वर्तमान मोड का टोकन नहीं है या PagBank ने उसे अस्वीकार किया है।
ग्राहक को PagSeguro/PagBank only accepts payments in Brazilian Real (BRL) दिखता है: ऑर्डर किसी दूसरी मुद्रा में है।
ऑर्डर On hold है, नोट Amount/currency does not match के साथ: PagBank ने एक ऐसा भुगतान बताया है जिसकी राशि या मुद्रा ऑर्डर के कुल योग से अलग है, उदाहरण के लिए भुगतान पेज बनने के बाद ऑर्डर संपादित हो जाने के कारण। PagBank में राशियाँ मिलाएँ और ऑर्डर को मैन्युअल रूप से पूरा करें या रिफ़ंड करें।
टोकन संबंधी संदेश के साथ रिफ़ंड विफल होता है: भुगतान सैंडबॉक्स या प्रोडक्शन में हुआ था, और उस वातावरण का टोकन नहीं है या अस्वीकार हुआ है। सही टोकन दर्ज करें और फिर कोशिश करें।
लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक में दिए संदेश का पालन करें। उदाहरण के लिए, यदि कुंजी किसी दूसरे डोमेन पर पहले से उपयोग में है, तो अपने vibefox.net खाते में स्लॉट मुक्त करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं है, तो प्लगइन अंतिम ज्ञात स्थिति के साथ काम करता रहता है।
अनइंस्टॉल
प्लगइन को निष्क्रिय करने पर सारा डेटा सुरक्षित रहता है। इसे हटाने के लिए Plugins पेज पर इसे निष्क्रिय करके हटाएँ। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती है। गेटवे सेटिंग्स, प्लगइन के अन्य विकल्प और इसके लॉग केवल तभी हटाए जाते हैं जब Delete Data on Uninstall चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए रहते हैं। मौजूदा ऑर्डर अपने भुगतान नोट्स, ट्रांज़ैक्शन ID और PagBank डेटा को बनाए रखते हैं।
PagSeguro और PagBank अपने-अपने स्वामियों के ट्रेडमार्क हैं। यह प्लगइन PagSeguro या PagBank से संबद्ध नहीं है और न ही उनके द्वारा अनुमोदित है।