VibeFox Vindi for OpenCart — सहायता

आवश्यकताएँ

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

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

मुद्रा: Brazilian Real (BRL) System > Localisation > Currencies में सेट होना चाहिए। Vindi केवल BRL में चार्ज करता है, इसलिए भुगतान तरीका केवल तब दिखाया जाता है जब ग्राहक BRL में भुगतान करता है।

Vindi खाता: आपको अपने Vindi खाते की API key चाहिए। Vindi sandbox एक अलग Vindi परीक्षण खाता है जिसकी अपनी key है। यदि आप boleto, PIX और BolePix देना चाहते हैं, तो ये भी आपके Vindi खाते में सक्षम होने चाहिए।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. Sandbox API key पेस्ट करें और तैयार होने पर Live API key। Offered methods चुनें।

5. सेटिंग्स से webhook URL कॉपी करके Vindi में डालें (देखें Configuration)।

6. Enable / Disable चालू करें और Save पर क्लिक करें। Sandbox mode में एक टेस्ट भुगतान करें, फिर असली भुगतान लेने के लिए Sandbox mode बंद करें।

OpenCart 4

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

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

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

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

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

Configuration

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

सेव करते समय keys वैसे ही सेव होती हैं जैसी टाइप की गई हैं, शुरू और अंत के खाली स्थान के बिना। यदि कोई भुगतान तरीका चुना नहीं गया है, तो credit card सेव होता है और पेज Choose at least one payment method — credit card was selected. दिखाता है। खाली Title या 128 अक्षरों से लंबा title, पूर्णांक न होने वाला Sort Order (ऋणात्मक मान स्वीकार्य हैं), 0 या उससे अधिक संख्या न होने वाला Total, या मौजूद न होने वाला geo zone या ऑर्डर स्थिति स्वीकार नहीं होता: कुछ सेव नहीं होता और पेज संदेश दिखाता है, जैसे Enter a title for the payment method (1 to 128 characters).

Vindi

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

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

Description: वह टेक्स्ट जो ग्राहक को Confirm Order चरण पर भुगतान फ़ील्ड्स के ऊपर दिखता है। डिफ़ॉल्ट: Pay by credit card on the secure Vindi page, or by boleto / PIX।

Sort Order: चेकआउट पर भुगतान तरीकों के बीच Vindi की स्थिति। खाली छोड़ें या एक पूर्णांक दर्ज करें (ऋणात्मक मान स्वीकार्य हैं)।

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

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

API keys

Keys Vindi dashboard में Settings > API keys के अंतर्गत बनाएँ: live के लिए app.vindi.com.br पर और sandbox के लिए sandbox-app.vindi.com.br पर। Live और sandbox के अलग hosts और keys हैं। हर भुगतान याद रखता है कि उसका बिल कहाँ बना था, इसलिए जाँच, रद्दीकरण और रिफ़ंड हमेशा उसी environment का उपयोग करते हैं।

Sandbox mode: Vindi sandbox में नए भुगतान बनाता है, sandbox-app.vindi.com.br और sandbox API key का उपयोग करते हुए। ग्राहक चेकआउट पर TEST MODE नोट देखते हैं: Vindi sandbox: no real charges. डिफ़ॉल्ट: चालू। असली भुगतान लेने के लिए इसे बंद करें।

Live API key: live Vindi खाते की निजी key। यह केवल Vindi API को भेजी जाती है।

Sandbox API key: Vindi sandbox खाते की निजी key।

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

भुगतान तरीके

Offered methods: वे तरीके जिन्हें ग्राहक चुन सकते हैं। डिफ़ॉल्ट: credit card। ये तरीके आपके Vindi खाते में भी सक्षम होने चाहिए।

Boleto, PIX और BolePix के लिए ग्राहक का CPF या CNPJ चाहिए, जो चेकआउट पर पूछा जाता है।

भुगतान सूचनाएँ (webhook)

