VibeFox Iugu for OpenCart — सहायता

आवश्यकताएँ

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

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

मुद्रा: ब्राज़ीलियाई रियल (BRL)। Iugu केवल BRL में भुगतान लेता है, इसलिए स्टोर में System > Localisation > Currencies में BRL मुद्रा होनी चाहिए। जब ग्राहक के चेकआउट की मुद्रा कोई और हो, या कुल राशि R$ 1,00 (Iugu की न्यूनतम राशि) से कम हो, तो भुगतान का यह तरीका छिप जाता है।

Iugu खाता: आपको Iugu डैशबोर्ड से दो API टोकन चाहिए, एक "Test" प्रकार का और एक "Live" प्रकार का (देखें Configuration)। Iugu दोनों के लिए एक ही API पता इस्तेमाल करता है: टोकन तय करता है कि इनवॉइस टेस्ट हैं या असली। Iugu में कोई वेबहुक सेट करने की ज़रूरत नहीं है।

CPF/CNPJ (वैकल्पिक): OpenCart में अपना CPF फ़ील्ड नहीं है। यदि आप ग्राहक या पते का कोई कस्टम फ़ील्ड जोड़ते हैं जिसके नाम में CPF या CNPJ है (Customers > Custom Fields), तो उसका मान Iugu को भेजा जाता है।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. टेस्ट और लाइव API टोकन दर्ज करें (देखें Configuration), Test mode चालू रहने दें, Enable / Disable चालू करें और Save पर क्लिक करें।

5. BRL में एक टेस्ट ऑर्डर दें और Iugu टेस्ट भुगतान के साथ Iugu पेज पर भुगतान करें। सब तैयार होने पर Test mode बंद कर दें।

OpenCart 4

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

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

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

4. लाइसेंस कुंजी और API टोकन उसी तरह दर्ज करें जैसे OpenCart 3 के चरण 3 से 5 में। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल Notification URL अलग है (देखें भुगतान सूचनाएँ)।

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

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

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

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

Iugu

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

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

Description: वह टेक्स्ट जो ग्राहक को Confirm Order चरण में, कन्फ़र्म बटन के ऊपर दिखता है। डिफ़ॉल्ट: Iugu के माध्यम से सुरक्षित भुगतान करें। भुगतान पूरा करने के लिए आपको पुनर्निर्देशित किया जाएगा।

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

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

Total: स्टोर की डिफ़ॉल्ट मुद्रा में चेकआउट की कुल राशि, जिस तक पहुँचने पर ही Iugu दिया जाता है। किसी भी राशि के लिए Iugu देने हेतु खाली छोड़ें। Iugu स्वयं कम से कम R$ 1,00 माँगता है।

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

Iugu Alia में API टोकन बनाएँ (सेक्शन वहाँ का लिंक देता है): Settings > API integration > New। एक "Test" प्रकार का टोकन और एक "Live" प्रकार का टोकन बनाएँ।

Test mode: टेस्ट API टोकन इस्तेमाल करता है, इसलिए कोई असली शुल्क नहीं लिया जाता। डिफ़ॉल्ट: चालू। टेस्ट मोड चालू होने पर ग्राहक Confirm Order चरण में विवरण के ऊपर SANDBOX — Test mode enabled. No real charges. देखते हैं। किसी ऑर्डर की स्टेटस जाँच और रिफ़ंड हमेशा उसी मोड का टोकन इस्तेमाल करते हैं जिसमें उसका इनवॉइस बना था, इसलिए मोड बदलने से पुराने ऑर्डर नहीं टूटते।

Test API token: "Test" प्रकार का Iugu API टोकन। टेस्ट मोड चालू होने पर इस्तेमाल होता है।

Live API token: "Live" प्रकार (प्रोडक्शन) का Iugu API टोकन। टेस्ट मोड बंद होने पर इस्तेमाल होता है। इसे गोपनीय रखें।

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

भुगतान सूचनाएँ

