VibeFox Vindi for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

स्टोर की मुद्रा: ब्राज़ीलियाई रियल (BRL)। Vindi केवल BRL में चार्ज करता है, इसलिए किसी और मुद्रा के लिए भुगतान विधि छिपा दी जाती है।

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

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

इंस्टॉलेशन

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

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

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

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

5. सेटिंग्स से वेबहुक URL कॉपी करके Vindi में डालें (देखें कॉन्फ़िगरेशन)।

6. Enable / Disable चालू करें और सेव करें। सैंडबॉक्स मोड में एक भुगतान का परीक्षण करें, फिर असली भुगतान लेने के लिए Sandbox mode का निशान हटा दें।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Vindi। फ़ील्ड्स के ऊपर, जब स्टोर की मुद्रा BRL न हो या वर्तमान मोड की API कुंजी खाली हो, तो पेज चेतावनी देता है। दोनों ही स्थितियों में चेकआउट पर भुगतान विधि नहीं दिखती। भुगतान विधियों की सूची में, जब तक वर्तमान मोड के लिए API कुंजी न हो, Vindi को सेटअप की ज़रूरत वाला दिखाया जाता है। सेव करने पर कुंजियों के आगे-पीछे के खाली स्थान हटा दिए जाते हैं, और यदि कोई भुगतान विधि चुनी न गई हो, तो क्रेडिट कार्ड चुन लिया जाता है और पेज पर Choose at least one payment method — credit card was selected. दिखता है।

सामान्य

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

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

Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: Pay by credit card on the secure Vindi page, or by boleto / PIX।

API कुंजियाँ

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

Sandbox mode: Create new payments in the Vindi sandbox सैंडबॉक्स API कुंजी के साथ sandbox-app.vindi.com.br का उपयोग करता है। ग्राहकों को चेकआउट पर TEST MODE की सूचना दिखती है: Vindi sandbox: no real charges. डिफ़ॉल्ट: on। असली भुगतान लेने के लिए निशान हटा दें।

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

Sandbox API key: Vindi सैंडबॉक्स खाते की निजी कुंजी।

भुगतान विधियाँ

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

भुगतान सूचनाएँ (वेबहुक)

वेबहुक आपके स्टोर को बताता है कि कोई बिल भुगतान हो गया, रद्द हो गया या रिफ़ंड हो गया। सेटिंग्स के इस भाग में वेबहुक URL दिखता है। यह कुछ इस तरह दिखता है https://your-site/wc-api/webhook_wc_vindi/?token=... और इसमें प्लगइन द्वारा बनाया गया एक गुप्त टोकन होता है। इसे ठीक वैसा ही कॉपी करें जैसा सेटिंग्स में दिखता है। Vindi में लाइव खाते और सैंडबॉक्स खाते दोनों में Settings > Webhooks पर जाएँ, यह URL जोड़ें और ये इवेंट चुनें:

जिन अनुरोधों में टोकन गायब या गलत हो, वे अस्वीकार होते हैं। हर सूचना केवल इतना करती है कि ऑर्डर बदलने से पहले प्लगइन Vindi API के ज़रिये बिल को फिर से पढ़े। वेबहुक के बिना कार्ड, boleto और PIX भुगतान तभी पक्के होते हैं जब ग्राहक ऑर्डर प्राप्त पेज खोलता है।

उन्नत

Debug log: Log API calls and notifications विवरण WooCommerce > Status > Logs में, स्रोत wcp_vindi_gateway के साथ लिखता है। त्रुटियाँ और चेतावनियाँ इसके बंद होने पर भी हमेशा दर्ज होती हैं। कुंजियाँ और ग्राहक का डेटा कभी दर्ज नहीं होता। डिफ़ॉल्ट: off।