Webhook आपके स्टोर को बताता है कि बिल भुगतान, रद्द, अस्वीकार या रिफ़ंड हो गया है। इस सेक्शन का Webhook URL फ़ील्ड URL दिखाता है। OpenCart 3 पर यह कुछ इस तरह दिखता है: https://your-store/index.php?route=extension/payment/wcp_vindi_gateway/webhook&token=..., OpenCart 4 पर इस तरह: https://your-store/index.php?route=extension/wcp_vindi_gateway/payment/wcp_vindi_gateway.webhook&token=...। यह आपकी OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है और एक्सटेंशन द्वारा बनाया गया एक गुप्त token रखता है। इसे ठीक वैसे ही कॉपी करें जैसा सेटिंग्स दिखाती हैं। Vindi में live खाते और sandbox खाते, दोनों में, Settings > Webhooks पर जाएँ, यह URL जोड़ें और ये events चुनें:

Vindi अपनी सूचनाओं पर हस्ताक्षर नहीं करता, इसलिए जिन अनुरोधों में token गायब या गलत है उन्हें अस्वीकार किया जाता है, और हर सूचना केवल इतना करती है कि ऑर्डर बदलने से पहले एक्सटेंशन Vindi API के ज़रिए बिल फिर से पढ़े। यह URL स्टोर के maintenance mode में होने पर भी काम करता है (OpenCart 4 पर एक्सटेंशन की एक startup action webhook और भुगतान स्थिति पेज को आगे जाने देती है)। Vindi बिलों में कोई return URL नहीं होता, इसलिए webhook के बिना कार्ड भुगतान तभी पकड़ में आता है जब ग्राहक उसी कार्ट के साथ ऑर्डर फिर से पुष्ट करता है (तब भुगतान किया हुआ बिल मिल जाता है), और boleto या PIX भुगतान तब पकड़ में आता है जब ग्राहक अपने account में ऑर्डर फिर से खोलता है (My Account > Order History)।

ऑर्डर

OpenCart Confirm Order चरण पर ऑर्डर बिना स्थिति के बनाता है (एक लापता ऑर्डर)। ऑर्डर को स्थिति तभी मिलती है जब Vindi बिल की रिपोर्ट कर दे; बिल हमेशा Vindi से दोबारा पढ़ा जाता है। Boleto, PIX और BolePix ऑर्डर को बिल जारी होते ही awaiting स्थिति मिल जाती है। नीचे का हर फ़ील्ड आपकी OpenCart ऑर्डर स्थितियों की सूची देता है। OpenCart में On Hold स्थिति नहीं है, इसलिए awaiting और on-hold स्थितियाँ दोनों डिफ़ॉल्ट रूप से Pending का उपयोग करती हैं; ऑर्डर नोट्स उन्हें अलग बताते हैं। अपनी स्थितियाँ System > Localisation > Order Statuses में बना सकते हैं और यहाँ चुन सकते हैं।

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

Awaiting Vindi Payment Status: चेकआउट पर boleto, PIX या BolePix जारी हुआ; Vindi बाद में राशि की पुष्टि करता है। भुगतान का डेटा उस history कमेंट में जुड़ता है जो ग्राहक देखता है। डिफ़ॉल्ट: Pending।

Vindi Payment On Hold Status: बिल Vindi पर समीक्षा में है, भुगतान किया गया बिल ऑर्डर से मेल नहीं खाता (मुद्रा, राशि, बिल कोड या Vindi ग्राहक), या ऑर्डर रद्द होने के बाद भुगतान हुआ। एक नोट कारण बताता है। डिफ़ॉल्ट: Pending।

Payment Error Status: Vindi ने प्रतीक्षारत ऑर्डर के भुगतान प्रयास को अस्वीकार किया। ग्राहक वही बिल अब भी भुगतान कर सकता है; बाद का भुगतान भुगतान-के-बाद की स्थिति सेट करता है। डिफ़ॉल्ट: Failed।