Notification URL: हर इनवॉइस Iugu को बताता है कि स्थिति में बदलाव आपके स्टोर के इस URL पर भेजे। OpenCart 3 पर यह https://your-store/index.php?route=extension/payment/wcp_iugu_gateway/webhook जैसा दिखता है, OpenCart 4 पर https://your-store/index.php?route=extension/wcp_iugu_gateway/payment/wcp_iugu_gateway.webhook जैसा। इंटरनेट से पहुँच योग्य होना चाहिए। Iugu में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है। उसी URL की ओर इशारा करने वाला खाता-स्तरीय अतिरिक्त ट्रिगर हानिकारक नहीं है। सूचनाओं में ऐसा कोई भुगतान डेटा नहीं होता जिस पर स्टोर भरोसा करे: ऑर्डर बदलने से पहले इनवॉइस हमेशा Iugu API से दोबारा पढ़ा जाता है (स्थिति, राशि, मुद्रा)।

एक्सटेंशन इस सेक्शन में सूचीबद्ध Iugu इवेंट्स पर प्रतिक्रिया देता है: invoice.status_changed, invoice.refund, invoice.released, invoice.dunning_action और invoices। इनमें से हर एक के लिए वह इनवॉइस पढ़ता है और उसकी स्थिति लागू करता है:

जिस ऑर्डर का अभी तक कोई स्टेटस नहीं है, उसका समाप्त या रद्द इनवॉइस ऑर्डर को बिना स्टेटस के छोड़ देता है, ताकि ग्राहक फिर से भुगतान कर सके। अन्य इवेंट्स और वे इनवॉइस जो आपके स्टोर ने नहीं बनाए, HTTP 200 से उत्तर पाते हैं और Iugu को बिना अनुरोध किए अनदेखे रहते हैं। सूचनाओं के बिना, इनवॉइस केवल तभी जाँचा जाता है जब ग्राहक Iugu पेज से स्टोर पर लौटता है।

ऑर्डर

OpenCart Confirm Order चरण पर ऑर्डर बिना स्टेटस के बनाता है (एक लापता ऑर्डर)। Iugu द्वारा इनवॉइस की रिपोर्ट करने के बाद, सूचना से या ग्राहक के लौटने पर, ही उसे स्टेटस मिलता है; इनवॉइस हमेशा Iugu से पढ़ा जाता है। नीचे का हर फ़ील्ड आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध करता है।

Order Status After Payment: सत्यापित Iugu भुगतान के बाद सेट होता है। डिफ़ॉल्ट: प्रक्रिया में।

Awaiting Iugu Payment Status: ग्राहक जारी किए गए boleto या PIX के साथ Iugu पेज से लौटा; Iugu बाद में राशि की पुष्टि करेगा। डिफ़ॉल्ट: भुगतान लंबित।

Iugu Payment On Hold Status: कार्ड भुगतान अधिकृत है पर कैप्चर नहीं हुआ, भुगतान जाँच में है, आंशिक भुगतान हुआ, चार्जबैक, राशि या मुद्रा ऑर्डर से अलग है, या ऑर्डर रद्द होने के बाद भुगतान आया। एक नोट कारण बताता है; उसे मैन्युअली जाँचें। डिफ़ॉल्ट: भुगतान लंबित, क्योंकि OpenCart में "On hold" स्टेटस नहीं है। आप System > Localisation > Order Statuses में अपना स्टेटस बना सकते हैं और यहाँ चुन सकते हैं।

Invoice Expired Status: प्रतीक्षारत ऑर्डर का इनवॉइस बिना भुगतान के समाप्त हो गया। यदि बाद में Iugu उसे भुगतान किया हुआ बताता है, तो ऑर्डर को भुगतान के बाद का स्टेटस मिलता है। डिफ़ॉल्ट: विफल।

Invoice Canceled Status: प्रतीक्षारत ऑर्डर का इनवॉइस Iugu में रद्द किया गया। डिफ़ॉल्ट: रद्द।

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

उन्नत

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

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

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

