VibeFox Iugu for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

स्टोर की मुद्रा: ब्राज़ीलियाई रियल (BRL)। Iugu केवल BRL में शुल्क लेता है। जब स्टोर, या Pay for order पेज पर ऑर्डर, किसी दूसरी मुद्रा का उपयोग करता है, और R$ 1,00 (Iugu की न्यूनतम राशि) से कम कुल राशि होने पर भुगतान विकल्प छिपा दिया जाता है।

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

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

इंस्टॉलेशन

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

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

3. WooCommerce > Settings > General में स्टोर की मुद्रा ब्राज़ीलियाई रियल (BRL) सेट करें।

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

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

6. टेस्ट और लाइव API टोकन डालें (देखें कॉन्फ़िगरेशन), Test mode चालू रहने दें, Enable / Disable चालू करें और सेव करें।

7. एक टेस्ट ऑर्डर दें और Iugu टेस्ट कार्ड से भुगतान करें। तैयार होने पर Test mode का टिक हटा दें।

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

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

सामान्य

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

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

Description: चेकआउट पर भुगतान विकल्प के नीचे दिखने वाला टेक्स्ट। डिफ़ॉल्ट: Pay securely via Iugu. You will be redirected to complete your payment.

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

Iugu Alia (alia.iugu.com) में API टोकन बनाएँ: Settings > API integration > New। एक "Test" प्रकार का और एक "Live" प्रकार का टोकन बनाएँ।

Test mode: Use the test API token (no real charges)। डिफ़ॉल्ट: on। टेस्ट मोड चालू होने पर चेकआउट में विवरण के ऊपर SANDBOX — Test mode enabled. No real charges. दिखता है। किसी ऑर्डर की स्थिति की जाँच और रिफ़ंड हमेशा उसी मोड के टोकन से होते हैं जिसमें उसका इनवॉइस बना था, इसलिए मोड बदलने से पुराने ऑर्डर नहीं टूटते।

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

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

भुगतान नोटिफ़िकेशन

हर इनवॉइस Iugu को निर्देश देता है कि स्थिति में बदलाव आपके स्टोर के नोटिफ़िकेशन URL पर भेजे, जो सेटिंग्स के इस भाग में दिखता है। यह कुछ ऐसा दिखता है: https://your-site/wc-api/webhook_wc_iugu/। Iugu में कुछ कॉन्फ़िगर करने की ज़रूरत नहीं है। उसी URL की ओर इशारा करने वाला खाता-स्तरीय अतिरिक्त ट्रिगर (gatilho) नुकसानदेह नहीं है। नोटिफ़िकेशन में ऐसा भुगतान डेटा नहीं होता जिस पर स्टोर भरोसा करता हो: ऑर्डर बदलने से पहले इनवॉइस हमेशा Iugu API से दोबारा पढ़ा जाता है (स्थिति, राशि, मुद्रा)।

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

paid: राशि और मुद्रा की जाँच के बाद ऑर्डर भुगतान किया हुआ चिह्नित होता है।

authorized or in_analysis: कार्ड भुगतान कैप्चर का इंतज़ार कर रहा है या जाँच में है। ऑर्डर होल्ड पर चला जाता है।

partially_paid: इनवॉइस का आंशिक भुगतान हुआ। ऑर्डर होल्ड पर चला जाता है।

expired: इनवॉइस बिना भुगतान के समाप्त हो गया। ऑर्डर विफल हो जाता है और ग्राहक दोबारा भुगतान कर सकता है।

canceled: इनवॉइस रद्द किया गया। ऑर्डर रद्द हो जाता है।

refunded: इनवॉइस Iugu में रिफ़ंड किया गया। ऑर्डर रिफ़ंड किया गया हो जाता है।

chargeback: कार्डधारक ने भुगतान पर विवाद किया। भुगतान किया हुआ ऑर्डर होल्ड पर चला जाता है।

अन्य इवेंट और इस स्टोर के ऑर्डर से संबंधित न होने वाले इनवॉइस को OK से उत्तर दिया जाता है और अनदेखा किया जाता है। नोटिफ़िकेशन न होने पर, ऑर्डर केवल तब जाँचा जाता है जब ग्राहक Iugu पेज से स्टोर पर लौटता है।

उन्नत

Debug log: WooCommerce > Status > Logs में, स्रोत wcp_iugu_gateway के अंतर्गत Log API requests and notifications, टोकन या ग्राहक डेटा के बिना। त्रुटियाँ हमेशा दर्ज होती हैं। डिफ़ॉल्ट: off।

Delete Data on Uninstall: Remove the gateway settings and logs when the plugin is deleted। डिफ़ॉल्ट: off।

चेकआउट

