VibeFox PagSeguro for OpenCart — सहायता
आवश्यकताएँ
OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या 4.0.2 और उसके बाद का (4.1.0.3 पर परीक्षण किया गया)।
PHP: 8.0 या उसके बाद का।
Currency: ब्राज़ीलियाई रियल (BRL)। स्टोर में BRL मुद्रा होनी चाहिए (System > Localisation > Currencies), और भुगतान विधि केवल तभी दिखाई देती है जब ग्राहक BRL में चेकआउट करता है।
Reachable site: आपका स्टोर इंटरनेट से पहुँचने योग्य होना चाहिए, ताकि PagBank भुगतान सूचनाएँ भेज सके।
PagBank account: वास्तविक भुगतान के लिए एक प्रोडक्शन टोकन और परीक्षण के लिए एक सैंडबॉक्स टोकन। प्रोडक्शन: अपने PagBank खाते में लॉग इन करें, Venda online > Integrações खोलें और Gerar token पर क्लिक करें; PagBank टोकन ईमेल से भेजता है। सैंडबॉक्स: PagBank डेवलपर पोर्टल में अपने सैंडबॉक्स खाते का टोकन कॉपी करें। सैंडबॉक्स और प्रोडक्शन टोकन केवल अपने-अपने वातावरण में काम करते हैं।
VibeFox license key: vibefox.net पर खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
डाउनलोड एक zip फ़ाइल है, जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। इसे अपने कंप्यूटर पर अनज़िप करें। इसमें README.txt, OpenCart 3 का पैकेज wcp_pagseguro_gateway-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज wcp_pagseguro_gateway.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।
OpenCart 3
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_pagseguro_gateway-oc3-(version).ocmod.zip चुनें। एक्सटेंशन में कोई OCMOD संशोधन नहीं है, इसलिए Extensions > Modifications को रीफ़्रेश करने की ज़रूरत नहीं है। इंस्टॉलर के बजाय आप इस पैकेज के upload फ़ोल्डर की सामग्री को अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।
2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox PagSeguro Gateway ढूँढें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन उपयोगकर्ता को भुगतान एक्सटेंशन की सूची बदलने का अधिकार चाहिए।
3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। पेज के शीर्ष पर लाइसेंस ब्लॉक में License key में अपनी VibeFox लाइसेंस कुंजी चिपकाएँ और Activate पर क्लिक करें (देखें License key)।
4. सैंडबॉक्स टोकन दर्ज करें और वास्तविक भुगतान लेने के लिए प्रोडक्शन टोकन दर्ज करें। PagBank में कुछ भी सेट करने की आवश्यकता नहीं है: हर भुगतान के साथ सूचना URL भेजा जाता है।
5. Enable / Disable चालू करें और Save पर क्लिक करें। Sandbox Mode चालू रखकर परीक्षण भुगतान करें, फिर वास्तविक भुगतान लेने के लिए उसे बंद करें।
OpenCart 4
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_pagseguro_gateway.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।
2. पैकेज इंस्टॉल किए गए एक्सटेंशन की सूची में उसी पेज पर दिखता है। उसके बगल में Install (हरा + बटन) पर क्लिक करें।
3. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox PagSeguro Gateway ढूँढें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर।
4. लाइसेंस कुंजी और टोकन दर्ज करें, और OpenCart 3 के चरण 3 से 5 की तरह भुगतानों का परीक्षण करें। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल सूचना URL अलग है (देखें Notification URL); वह भी हर भुगतान के साथ PagBank को भेजा जाता है।
नई इंस्टॉलेशन भुगतान विधि बंद और सैंडबॉक्स मोड चालू के साथ शुरू होती है।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox PagSeguro Gateway > Edit। अनुभाग बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सहेजता है। सेटिंग्स के ऊपर पेज वर्तमान मोड दिखाता है: SANDBOX MODE (भुगतान PagBank सैंडबॉक्स में बनाए जाते हैं, कोई वास्तविक शुल्क नहीं) या LIVE (भुगतान प्रोडक्शन टोकन से बनाए जाते हैं)। जब वर्तमान मोड का टोकन गायब होता है (तब भुगतान विधि चेकआउट पर छिपा दी जाती है) और जब स्टोर की डिफ़ॉल्ट मुद्रा BRL नहीं होती, तब यह चेतावनी देता है। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सहेज नहीं सकता।
सहेजते समय Title खाली नहीं हो सकता (अधिकतम 128 अक्षर), Sort Order एक पूर्ण संख्या होनी चाहिए (ऋणात्मक संख्याएँ मान्य हैं), Total 0 या उससे अधिक की संख्या होना चाहिए, और geo zone तथा ऑर्डर स्टेटस मौजूद होने चाहिए। यदि कोई मान गलत है, तो एक त्रुटि उसका नाम बताती है और कुछ भी सहेजा नहीं जाता।
PagSeguro / PagBank
Enable / Disable: Enable PagSeguro/PagBank payments भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखता है। यह ऑर्डर में सहेजा गया भुगतान विधि का नाम भी है। डिफ़ॉल्ट: PagSeguro / PagBank। आवश्यक, अधिकतम 128 अक्षर।
Description: वह पाठ जो ग्राहक को Confirm Order चरण में, कन्फ़र्म बटन के ऊपर दिखाया जाता है। डिफ़ॉल्ट: Pay securely via PagSeguro/PagBank. You will be redirected to complete your payment.
Sort Order: चेकआउट पर भुगतान विधियों के बीच PagBank की स्थिति। खाली छोड़ें या एक पूर्ण संख्या दर्ज करें।
Geo Zone: PagBank केवल चुने गए geo zone के भुगतान पते के लिए पेश करें। डिफ़ॉल्ट: All zones। Geo zones System > Localisation > Geo Zones में सेट किए जाते हैं। OpenCart 4 पर, जब स्टोर भुगतान पता नहीं माँगता, तब शिपिंग पता उपयोग होता है।
Total: चेकआउट का कुल राशि, स्टोर की डिफ़ॉल्ट मुद्रा में, जिस तक पहुँचने पर ही किसी ऑर्डर के लिए PagBank पेश किया जाता है। किसी भी कुल राशि के लिए PagBank पेश करने हेतु खाली छोड़ें।
PagBank खाता
यह अनुभाग बताता है कि टोकन कहाँ से प्राप्त करें, और आपके PagBank खाते तथा टोकन के बारे में PagBank पेज के लिंक देता है।
Sandbox Mode: Enable sandbox/test mode (no real charges)। नए भुगतान सैंडबॉक्स टोकन के साथ PagBank सैंडबॉक्स में जाते हैं, और ग्राहक Confirm Order चरण पर SANDBOX MODE — Using test environment. No real charges. देखते हैं। किसी ऑर्डर की स्थिति जाँच और रिफ़ंड हमेशा उसी वातावरण और टोकन का उपयोग करते हैं जिसमें उसका भुगतान बनाया गया था। डिफ़ॉल्ट: चालू।
Sandbox token: PagBank सैंडबॉक्स टोकन। सैंडबॉक्स मोड चालू होने पर उपयोग होता है।
Production token: PagBank प्रोडक्शन टोकन (Bearer)। सैंडबॉक्स मोड बंद होने पर उपयोग होता है। इसे गोपनीय रखें।
सहेजे गए टोकन दोबारा कभी नहीं दिखाए जाते। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल तभी नया मान दर्ज करें जब उसे बदलना हो। सहेजा गया टोकन हटाने के लिए फ़ील्ड के नीचे Clear the saved token on save पर टिक करें और Save पर क्लिक करें।
भुगतान सूचनाएँ
Notification URL: हर भुगतान PagBank को अपने चेकआउट और भुगतान सूचनाएँ इस URL पर भेजने का निर्देश देता है, इसलिए PagBank में कुछ भी कॉन्फ़िगर करने की आवश्यकता नहीं है। OpenCart 3 पर यह https://your-store/index.php?route=extension/payment/wcp_pagseguro_gateway/webhook जैसा दिखता है, और OpenCart 4 पर https://your-store/index.php?route=extension/wcp_pagseguro_gateway/payment/wcp_pagseguro_gateway.webhook जैसा। यह आपकी OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। यह URL इंटरनेट से पहुँचने योग्य होना चाहिए।
x-authenticity-token हेडर वाली सूचनाएँ उस वातावरण के टोकन से जाँची जाती हैं जिसमें भुगतान बनाया गया था; अमान्य हस्ताक्षर अस्वीकार कर दिया जाता है। सूचना का मुख्य भाग स्वयं कभी भरोसेमंद नहीं माना जाता: ऑर्डर बदलने से पहले एक्सटेंशन हमेशा PagBank API से चेकआउट और PagBank ऑर्डर (स्थिति, राशि, मुद्रा) पढ़ता है। सूचनाओं के बिना, ऑर्डर को भुगतान के बाद स्टोर पर लौटने पर स्टेटस मिलता है।
ऑर्डर
OpenCart Confirm Order चरण में ऑर्डर बिना स्टेटस के बनाता है (लापता ऑर्डर)। ऑर्डर को स्टेटस तभी मिलता है जब PagBank किसी सूचना द्वारा या ग्राहक के लौटने पर भुगतान की रिपोर्ट कर देता है; भुगतान को हमेशा PagBank से दोबारा पढ़ा जाता है। नीचे का प्रत्येक फ़ील्ड आपकी OpenCart ऑर्डर स्थितियों को सूचीबद्ध करता है।
Order Status After Payment: सत्यापित PagBank भुगतान के बाद सेट होने वाली स्थिति। डिफ़ॉल्ट: प्रोसेसिंग।
Awaiting PagBank Payment Status: boleto या PIX जारी हुआ है, या भुगतान जाँच के अधीन है (WAITING / IN_ANALYSIS); PagBank बाद में राशि की पुष्टि करता है। डिफ़ॉल्ट: लंबित।
PagBank Payment On Hold Status: भुगतान के लिए आपकी समीक्षा आवश्यक है (देखें ऑर्डर स्थितियाँ)। डिफ़ॉल्ट: लंबित, क्योंकि OpenCart में On hold स्थिति नहीं है। आप System > Localisation > Order Statuses में अपनी स्थिति बना सकते हैं और यहाँ चुन सकते हैं।
Payment Declined Status: प्रतीक्षारत ऑर्डर का भुगतान अस्वीकार कर दिया गया। यदि PagBank बाद में भुगतान होने की रिपोर्ट करता है, तो ऑर्डर को भुगतान के बाद की स्थिति मिलती है। डिफ़ॉल्ट: Failed।
Payment Cancelled Status: प्रतीक्षारत ऑर्डर का भुगतान PagBank में रद्द कर दिया गया। इस स्थिति वाले ऑर्डर के लिए आया भुगतान उसे समीक्षा स्थिति में डाल देता है। डिफ़ॉल्ट: Canceled।
Refunded Status: ऑर्डर पेज से या PagBank डैशबोर्ड से भुगतान पूरी तरह रिफ़ंड होने के बाद सेट होता है। डिफ़ॉल्ट: Refunded।
उन्नत
Debug log: API अनुरोध और सूचनाएँ OpenCart लॉग फ़ोल्डर (storage/logs) की wc_psg_debug.log.php फ़ाइल में लिखता है। यह फ़ाइल वेब से नहीं खोली जा सकती। लॉग में कोई टोकन या ग्राहक डेटा नहीं होता। त्रुटियाँ और चेतावनियाँ हमेशा दर्ज होती हैं। डिफ़ॉल्ट: बंद।
Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।
Delete Data on Uninstall: चालू होने पर एक्सटेंशन अनइंस्टॉल करने से गेटवे सेटिंग्स और लॉग हट जाते हैं। ऑर्डर और उनके PagBank संदर्भ (रिफ़ंड के लिए आवश्यक) हमेशा रखे जाते हैं। डिफ़ॉल्ट: बंद।
आयात / निर्यात
Export: Download JSON सेटिंग्स को JSON फ़ाइल में सहेजता है। टोकन निर्यात नहीं होते।
Import: पहले निर्यात किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सहेजे गए टोकन बने रहते हैं।
चेकआउट
Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से PagSeguro / PagBank)। Confirm Order चरण पर ग्राहक आपका विवरण और यह नोट देखता है: You will be redirected to the PagBank payment page (credit card, PIX, boleto) and returned to the store. OpenCart इस चरण पर ऑर्डर बनाता है, अभी भी बिना स्टेटस के। OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, Payment method options विंडो में भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर की कुल राशि के लिए BRL में एक PagBank चेकआउट बनाता है, जिसमें एक आइटम होता है, Order # के साथ ऑर्डर नंबर और आपके स्टोर का नाम (कूपन, शिपिंग और टैक्स कुल में शामिल होते हैं), और ग्राहक को PagBank भुगतान पेज पर भेजता है। ग्राहक का नाम और ईमेल, साथ ही ग्राहक या भुगतान पते के उस कस्टम फ़ील्ड से CPF या CNPJ (11 या 14 अंक) जिसका नाम CPF या CNPJ है, और एक ब्राज़ीलियाई फ़ोन नंबर भेजा जाता है। OpenCart में डिफ़ॉल्ट रूप से CPF फ़ील्ड नहीं है; आप इसे Customers > Custom Fields में जोड़ सकते हैं। OpenCart 4 पर, जब स्टोर भुगतान पता नहीं माँगता, तब शिपिंग पता और उसके कस्टम फ़ील्ड उपयोग होते हैं। ग्राहक PagBank पेज पर ये विवरण पूरे कर सकता है या सुधार सकता है और अपने PagBank खाते में सक्षम विधियों से भुगतान करता है। भुगतान पेज 120 मिनट बाद समाप्त हो जाता है।
भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर को तभी भुगतान किया हुआ चिह्नित किया जाता है जब PagBank उसकी पुष्टि कर दे: एक्सटेंशन सूचना आने पर या ग्राहक के लौटने पर PagBank API से भुगतान पढ़ता है, और वसूली गई राशि (PagBank की किस्त ब्याज को छोड़कर) तथा मुद्रा ऑर्डर से मेल खानी चाहिए। फिर ऑर्डर को OpenCart के मानक तरीके से स्टेटस मिलता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक को OpenCart ऑर्डर सफलता पेज दिखता है। बनाए गए boleto या PIX के लिए, या जाँच में चल रहे भुगतान के लिए, पेज Your PagBank payment is awaiting confirmation (boleto / PIX / analysis). The order will be confirmed as soon as PagBank reports the payment. भी दिखाता है। समीक्षा स्थिति वाले ऑर्डर के लिए यह We are confirming your payment with PagBank. The order will be updated automatically — please do not pay again. दिखाता है। यदि ग्राहक के लौटने तक PagBank ने भुगतान की पुष्टि नहीं की है, तो Payment confirmation पेज वही पाठ Check again और Back to checkout बटनों के साथ दिखाता है।
यदि भुगतान पूरा नहीं हुआ, तो ग्राहक The PagBank payment was not completed. You can try again or choose another payment method., The PagBank payment page has expired. You can try again or choose another payment method. या The payment was declined by PagBank. Please try again with another card or payment method. के साथ चेकआउट पर वापस आ जाता है। कार्ट रखा जाता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखते हैं। यदि boleto या PIX के भुगतान की प्रतीक्षा कर रहा ऑर्डर रद्द हो गया, तो ग्राहक The PagBank payment was cancelled, so the order was cancelled. देखता है। यदि कार्ट पहले से खाली है (उदाहरण के लिए, boleto या PIX की समय सीमा समाप्त होने से पहले ऑर्डर सफलता पेज तक पहुँच गया था), तो चेकआउट पर भुगतान करने के लिए कुछ नहीं है: इसके बजाय एक Payment confirmation पेज संदेश दिखाता है; बिना भुगतान वाले ऑर्डर के लिए यह The PagBank payment of order #N was not completed (declined, canceled or expired), so the order will not be shipped. To buy these items, please place a new order. है, जिसके साथ Continue बटन होता है।
OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर एक नया ऑर्डर बनाता है। OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसे अपडेट करता है, इसलिए अस्वीकृत कार्ड, अधूरे भुगतान या समाप्त हो चुके पेज के बाद ग्राहक नए PagBank चेकआउट के साथ वही ऑर्डर चुकाता है। नए भुगतान से पहले एक्सटेंशन उसी ऑर्डर और कार्ट के पिछले PagBank चेकआउट जाँचता है: किसी पिछले पेज पर किया गया भुगतान नया भुगतान बनाने के बजाय लागू किया जाता है, और यदि कार्ट के किसी अन्य ऑर्डर का भुगतान हो चुका है या वह प्रतीक्षा में है, तो ग्राहक सफलता पेज पर चला जाता है। ऑर्डर का खुला चेकआउट तभी पुनः उपयोग होता है जब राशि और वातावरण समान हों और वह 10 मिनट के भीतर समाप्त न हो रहा हो; अन्यथा उसे निष्क्रिय कर दिया जाता है, ताकि उसका भुगतान अब न हो सके। यदि फिर भी दूसरा भुगतान आता है, तो एक नोट आपसे उसे रिफ़ंड करने के लिए कहता है।
यदि ऑर्डर का भुगतान हो चुका था और फिर आपने उसे बंद कर दिया (उदाहरण के लिए रद्द या रिफ़ंड करके), तो PagBank से लौटने वाले ग्राहक को सफलता पेज नहीं दिखता: ग्राहक Your previous order #(number) was closed by the store. Please confirm the order again to pay with a new order. के साथ चेकआउट पर वापस आता है, या जब कार्ट पहले से खाली हो, तो Payment confirmation पेज पर यही संदेश देखता है।
OpenCart 4 सफलता पेज दिखाए जाने तक ऑर्डर को चेकआउट में रखता है। यदि इस बीच वह ऑर्डर बंद हो गया, तो Confirm Order ग्राहक को मेल खाते संदेश के साथ चेकआउट पर वापस भेजता है: ऊपर बताए गए रद्द boleto या PIX और अस्वीकृत भुगतान के संदेश, Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order., या जिस ऑर्डर का भुगतान हो चुका था और फिर आपने बंद कर दिया, उसके लिए स्टोर द्वारा ऑर्डर बंद किए जाने का संदेश। अगला Confirm Order एक नया ऑर्डर चुकाता है। यदि वह ऑर्डर पहले से भुगतान किया हुआ या प्रतीक्षारत है और कार्ट में अब अन्य उत्पाद या मात्राएँ हैं, तो संदेश यह है: Your previous order #(number) has already been placed. Your cart has changed: please confirm the new order to pay for it.
यदि PagBank भुगतान शुरू नहीं कर पाता, तो ग्राहक एक छोटे संदेश के साथ Confirm Order चरण पर रहता है, उदाहरण के लिए 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. तकनीकी कारण लॉग में लिखा जाता है।
स्टोर के मेंटेनेंस मोड में होने के दौरान भी सूचनाएँ काम करती हैं: OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को जाने देता है, और OpenCart 4 पर एक्सटेंशन एक startup action जोड़ता है, जो सूचनाओं और PagBank से ग्राहक की वापसी को जाने देता है।
इस एक्सटेंशन में साइट पर कार्ड फ़ॉर्म, सेव किए गए कार्ड, सब्सक्रिप्शन या आवर्ती भुगतान, और न ही विभाजित भुगतान या मार्केटप्लेस हैं। भुगतान विधियाँ और किस्तें वही हैं जो आपके PagBank खाते में कॉन्फ़िगर की गई हैं।
ऑर्डर और रिफ़ंड
ऑर्डर स्थितियाँ
No status (missing order): ग्राहक को PagBank पर भेजा गया था और उसने भुगतान नहीं किया, कार्ड अस्वीकार हुआ या भुगतान पेज की समय सीमा समाप्त हो गई; ग्राहक फिर से भुगतान कर सकता है। Sales > Orders में ऐसे ऑर्डर केवल तभी दिखते हैं जब Order Status फ़िल्टर को Missing Orders पर सेट किया गया हो।
OpenCart 4 पर चेकआउट का कोई बिना भुगतान वाला ऑर्डर Voided स्टेटस पा सकता है, जिसे OpenCart 4 तब सेट करता है जब ग्राहक Confirm Order चरण पर वापस आता है। एक्सटेंशन ऐसे ऑर्डर को बिना स्टेटस वाला ऑर्डर मानता है, और बाद का कोई भी भुगतान उसकी पुष्टि कर देता है।
Order Status After Payment (default Processing): भुगतान अपेक्षित राशि और मुद्रा के साथ पुष्ट हुआ। एक नोट राशि, भुगतान विधि और PagBank चार्ज ID दिखाता है।
Awaiting PagBank Payment Status (default Pending): एक boleto या PIX बनाया गया और भुगतान की प्रतीक्षा है, या भुगतान जाँच में है। जब PagBank उसे भुगतान किया हुआ बताता है, तो ऑर्डर Order Status After Payment पर चला जाता है।
PagBank Payment On Hold Status (default Pending): PagBank ने ऑर्डर से अलग राशि या मुद्रा बताई; ऑर्डर रद्द होने के बाद भुगतान आया (स्टॉक जाँचें, फिर ऑर्डर पूरा करें या PagBank में भुगतान रिफ़ंड करें); या कार्ड भुगतान अधिकृत हुआ पर कैप्चर नहीं हुआ (PagBank में कैप्चर करें)। नोट इसकी व्याख्या करता है। वास्तव में प्राप्त राशि रिफ़ंड के लिए दर्ज की जाती है।
Payment Declined Status (default Failed): प्रतीक्षारत या जाँच में चल रहा भुगतान अस्वीकार कर दिया गया।
Payment Cancelled Status (default Canceled): प्रतीक्षारत भुगतान, उदाहरण के लिए समय सीमा समाप्त हुआ boleto या PIX, रद्द कर दिया गया।
Refunded Status (default Refunded): भुगतान एक्सटेंशन के माध्यम से या PagBank डैशबोर्ड में पूरी तरह रिफ़ंड कर दिया गया।
हर PagBank स्थिति एक बार लागू होती है, इसलिए दोहराई गई सूचनाएँ या वापसी कोई नोट या स्थिति परिवर्तन नहीं जोड़ते। भुगतान किया हुआ ऑर्डर कभी वापस नहीं बदला जाता। यदि पहले से भुगतान किए गए ऑर्डर के लिए दूसरा भुगतान आता है, तो ऑर्डर नहीं बदला जाता और एक नोट आपसे PagBank में डुप्लिकेट भुगतान रिफ़ंड करने के लिए कहता है। नोट ऑर्डर के History की प्रविष्टियाँ हैं, जिन्हें ग्राहक नहीं देखता।
VibeFox PagSeguro Gateway टैब
Sales > Orders में PagBank से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox PagSeguro Gateway टैब sandbox भुगतानों के लिए Sandbox लेबल के साथ PagBank checkout, PagBank order और Charge ID, Payment method, Status, Paid / refunded राशियाँ, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के PagBank notes दिखाता है। यह टैब उन उपयोगकर्ताओं को दिखाया जाता है जिनकी एक्सटेंशन तक पहुँच है।
रिफ़ंड
VibeFox PagSeguro Gateway टैब में Amount दर्ज करें (जो राशि अभी रिफ़ंड नहीं हुई है वह भर दी जाती है), वैकल्पिक रूप से Reason (optional), और Refund via PagBank पर क्लिक करें। प्रश्न Refund this amount through PagBank? This cannot be undone. की पुष्टि करें। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। आपको एक्सटेंशन बदलने का अधिकार चाहिए (System > Users > User Groups में सेट)। सीमा वह राशि है जो PagBank ने वसूली थी, इसलिए राशि में अंतर के बाद आप ऑर्डर के कुल तक नहीं, बल्कि ग्राहक द्वारा वास्तव में चुकाई गई राशि तक रिफ़ंड कर सकते हैं। रिफ़ंड उसी वातावरण और टोकन से भेजा जाता है जिसमें भुगतान हुआ था। रिफ़ंड तभी दर्ज होता है जब PagBank उसकी पुष्टि करे; अन्यथा टैब त्रुटि दिखाता है, उदाहरण के लिए PagBank refund failed: ... या PagBank did not confirm the refund, और कुछ भी दर्ज नहीं होता। boleto भुगतानों के रिफ़ंड और PIX के आंशिक रिफ़ंड PagBank के नियमों का पालन करते हैं। सफल रिफ़ंड चार्ज ID के साथ रिफ़ंड इतिहास और नोट्स में जोड़ा जाता है। पूर्ण रिफ़ंड ग्राहक को सूचित किए बिना और उत्पादों को स्टॉक में लौटाए बिना ऑर्डर को Refunded Status पर सेट करता है, जैसे मैन्युअल स्टेटस परिवर्तन। आंशिक रिफ़ंड स्थिति नहीं बदलता। रिफ़ंड तभी उपलब्ध हैं जब PagBank ने भुगतान को भुगतान किया हुआ बताया हो।
Sales > Returns में उत्पाद वापसी PagBank के माध्यम से पैसे वापस नहीं भेजती।
PagBank डैशबोर्ड में किए गए रिफ़ंड अगली सूचना या जाँच पर दिखाई देते हैं: पूर्ण रिफ़ंड ऑर्डर को Refunded Status पर सेट करता है, आंशिक रिफ़ंड रिफ़ंड राशि के साथ एक नोट जोड़ता है।
लाइसेंस कुंजी
यह एक्सटेंशन vibefox.net से प्राप्त VibeFox लाइसेंस कुंजी के साथ काम करता है। License — VibeFox PagSeguro Gateway लाइसेंस ब्लॉक Extensions > Extensions > Payments > VibeFox PagSeguro Gateway > Edit पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक कुंजी को मास्क किए हुए रूप में, स्टेटस (उदाहरण के लिए वह तारीख जब तक लाइसेंस सक्रिय है, और आपका डोमेन) दिखाता है, और स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key और इस स्टोर से कुंजी हटाने के लिए Remove key बटन दिखाता है। उनके नीचे Product: opencart-payment-pagseguro वाली पंक्ति और 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 खाते में स्लॉट खाली करें।
सक्रिय कुंजी के बिना, चेकआउट पर PagBank ग्राहकों को नहीं दिखाया जाता। यदि फिर भी भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। उसी ब्राउज़र में एडमिन में लॉग इन किया हुआ एडमिन उपयोगकर्ता स्टोर में अब भी भुगतान विधि देखता है, जिस पर (unlicensed — visible to admins only) का चिह्न होता है, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट करके परीक्षण कर सकें। OpenCart 4 पर यह सुविधा उपलब्ध नहीं है: स्टोर एडमिन लॉगिन नहीं देखता, इसलिए सक्रिय कुंजी के बिना भुगतान विधि सभी से छिपी रहती है। Edit पेज एक बार खोलने के बाद एडमिन Dashboard पर एक अनुस्मारक दिखता है। उसे × से बंद करने पर वह 7 दिनों के लिए छिप जाता है। मौजूदा ऑर्डर प्रभावित नहीं होते: पहले से शुरू हुए भुगतान अब भी पुष्ट होते हैं और रिफ़ंड काम करते हैं।
जब कोई लाइसेंस समाप्त होता है, तो एक्सटेंशन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। जब आप एडमिन Dashboard या Edit पेज खोलते हैं, तो स्थिति अपने-आप दोबारा जाँची जाती है: कुंजी दर्ज होने के बाद पहले 14 दिनों तक रोज़ एक बार, फिर सप्ताह में एक बार। किसी cron जॉब की आवश्यकता नहीं है। एक्सटेंशन अनइंस्टॉल करने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हट जाती हैं।
समस्या निवारण
PagBank does not appear at checkout: जाँचें कि लाइसेंस सक्रिय है, Enable / Disable चालू है, वर्तमान मोड का टोकन सेट है (सैंडबॉक्स मोड में Sandbox token, लाइव मोड में Production token) और ग्राहक BRL में चेकआउट करता है। जब टोकन गायब हो या स्टोर की मुद्रा BRL न हो, तो सेटिंग्स पेज चेतावनी दिखाता है। यह भी जाँचें कि भुगतान पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स में दिए गए Total तक पहुँचता है।
The payment went through, but the order stays without a status: PagBank ने अभी तक भुगतान की रिपोर्ट नहीं की है और ग्राहक स्टोर पर वापस नहीं आया। सूचना आते ही ऑर्डर को स्टेटस मिल जाएगा। जाँचें कि आपका स्टोर Notification URL पर इंटरनेट से पहुँचने योग्य है, और सूचनाएँ देखने के लिए Debug log चालू करें।
The notification answers Invalid signature: x-authenticity-token उस वातावरण के टोकन से मेल नहीं खाता जिसमें भुगतान हुआ था, या वह टोकन सहेजा नहीं गया है। जाँचें कि सेटिंग्स में सही टोकन है।
The notification answers Verification failed, retry later: PagBank API तक नहीं पहुँचा जा सका, भुगतान के वातावरण का टोकन गायब है, या उसी समय कार्ट किसी और अनुरोध द्वारा संसाधित हो रहा था। PagBank सूचना को दोबारा भेजता है।
The notification answers Order not found: सूचना ऐसे ऑर्डर के लिए है जो इस स्टोर में इस एक्सटेंशन से नहीं चुकाया गया था। कुछ नहीं बदला जाता।
The customer sees PagBank payments are temporarily unavailable. Please choose another payment method.: वर्तमान मोड का टोकन गायब है या PagBank ने उसे अस्वीकार किया।
The customer sees PagSeguro/PagBank only accepts payments in Brazilian Real (BRL).: चेकआउट किसी अन्य मुद्रा में है।
The customer sees This order has no amount to pay.: ऑर्डर का कुल शून्य है।
Order is in the review status after payment: VibeFox PagSeguro Gateway टैब के नोट पढ़ें (देखें ऑर्डर स्थितियाँ), PagBank में राशियों की तुलना करें, फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।
No refund form in the tab: टैब कारण बताता है: भुगतान अभी भुगतान किया हुआ नहीं बताया गया है, वह पूरी तरह रिफ़ंड हो चुका है, आपके उपयोगकर्ता समूह के पास एक्सटेंशन बदलने का अधिकार नहीं है, या भुगतान के वातावरण का टोकन सेट नहीं है।
Refund fails with a message about the token: भुगतान सैंडबॉक्स में या प्रोडक्शन में किया गया था, और उस वातावरण का टोकन गायब है या अस्वीकार कर दिया गया। सही टोकन दर्ज करें और फिर से प्रयास करें।
डेवलपर्स के लिए: PagBank चेकआउट बनाए जाने से पहले, एक्सटेंशन अनुरोध बॉडी, ऑर्डर और वातावरण के साथ OpenCart इवेंट wc_psg_checkout_data को ट्रिगर करता है। आइटम की राशि ऑर्डर के कुल के बराबर रहनी चाहिए।
अनइंस्टॉल
Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox PagSeguro Gateway के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटाई जाती हैं। OpenCart एक्सटेंशन की अपनी सेटिंग्स हमेशा हटा देता है: Enable / Disable, Sort Order, Geo Zone, Total और Orders अनुभाग के ऑर्डर स्टेटस, जो फिर से इंस्टॉल करने पर अपने डिफ़ॉल्ट पर लौट आते हैं। एक्सटेंशन का OpenCart इवेंट भी हटा दिया जाता है (OpenCart 4 पर इसके इवेंट और इसका startup action हटते हैं, जो मेंटेनेंस मोड में सूचनाओं और ग्राहक की वापसी को जाने देता है)। यदि Delete Data on Uninstall चालू है, तो बाकी गेटवे सेटिंग्स (शीर्षक, विवरण, सैंडबॉक्स मोड, टोकन, लॉगिंग) और लॉग हटा दिए जाते हैं। यदि बंद है, तो उन्हें बाद में फिर से इंस्टॉल करने के लिए रखा जाता है। PagBank भुगतान और रिफ़ंड रिकॉर्ड हमेशा रखे जाते हैं, इसलिए पहले भुगतान किए गए ऑर्डर फिर से इंस्टॉल करने के बाद भी रिफ़ंड किए जा सकते हैं। मौजूदा ऑर्डर अपनी भुगतान नोट्स रखते हैं।
OpenCart 4 पर, एक्सटेंशन की फ़ाइलें भी हटाने के लिए अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल किए गए एक्सटेंशन की सूची में VibeFox PagSeguro Gateway के बगल में Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किया गया पैकेज हटाने के लिए Delete (लाल कूड़ेदान बटन) पर क्लिक करें।
PagSeguro और PagBank अपने-अपने मालिकों के ट्रेडमार्क हैं। यह एक्सटेंशन PagSeguro या PagBank से संबद्ध नहीं है और न ही उनके द्वारा अनुमोदित है।