आयात / निर्यात

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

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

चेकआउट

Payment Method चरण पर ग्राहक भुगतान का तरीका चुनता है (डिफ़ॉल्ट रूप से Iugu)। Confirm Order चरण पर ग्राहक को आपका विवरण और यह नोट दिखता है: You will be redirected to the Iugu invoice page to pay by credit card, boleto or PIX. OpenCart इसी चरण पर ऑर्डर बनाता है, अभी भी बिना स्टेटस के। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर की कुल राशि के लिए BRL में एक Iugu इनवॉइस बनाता है, जिसकी देय तिथि 3 दिन है, और ग्राहक को Iugu इनवॉइस पेज पर भेज देता है। एक वैध ईमेल आवश्यक है। इनवॉइस पर Order # और ऑर्डर नंबर दिखते हैं। वहाँ ग्राहक क्रेडिट कार्ड, boleto या PIX से भुगतान करता है, उन तरीकों से जो आपके Iugu खाते में सक्षम हैं। ग्राहक का नाम और ईमेल Iugu को भेजे जाते हैं, साथ ही CPF या CNPJ नाम के कस्टम फ़ील्ड से CPF/CNPJ भी, यदि उसमें 11 या 14 अंक हों। फ़ोन और पता केवल उसी रूप में भेजे जाते हैं जिसे Iugu स्वीकार करता है (ब्राज़ीलियाई फ़ोन नंबर, 8 अंकों के CEP वाले ब्राज़ीलियाई पते; मकान नंबर s/n के रूप में भेजा जाता है)।

OpenCart 4 में ग्राहक Payment method options विंडो में, भुगतान विधि ब्लॉक के Choose बटन से भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। डिफ़ॉल्ट रूप से OpenCart 4 भुगतान पता नहीं माँगता; तब एक्सटेंशन शिपिंग पते का पता और उसका CPF/CNPJ कस्टम फ़ील्ड लेता है।

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Iugu उसकी पुष्टि करता है: जब ग्राहक लौटता है और जब Iugu सूचना भेजता है, तब इनवॉइस Iugu API से पढ़ा जाता है। फिर ऑर्डर को OpenCart के मानक तरीके से स्टेटस मिलता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है।

यदि ग्राहक ने boleto या PIX कोड बनाया और भुगतान से पहले लौट आया, तो ऑर्डर को Awaiting Iugu Payment Status मिलता है और सफलता पेज पर Your Iugu invoice is awaiting payment (boleto / PIX). The order will be confirmed as soon as Iugu reports the payment. दिखता है। जब Iugu भुगतान की रिपोर्ट करता है (सूचना से, या जब ग्राहक लौटने वाला लिंक दोबारा खोलता है), तब ऑर्डर भुगतान किए गए स्टेटस में चला जाता है। होल्ड पर रखे ऑर्डर के लिए सफलता पेज पर We are confirming your payment with Iugu. The order will be updated automatically — please do not pay again. दिखता है। यदि ग्राहक के लौटने पर Iugu से संपर्क नहीं हो सका या उसने भुगतान की रिपोर्ट नहीं की है, तो वही टेक्स्ट और Check again और Back to checkout बटन वाला एक Payment confirmation पेज दिखता है।