ग्राहक भुगतान विकल्प चुनता है (डिफ़ॉल्ट रूप से Iugu) और ऑर्डर देता है। एक मान्य बिलिंग ईमेल आवश्यक है। प्लगइन ऑर्डर की कुल राशि के लिए BRL में एक Iugu इनवॉइस बनाता है, जिसकी देय तिथि 3 दिन है, और ग्राहक को Iugu इनवॉइस पेज पर भेजता है। वहाँ ग्राहक क्रेडिट कार्ड, boleto या PIX से भुगतान करता है, उन तरीकों से जो आपके Iugu खाते में सक्षम हैं। ग्राहक का नाम और ईमेल Iugu को भेजे जाते हैं, साथ ही "Brazilian Market on WooCommerce" चेकआउट फ़ील्ड से CPF/CNPJ, मकान नंबर और मोहल्ला, यदि मौजूद हों। फ़ोन नंबर और पता केवल उसी फ़ॉर्मेट में भेजे जाते हैं जो Iugu स्वीकार करता है (ब्राज़ीलियाई फ़ोन नंबर, और 8-अंकों के CEP वाले ब्राज़ीलियाई पते)।

भुगतान के बाद ग्राहक आपके स्टोर के Order received पेज पर लौटता है। ऑर्डर केवल तब भुगतान किया हुआ चिह्नित होता है जब Iugu उसकी पुष्टि करता है: इनवॉइस को तब Iugu API से पढ़ा जाता है जब ग्राहक लौटता है और जब Iugu नोटिफ़िकेशन भेजता है। अगर ग्राहक ने boleto या PIX कोड बनाया और भुगतान से पहले लौट आया, तो Iugu भुगतान की पुष्टि करने तक ऑर्डर होल्ड पर रहता है। WooCommerce का अनपेड-ऑर्डर टाइमर उन ऑर्डर को रद्द नहीं करता जिनका Iugu इनवॉइस अभी खुला है।

अगर इनवॉइस रद्द हो गया है या समाप्त हो गया है और ऑर्डर अब भी चुकाया जा सकता है, तो ग्राहक Pay for order पेज पर पहुँचता है, जिस पर The Iugu invoice was not paid (it was canceled or has expired). You can pay the order again below. लिखा होता है। जब ग्राहक दोबारा भुगतान करता है, तो राशि नहीं बदली होने पर प्लगइन उसे उसी खुले इनवॉइस पर भेजता है। अन्यथा, वह Iugu में पुराना इनवॉइस रद्द करता है और नया बनाता है, ताकि दो खुले इनवॉइस के ज़रिए एक ही ऑर्डर दो बार न चुकाया जा सके। अगर पुराना इनवॉइस फिर भी चुका दिया जाता है, तो भुगतान अब भी ऑर्डर से मिलाया जाता है।

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

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

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

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

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

Pending payment: इनवॉइस बन गया है और ग्राहक ने अभी भुगतान नहीं किया है।

Processing or Completed: Iugu ने भुगतान की पुष्टि की। WooCommerce भुगतान किए गए ऑर्डर के लिए सामान्य स्थिति सेट करता है। ऑर्डर नोट में Iugu इनवॉइस ID और भुगतान तरीका (क्रेडिट कार्ड, boleto या PIX) दिखता है। ट्रांज़ैक्शन ID Iugu इनवॉइस ID है, और ऑर्डर स्क्रीन पर वह Iugu के इनवॉइस से लिंक होता है।

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

Failed: इनवॉइस बिना भुगतान के समाप्त हो गया। ग्राहक ऑर्डर दोबारा चुका सकता है।

Cancelled: इनवॉइस Iugu में रद्द किया गया।

Refunded: जिस इनवॉइस ने ऑर्डर चुकाया था, उसे Iugu में रिफ़ंड किया गया।

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

रिफ़ंड

ऑर्डर खोलें, Refund पर क्लिक करें, राशि डालें और Refund via Iugu पर क्लिक करें। रिफ़ंड उस मोड के टोकन से भेजा जाता है जिसमें इनवॉइस बना था।

Credit card: पूरा या आंशिक रिफ़ंड।

PIX: केवल पूरा रिफ़ंड।

Boleto: Iugu के ज़रिए रिफ़ंड नहीं हो सकता। बैंक ट्रांसफ़र से ग्राहक को पैसे लौटाएँ, फिर Refund via Iugu का उपयोग किए बिना रिफ़ंड मैन्युअल रूप से दर्ज करें।

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

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

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

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

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

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

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

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

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

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

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

Notification answers invalid invoice id: नोटिफ़िकेशन में वैध इनवॉइस ID नहीं था। कुछ भी नहीं बदलता।

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

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

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

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

डेवलपर इनवॉइस अनुरोध बदल सकते हैं, जैसे payable_with से भुगतान तरीके सीमित करना, wc_igu_invoice_data फ़िल्टर के ज़रिए।

अनइंस्टॉल

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

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