Canceled Status: प्रतीक्षारत ऑर्डर का बिल Vindi पर रद्द कर दिया गया। जब आप इस एक्सटेंशन के किसी ऑर्डर को इस स्थिति पर सेट करते हैं, तो उसका लंबित Vindi बिल भी रद्द हो जाता है। डिफ़ॉल्ट: Canceled।

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

उन्नत

Debug log: API calls और सूचनाओं को OpenCart logs फ़ोल्डर (storage/logs, OpenCart 4 पर system/storage/logs) की wc_vdi_debug.log.php फ़ाइल में लॉग करता है। यह फ़ाइल वेब से नहीं खोली जा सकती। त्रुटियाँ और चेतावनियाँ हमेशा लॉग होती हैं, भले ही यह बंद हो। Keys, webhook token और ग्राहक का डेटा कभी लॉग नहीं होता। डिफ़ॉल्ट: बंद।

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

Delete data on uninstall: चालू होने पर एक्सटेंशन हटाने से सेटिंग्स, webhook token, product cache और लॉग हट जाते हैं। ऑर्डर और ऑर्डर के Vindi bill संदर्भ रखे जाते हैं। डिफ़ॉल्ट: बंद।

Import / Export

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

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

Checkout

Payment Method चरण पर ग्राहक भुगतान तरीका चुनता है (डिफ़ॉल्ट रूप से Vindi)। Confirm Order चरण पर ग्राहक आपका विवरण देखता है। जब एक से अधिक तरीके दिए जाते हैं, तो payment box में Pay with और credit card, boleto, PIX या BolePix में से चुनाव दिखता है। जब boleto, PIX या BolePix दिया जाता है, तो box में एक CPF or CNPJ फ़ील्ड भी होता है। जब credit card नहीं दिया जाता, तब यह आवश्यक है; अन्यथा Required for boleto and PIX. दिखता है। यदि ग्राहक के कस्टम फ़ील्ड या CPF या CNPJ नाम के पते में कोई मान्य नंबर है, तो फ़ील्ड उससे भर जाता है। नंबर उसके check digits से जाँचा जाता है। कुछ छूटने पर ग्राहक को Please choose how you want to pay with Vindi., Please enter a valid CPF or CNPJ. या Please enter your CPF or CNPJ — it is required for boleto and PIX. दिखता है। OpenCart 4 पर ग्राहक भुगतान तरीका भुगतान तरीके के ब्लॉक के Choose बटन से चुनता है, विंडो Payment method options में; इन फ़ील्ड्स वाला payment box और Confirm Order बटन चेकआउट पेज के नीचे होते हैं।

जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन इस कार्ट के लिए भुगतान पते से एक Vindi ग्राहक बनाता है, और ऑर्डर कुल के लिए एक single installment में Vindi बिल बनाता है। Vindi में बिल का नाम Order # और OpenCart ऑर्डर नंबर होता है।

Credit card: ग्राहक Vindi के बिल पेज पर भेजा जाता है और वहीं भुगतान करता है। ऑर्डर बिना स्थिति के रहता है। Vindi के पास बिलों के लिए return URL नहीं है, इसलिए ग्राहक अपने-आप स्टोर पर वापस नहीं भेजा जाता। जब Vindi webhook से भुगतान की पुष्टि करता है, तब ऑर्डर को स्थिति मिलती है। यदि ग्राहक उसी कार्ट के साथ ऑर्डर फिर से पुष्ट करता है और बिल पहले से भुगतान हो चुका है, तो भुगतान किया हुआ ऑर्डर पुष्ट होता है और ग्राहक को success पेज दिखता है।