यदि इनवॉइस रद्द हुआ या समाप्त हो गया है, तो ग्राहक The Iugu invoice was not paid (it was canceled or has expired). Your cart is kept: confirm the order again to pay. संदेश के साथ चेकआउट पर लौट आता है। यदि ऑर्डर इसलिए रद्द हुआ क्योंकि उसका Iugu इनवॉइस रद्द हो गया था, तो संदेश Your order was cancelled because its Iugu invoice was canceled. है। यदि कार्ट पहले से खाली है (boleto या PIX ऑर्डर इनवॉइस समाप्त होने से पहले सफलता पेज तक पहुँच चुका था), तो ग्राहक को इसके बजाय एक Payment confirmation पेज दिखता है, जिस पर The Iugu invoice of order #... was not paid (it was canceled or has expired), so the order will not be shipped. To buy these items, please place a new order. (या रद्द होने का संदेश) और एक Continue बटन होता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखते हैं। OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर एक नया ऑर्डर बनाता है; OpenCart 4 चेकआउट के ऑर्डर को अपडेट करता है, इसलिए समाप्त या रद्द इनवॉइस के बाद ग्राहक नए इनवॉइस के साथ वही ऑर्डर चुकाता है। एक कार्ट का भुगतान केवल एक बार होता है। नया इनवॉइस बनाने से पहले एक्सटेंशन कार्ट के पिछले इनवॉइस जाँचता है: यदि उनमें से कोई भुगतान किया हुआ है, तो वह भुगतान लागू होता है और ग्राहक सफलता पेज पर जाता है; यदि उसी ऑर्डर का एक खुला इनवॉइस उसी राशि और मोड के साथ अभी भी है, तो ग्राहक उसी पर वापस भेजा जाता है; अन्य खुले इनवॉइस Iugu में रद्द हो जाते हैं। यदि कोई पुराना इनवॉइस फिर भी भुगतान किया गया, तो भुगतान फिर भी मिलाया जाता है, और पहले से भुगतान किए गए कार्ट का दोहरा भुगतान एक नोट के साथ चिह्नित होता है। कार्ट में कोई भी बदलाव, नई मात्रा सहित, एक नए कार्ट के रूप में गिना जाता है जिसे अपने भुगतान की ज़रूरत है।

OpenCart 4 में ऑर्डर तब तक चेकआउट में रहता है जब तक सफलता पेज नहीं दिखता। यदि वह ऑर्डर इस बीच बंद कर दिया गया हो (उदाहरण के लिए boleto की अवधि समाप्त हो गई या आपने उसे रद्द किया), तो ग्राहक The Iugu invoice was not paid (it was canceled or has expired). Your cart is kept: confirm the order again to pay. के साथ चेकआउट पर लौटा दिया जाता है, या, यदि वह बंद होने से पहले भुगतान हो चुका था, तो This order was closed by the store, so it will not be shipped. Your cart is kept: confirm the order again to pay. के साथ। यदि ऑर्डर पहले ही दिया जा चुका है और कार्ट में अब नई खरीद है, तो Confirm Order चेकआउट पेज को दोबारा लोड करता है। दोनों स्थितियों में अगला Confirm Order कार्ट का नया ऑर्डर भुगतान करता है।

यदि Iugu इनवॉइस नहीं बना सकता, तो ग्राहक Confirm Order चरण पर एक छोटे संदेश के साथ रुका रहता है, जैसे Iugu could not create the invoice: कारण और बिलिंग विवरण जाँचने के अनुरोध के साथ, या Could not connect to Iugu. Please try again in a moment. तकनीकी कारण लॉग में लिखा जाता है।

स्टोर के मेंटेनेंस मोड में भी सूचना URL काम करता है: OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को जाने देता है, और OpenCart 4 पर एक्सटेंशन एक startup action जोड़ता है जो सूचना और ग्राहक की वापसी को आगे जाने देता है।

एक्सटेंशन केवल एकमुश्त भुगतान लेता है। इसमें साइट पर कार्ड फ़ॉर्म, सहेजे गए कार्ड, सदस्यताएँ या आवर्ती बिलिंग, carnê (भुगतान पुस्तिकाएँ), विभाजित भुगतान या किस्त की सेटिंग्स नहीं हैं — किस्तों के लिए Iugu पेज की सेटिंग्स इस्तेमाल करें। Iugu पेज पर दिए जाने वाले भुगतान तरीके एक्सटेंशन की सेटिंग्स में नहीं चुने जा सकते: आपके Iugu खाते में सक्षम सभी तरीके दिए जाते हैं।

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

ऑर्डर स्टेटस

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

Order Status After Payment (डिफ़ॉल्ट प्रक्रिया में): Iugu ने भुगतान की पुष्टि की। एक नोट इनवॉइस ID और भुगतान का तरीका (क्रेडिट कार्ड, boleto या PIX) दिखाता है।