Delete data on uninstall: Remove the settings, webhook token and logs when the plugin is deleted। डिफ़ॉल्ट: off।

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Vindi)। जब एक से अधिक विधियाँ दी जाती हैं, तो भुगतान बॉक्स में Pay with और क्रेडिट कार्ड, boleto, PIX या BolePix में से चुनाव दिखता है। जब boleto, PIX या BolePix दी जाती है, तो बॉक्स में CPF or CNPJ फ़ील्ड भी होता है। यदि केवल ये विधियाँ दी जाएँ तो यह फ़ील्ड अनिवार्य है; अन्यथा Required for boleto and PIX. दिखता है। नंबर को उसके चेक डिजिट से जाँचा जाता है। क्लासिक चेकआउट पर, जब Brazilian Market on WooCommerce सक्रिय हो, तब यह फ़ील्ड नहीं दिखता, क्योंकि वह प्लगइन पहले ही CPF / CNPJ पूछता है। तब उसके CPF / CNPJ, मकान नंबर और मोहल्ले की जानकारी इस्तेमाल होती है। कुछ छूट जाने पर ग्राहक को 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. दिखता है।

ऑर्डर देते समय प्लगइन बिलिंग विवरण से इस ऑर्डर के लिए एक Vindi ग्राहक और ऑर्डर की कुल राशि के लिए एक किस्त वाला Vindi बिल बनाता है।

Credit card: ग्राहक को Vindi बिल पेज पर भेजा जाता है और वहीं भुगतान होता है। Vindi के बिल में कोई वापसी URL नहीं होता, इसलिए ग्राहक अपने-आप स्टोर पर वापस नहीं आता। ऑर्डर की पुष्टि वेबहुक से होती है, या जब ग्राहक ऑर्डर प्राप्त पेज खोलता है। भुगतान पूरा होने तक वह पेज और My account का ऑर्डर Your payment has not been completed yet. और Pay at Vindi बटन दिखाते हैं।

Boleto, PIX और BolePix: बिल तुरंत जारी होता है, ऑर्डर होल्ड पर सेट होता है और ग्राहक ऑर्डर प्राप्त पेज पर पहुँचता है। वहाँ और My account > Orders में Payment अनुभाग PIX QR कोड, Copy code बटन के साथ कॉपी-पेस्ट होने वाला PIX कोड और उसकी समाप्ति तिथि, तथा Open boleto बटन दिखाता है। ग्राहक का होल्ड वाला ऑर्डर ईमेल और बिल ईमेल PIX कोड और boleto लिंक रखते हैं।

ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Vindi पुष्टि करता है: प्लगइन Vindi API से बिल पढ़ता है और जाँचता है कि वह ऑर्डर का है (ऑर्डर कोड और Vindi ग्राहक) और भुगतान की गई राशि ऑर्डर के कुल के बराबर है।

ग्राहक Pay for order पेज से बिना भुगतान वाला ऑर्डर फिर से भुगतान कर सकता है। यदि विधि, राशि और वातावरण वही हों, तो लंबित Vindi बिल फिर से इस्तेमाल होता है। अन्यथा नया बिल बनने से पहले Vindi पर पुराना बिल रद्द हो जाता है, ताकि ग्राहक एक ही ऑर्डर के दो बार पैसे न दे सके। यदि पिछला बिल इस बीच भुगतान हो गया हो, तो ऑर्डर भुगतान किया हुआ चिह्नित होता है और कोई नया बिल नहीं बनता।

यदि Vindi भुगतान शुरू न कर सके, तो ग्राहक को एक छोटा संदेश दिखता है, जैसे CPF / CNPJ, बिलिंग पता, ईमेल या फ़ोन नंबर जाँचने के लिए, या यह बताने के लिए कि Vindi अस्थायी रूप से उपलब्ध नहीं है। यदि उसी समय वही ऑर्डर किसी दूसरे अनुरोध से संसाधित हो रहा हो, तो ग्राहक से थोड़ी देर रुककर फिर से कोशिश करने को कहा जाता है।

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

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

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

ऑर्डर स्टेटस

Pending payment: कार्ड भुगतान शुरू हुआ था और Vindi ने उसकी पुष्टि अभी तक नहीं की है।