Boleto, PIX और BolePix: बिल तुरंत जारी होता है, ऑर्डर को awaiting स्थिति मिलती है, और ग्राहक OpenCart ऑर्डर success पेज पर पहुँचता है। वहाँ, और ग्राहक के account में ऑर्डर विवरण में, एक Payment सेक्शन PIX QR कोड, Copy code बटन वाला PIX copy-and-paste कोड और उसकी expiry तिथि, और एक Open boleto बटन दिखाता है। ऑर्डर ईमेल और ग्राहक के ऑर्डर इतिहास में PIX कोड और boleto लिंक होते हैं। यदि Vindi boleto या PIX का डेटा नहीं लौटाता, तो बिल रद्द हो जाता है और ग्राहक को एक त्रुटि दिखती है।

ऑर्डर को भुगतान हुआ तभी चिह्नित किया जाता है जब Vindi पुष्टि करे: एक्सटेंशन Vindi API से बिल पढ़ता है और मुद्रा, यह कि बिल ऑर्डर का है (बिल कोड और Vindi ग्राहक), और यह कि भुगतान की गई राशि ऑर्डर कुल के बराबर है, जाँचता है। Success पेज और ग्राहक के account का ऑर्डर पेज प्रतीक्षारत ऑर्डर को API के ज़रिए फिर जाँचते हैं, अधिकतम हर 15 सेकंड में एक बार। भुगतान मिलने पर success पेज Your payment with Vindi has been received. दिखाता है। जब तक भुगतान की पुष्टि नहीं होती, वह We are confirming your payment with Vindi. The order will be updated automatically — please do not pay again. दिखाता है। रद्द ऑर्डर के लिए यह This order was cancelled and its Vindi bill can no longer be paid. Please contact us if you have already paid. दिखाता है।

जब तक भुगतान की पुष्टि नहीं होती, success पेज और ग्राहक के account का ऑर्डर पेज (awaiting या on hold ऑर्डर के लिए) एक Check payment status बटन भी दिखाते हैं। यह ऑर्डर के नवीनतम Vindi बिल की जाँच करता है। पुष्ट या awaiting ऑर्डर अपने भुगतान डेटा के साथ success पेज पर लौट आता है। यदि बिल अब भी अनभुगतान है, तो Payment सेक्शन कहता है Your payment has not been completed yet. If you have already paid, the order is confirmed as soon as Vindi reports the payment — please do not pay again. और उसमें Pay at Vindi, Check again और Back to checkout बटन होते हैं।

OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर एक नया ऑर्डर बनाता है, OpenCart 4 चेकआउट के ऑर्डर को अपडेट करता है, इसलिए एक्सटेंशन हर कार्ट का केवल एक बार भुगतान करता है। यदि उसी कार्ट का कोई और ऑर्डर पहले से भुगतान हो चुका है, boleto या PIX के भुगतान की प्रतीक्षा में है, या on hold है, तो ग्राहक success पेज पर जाता है और कोई नया बिल जारी नहीं होता। उसी ऑर्डर के लिए नया प्रयास उसके लंबित Vindi बिल का दोबारा उपयोग करता है, यदि तरीका, राशि और environment समान हों। अन्यथा नया बिल बनने से पहले पिछला बिल Vindi पर रद्द कर दिया जाता है, ताकि ग्राहक एक ही कार्ट का दो बार भुगतान न कर सके। कार्ट में बदलाव, जिसमें नई मात्रा भी शामिल है, एक नए कार्ट के रूप में गिना जाता है जिसके लिए अपना भुगतान चाहिए।

OpenCart 4 भुगतान का success पेज दिखाए जाने तक ऑर्डर को चेकआउट में रखता है। अस्वीकृत कार्ड भुगतान या रद्द बिल के बाद ग्राहक उसी ऑर्डर का दोबारा भुगतान करता है। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद हो गया, तो ग्राहक चेकआउट पर वापस भेजा जाता है, और अगला Confirm Order एक नए ऑर्डर का भुगतान करता है: रद्द ऑर्डर पर This order was cancelled and its Vindi bill can no longer be paid. Please contact us if you have already paid. दिखता है, और विफल ऑर्डर पर Your Vindi payment attempt was rejected. You can try again below.। OpenCart 4 पर Payment स्थिति पेज के वे संदेश जो चेकआउट पर वापस ले जाते हैं, चेकआउट पेज के ऊपर दिखाए जाते हैं।