Awaiting Iugu Payment Status (डिफ़ॉल्ट भुगतान लंबित): ग्राहक जारी किए गए boleto या PIX के साथ लौटा। Iugu भुगतान की रिपोर्ट करने पर ऑर्डर भुगतान किए गए स्टेटस में चला जाता है।

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

Invoice Expired Status (डिफ़ॉल्ट विफल): प्रतीक्षारत ऑर्डर का इनवॉइस बिना भुगतान के समाप्त हो गया। यदि Iugu बाद में इनवॉइस को भुगतान किया हुआ बताता है, तो ऑर्डर भुगतान किए गए स्टेटस में चला जाता है।

Invoice Canceled Status (डिफ़ॉल्ट रद्द): प्रतीक्षारत ऑर्डर का इनवॉइस Iugu में रद्द किया गया।

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

यदि उसी ऑर्डर या कार्ट का कोई और इनवॉइस भी भुगतान किया हुआ है, तो ऑर्डर नहीं बदलता। एक नोट आपसे डुप्लिकेट भुगतान को Iugu में रिफ़ंड करने के लिए कहता है। नोट ऑर्डर के History की वे प्रविष्टियाँ हैं जिन्हें ग्राहक नहीं देखता। जब कोई प्रतीक्षारत ऑर्डर बाद में भुगतान किया जाता है, समाप्त होता है या रद्द होता है, तो OpenCart ग्राहक को नए स्टेटस की सूचना देता है।

VibeFox Iugu Gateway टैब

Sales > Orders में Iugu से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Iugu Gateway टैब Iugu invoice ID (Iugu में इनवॉइस से जुड़ा हुआ) दिखाता है, टेस्ट इनवॉइस के लिए Test mode लेबल के साथ, साथ में Payment method, Status, Paid / refunded राशियाँ, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के Iugu notes। यह टैब उन उपयोगकर्ताओं को दिखता है जिनकी एक्सटेंशन तक पहुँच है।

रिफ़ंड

VibeFox Iugu Gateway टैब में Amount दर्ज करें (जो राशि अभी रिफ़ंड नहीं हुई है, वह भर दी जाती है), वैकल्पिक रूप से Reason (optional), और Refund via Iugu पर क्लिक करें। Refund this amount through Iugu? This cannot be undone. प्रश्न की पुष्टि करें। आपके पास एक्सटेंशन बदलने का अधिकार होना चाहिए (System > Users > User Groups में सेट)। रिफ़ंड उस मोड के टोकन से भेजा जाता है जिसमें इनवॉइस बना था, इसलिए वह टोकन सेट होना चाहिए।

रिफ़ंड उस राशि से गिने जाते हैं जो Iugu ने इनवॉइस के लिए वास्तव में लिया है, इसलिए राशि में अंतर के बाद आप ऑर्डर के कुल योग तक नहीं, बल्कि ग्राहक द्वारा दिए गए भुगतान तक रिफ़ंड कर सकते हैं। केवल भुगतान किए गए इनवॉइस रिफ़ंड हो सकते हैं, और Iugu में अभी रिफ़ंड योग्य राशि से अधिक नहीं। रिफ़ंड तभी पूरा माना जाता है जब Iugu उसकी पुष्टि करे। यदि Iugu रिफ़ंड अस्वीकार करता है या उसकी पुष्टि नहीं करता, तो टैब त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड इनवॉइस ID और कारण के साथ रिफ़ंड इतिहास और नोट्स में जोड़ा जाता है। पूर्ण रिफ़ंड ग्राहक को सूचित किए बिना और उत्पादों को स्टॉक में वापस किए बिना ऑर्डर को Refunded Status पर सेट करता है, जैसे मैन्युअल स्टेटस बदलाव। आंशिक रिफ़ंड स्टेटस नहीं बदलता। रिफ़ंड तभी उपलब्ध होते हैं जब Iugu इनवॉइस को भुगतान किया हुआ बताता है।