On hold: boleto, PIX या BolePix भुगतान प्रतीक्षा में है (नोट Awaiting ... payment at Vindi.), या Vindi बिल की समीक्षा हो रही है।

Processing or Completed: भुगतान की पुष्टि हो गई। स्टेटस WooCommerce के मानक तरीके से सेट होता है: प्रोसेसिंग, या केवल डाउनलोड होने वाले वर्चुअल उत्पादों वाले ऑर्डर के लिए पूर्ण। ऑर्डर नोट में Vindi बिल, राशि और वातावरण दिखता है। लेन-देन ID Vindi बिल ID है।

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

Failed: Vindi ने भुगतान प्रयास अस्वीकार किया। नोट में, यदि उपलब्ध हो, acquirer का कारण दिखता है। ग्राहक अब भी वही बिल भुगतान कर सकता है, और बाद का भुगतान ऑर्डर पूरा कर देता है।

Cancelled: बिल Vindi पर रद्द हुआ है, या ऑर्डर आपने, ग्राहक ने या WooCommerce के होल्ड स्टॉक टाइमआउट ने रद्द किया है। जब स्टोर में कोई ऑर्डर रद्द होता है, तो उसका लंबित Vindi बिल भी रद्द हो जाता है, ताकि उसका भुगतान न हो सके। यदि यह संभव न हो, तो एक नोट आपसे Vindi डैशबोर्ड में बिल रद्द करने को कहता है। होल्ड स्टॉक टाइमआउट ऑर्डर रद्द करने से पहले बिल की जाँच होती है: यदि वह इस बीच भुगतान हो गया हो, तो ऑर्डर भुगतान किया हुआ चिह्नित हो जाता है।

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

रिफ़ंड

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

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

Vindi डैशबोर्ड में किए गए रिफ़ंड charge_refunded वेबहुक से आते हैं और ऑर्डर नोट्स में जुड़ जाते हैं। वे अपने-आप WooCommerce रिफ़ंड के रूप में दर्ज नहीं होते। ज़रूरत हो तो Refund via Vindi का उपयोग किए बिना WooCommerce में मैन्युअल रिफ़ंड बनाएँ।

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

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

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

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

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

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

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

भुगतान हो गया, पर ऑर्डर Pending payment या On hold पर है: वेबहुक काम नहीं कर रहा। Vindi में जाँचें कि जिस खाते (लाइव या सैंडबॉक्स) का आप उपयोग करते हैं, उसमें वेबहुक मौजूद है, उसका URL सेटिंग्स में दिखाए गए URL से ठीक मेल खाता है (टोकन सहित), और चारों इवेंट चुने गए हैं। ग्राहक के ऑर्डर प्राप्त पेज खोलने पर भी ऑर्डर की पुष्टि होती है।

वेबहुक Forbidden देता है: URL में टोकन गायब है या गलत है। सेटिंग्स से URL फिर से कॉपी करें।

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

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

ग्राहक को ऑर्डर देते समय त्रुटि दिखती है: ऑर्डर नोट्स या WooCommerce > Status > Logs में स्रोत wcp_vindi_gateway वाला लॉग खोलें। Debug log बंद होने पर भी त्रुटियाँ दर्ज होती हैं। boleto के लिए बिलिंग पते में गली, पिन कोड, शहर और राज्य होने चाहिए।

भुगतान के बाद ऑर्डर On hold है: ऑर्डर नोट पढ़ें। भुगतान की गई राशि, ऑर्डर कोड या Vindi ग्राहक ऑर्डर से मेल नहीं खाते थे, या भुगतान ऑर्डर रद्द होने के बाद आया। ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

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

रिफ़ंड विफल होता है: संदेश पढ़ें। boleto भुगतान Vindi के ज़रिये रिफ़ंड नहीं हो सकते, और भुगतान के वातावरण की API कुंजी सेट होनी चाहिए।

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

अनइंस्टॉल

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

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