यदि Vindi भुगतान शुरू नहीं कर पाता, तो ग्राहक Confirm Order चरण पर रहता है और बटन के ऊपर एक छोटा संदेश दिखता है, जैसे CPF / CNPJ की जाँच करने, बिलिंग पते की जाँच करने (boleto के लिए street, postcode, city और state आवश्यक हैं), ईमेल या फ़ोन नंबर की जाँच करने, या यह कि Vindi अस्थायी रूप से उपलब्ध नहीं है। तकनीकी कारण लॉग में लिखा जाता है।

यह एक्सटेंशन एक किस्त में एकल भुगतान लेता है। इसमें सब्सक्रिप्शन या आवर्ती बिलिंग नहीं है, सेव किए गए कार्ड नहीं हैं, किस्तें नहीं हैं और आपकी साइट पर कार्ड फ़ॉर्म नहीं है: कार्ड हमेशा Vindi पेज पर डाला जाता है। मकान नंबर और मोहल्ला OpenCart पते का हिस्सा नहीं हैं, इसलिए वे Vindi को नहीं भेजे जाते।

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

ऑर्डर स्थितियाँ

कोई स्थिति नहीं (लापता ऑर्डर): कार्ड भुगतान शुरू हुआ और Vindi ने उसकी पुष्टि अभी तक नहीं की। Sales > Orders में ऐसे ऑर्डर केवल तब दिखते हैं जब Order Status फ़िल्टर Missing Orders पर सेट हो। OpenCart 4.1 पर ऐसे ऑर्डर की स्थिति Voided भी हो सकती है, जिसे OpenCart तब सेट करता है जब confirm चरण फिर से दिखाया जाता है; एक्सटेंशन इसे बिना स्थिति वाला ऑर्डर मानता है।

Awaiting Vindi Payment Status (डिफ़ॉल्ट Pending): boleto, PIX या BolePix भुगतान प्रतीक्षा में है। जब Vindi बिल के भुगतान की रिपोर्ट करता है, तो ऑर्डर Order Status After Payment पर चला जाता है।

Order Status After Payment (डिफ़ॉल्ट Processing): भुगतान की पुष्टि हो गई। ऑर्डर OpenCart के सामान्य तरीके से स्थिति पाता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ। एक नोट में Vindi बिल, राशि और environment दिखते हैं।

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

Payment Error Status (डिफ़ॉल्ट Failed): Vindi ने प्रतीक्षारत ऑर्डर के भुगतान प्रयास को अस्वीकार किया। नोट में, यदि उपलब्ध हो, acquirer का कारण दिखता है। ग्राहक वही बिल अब भी भुगतान कर सकता है, और बाद का भुगतान ऑर्डर को Order Status After Payment पर ले जाता है।

Canceled Status (डिफ़ॉल्ट Canceled): प्रतीक्षारत ऑर्डर का बिल Vindi पर रद्द कर दिया गया। जब आप OpenCart में किसी ऑर्डर को इस स्थिति पर सेट करते हैं, तो उसका लंबित Vindi बिल भी रद्द हो जाता है, इसलिए उसका भुगतान अब नहीं हो सकता। यदि यह संभव न हो, तो एक नोट आपसे Vindi dashboard में बिल रद्द करने को कहता है।

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

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

VibeFox Vindi Gateway टैब

Sales > Orders में Vindi से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Vindi Gateway टैब Vindi bill, Charge, environment (sandbox भुगतानों के लिए Sandbox बैज के साथ), Payment method, Status, Paid / refunded राशियाँ, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास, कार्ट के सभी Bills of this cart और ऑर्डर के Vindi notes दिखाता है। यह टैब उन उपयोगकर्ताओं को दिखता है जिनकी एक्सटेंशन तक पहुँच है।