Sales > Returns में उत्पाद वापसी Iugu के माध्यम से पैसे वापस नहीं भेजती।

Iugu डैशबोर्ड में किया गया पूर्ण रिफ़ंड एक नोट के साथ ऑर्डर को Refunded Status पर सेट करता है। डैशबोर्ड में किए गए आंशिक रिफ़ंड आयात नहीं होते।

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

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

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

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

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

चेकआउट पर Iugu दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable / Disable चालू है और सक्रिय मोड का टोकन सेट है: टेस्ट मोड में Test API token, लाइव मोड में Live API token। ग्राहक की चेकआउट मुद्रा BRL होनी चाहिए और कुल राशि कम से कम R$ 1,00। यह भी जाँचें कि भुगतान का पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स के Total तक पहुँचता है। यदि टोकन या मुद्रा गलत है, तो सेटिंग्स पेज चेतावनी दिखाता है।

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

सूचना का उत्तर verification failed है: उस समय इनवॉइस Iugu API से नहीं पढ़ा जा सका, जैसे नेटवर्क त्रुटि, गलत टोकन, या इनवॉइस के मोड का टोकन गायब होने के कारण। Iugu सूचना दोबारा भेजता है।

सूचना का उत्तर busy है: उसी समय कार्ट किसी दूसरे अनुरोध से संसाधित हो रहा था, या ऑर्डर स्टेटस सेट नहीं हो सका। Iugu सूचना दोबारा भेजता है। लॉग कारण दिखाता है।

सूचना का उत्तर invalid invoice id है: सूचना में मान्य इनवॉइस ID नहीं था। कुछ नहीं बदलता।

ऑर्डर Iugu Payment On Hold Status में है: ऑर्डर टैब में Iugu notes पढ़ें। कार्ड भुगतान कैप्चर का इंतज़ार कर रहा है, भुगतान जाँच में है, आंशिक रूप से भुगतान हुआ है या विवादित है, दिया गया भुगतान ऑर्डर से मेल नहीं खाया, या ऑर्डर रद्द होने के बाद भुगतान आया।

ग्राहक को "Iugu payments are not available right now" दिखता है: API टोकन गायब या गलत है। सक्रिय मोड का टोकन जाँचें।

ग्राहक को "A valid billing email is required for Iugu" दिखता है: ऑर्डर में वैध ईमेल पता नहीं है।

ग्राहक को "This order already has an Iugu payment that the store has to review" दिखता है: ऑर्डर के पिछले किसी इनवॉइस को अधिकृत, जाँच में या आंशिक भुगतान किया गया है। Iugu में इनवॉइस और लॉग जाँचें।

ग्राहक को This payment method is not available. दिखता है: चेकआउट सत्र अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान का तरीका बंद कर दिया गया। ग्राहक चेकआउट को रीलोड करता है।

रिफ़ंड विफल होता है: टैब का संदेश पढ़ें। Boleto भुगतान Iugu के माध्यम से रिफ़ंड नहीं हो सकते, PIX भुगतान केवल पूरी तरह रिफ़ंड हो सकते हैं, और केवल भुगतान किए गए इनवॉइस रिफ़ंड हो सकते हैं। यदि संदेश कहता है कि भुगतान टेस्ट या लाइव मोड में हुआ और उस मोड का टोकन सेट नहीं है, तो उस मोड का टोकन दर्ज करें। यदि Iugu ने रिफ़ंड की पुष्टि नहीं की, तो फिर से कोशिश करने से पहले Iugu में इनवॉइस जाँचें।

डेवलपर्स के लिए: इनवॉइस बनने से पहले एक्सटेंशन OpenCart इवेंट wc_igu_invoice_data को इनवॉइस अनुरोध और ऑर्डर के साथ ट्रिगर करता है, जैसे payable_with से भुगतान के तरीकों को सीमित करने के लिए।

अनइंस्टॉल

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

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

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