रिफ़ंड

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

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

Vindi boleto भुगतानों का रिफ़ंड नहीं कर सकता। टैब Vindi cannot refund boleto payments. Return the money to the customer by bank transfer and record the refund manually. दिखाता है।

Sales > Returns में उत्पाद वापसी Vindi के ज़रिए पैसे वापस नहीं भेजती। Vindi dashboard में किए गए रिफ़ंड charge_refunded webhook से आते हैं और नोट्स में जुड़ते हैं। ऑर्डर की स्थिति अपने-आप नहीं बदलती। ज़रूरत हो तो उसे मैनुअल रूप से अपडेट करें।

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

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

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

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

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

Vindi चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable / Disable चालू है, ग्राहक BRL में भुगतान करता है, Offered methods में कम से कम एक तरीका चुना गया है, और वर्तमान mode में API key है: sandbox mode में Sandbox API key, live mode में Live API key। key गायब होने या स्टोर मुद्रा BRL न होने पर सेटिंग्स पेज चेतावनी दिखाता है। यह भी जाँचें कि भुगतान का पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स में तय Total तक पहुँचता है।

भुगतान हो गया, पर ऑर्डर बिना स्थिति के या awaiting स्थिति में रहा: webhook काम नहीं कर रहा। Vindi में जाँचें कि उस खाते (live या sandbox) में, जिसका आप उपयोग करते हैं, webhook मौजूद है, उसका URL सेटिंग्स में दिखाए गए URL से हूबहू मेल खाता है (token सहित), और चारों events चुने गए हैं।

Webhook Forbidden उत्तर देता है: URL में token गायब है या गलत है। सेटिंग्स से URL फिर से कॉपी करें।

Webhook Verification failed, retry later उत्तर देता है: बिल Vindi API से नहीं पढ़ा जा सका (उदाहरण के लिए उस environment की API key हटा दी गई), उसी समय कार्ट किसी दूसरे अनुरोध से अपडेट हो रहा था, या ऑर्डर की स्थिति सेट नहीं हो सकी। Vindi सूचना फिर से भेजेगा। लॉग कारण दिखाता है।

ब्राउज़र में webhook URL Method not allowed दिखाता है: यह सामान्य है। यह URL केवल Vindi के अनुरोध स्वीकार करता है।

ग्राहक को This payment method is temporarily unavailable दिखता है: Vindi ने API key अस्वीकार की। वर्तमान mode की key जाँचें।

ग्राहक को Confirm Order के बाद त्रुटि दिखती है: एक्सटेंशन पेज पर Log फ़ील्ड देखें। Debug log बंद होने पर भी त्रुटियाँ लॉग होती हैं। boleto के लिए बिलिंग पते में street, postcode, city और state होने चाहिए।

ऑर्डर on hold स्थिति में है: VibeFox Vindi Gateway टैब के नोट्स पढ़ें (देखें ऑर्डर स्थितियाँ), फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

Live पर जाने के बाद पुराने sandbox ऑर्डर: हर भुगतान अपने बिल का environment रखता है। sandbox ऑर्डर की जाँच, रद्दीकरण और रिफ़ंड तब तक sandbox key का उपयोग करते रहते हैं जब तक वह सेटिंग्स में है।

रिफ़ंड विफल होता है: संदेश पढ़ें। Boleto भुगतान Vindi के ज़रिए रिफ़ंड नहीं किए जा सकते, और भुगतान के environment की API key सेट होनी चाहिए। एक्सटेंशन बदलने का अधिकार न होने पर टैब कहता है You do not have permission to refund orders (modify this extension).

डेवलपर्स के लिए: Vindi ग्राहक और बिल बनने से पहले एक्सटेंशन, अनुरोध डेटा और ऑर्डर के साथ, OpenCart events wc_vdi_customer_request और wc_vdi_bill_request ट्रिगर करता है।

अनइंस्टॉल

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

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

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