VibeFox Niubiz for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

स्टोर की मुद्रा: पेरूवियन सोल (PEN) या US डॉलर (USD)। अन्य मुद्राओं के लिए चेकआउट पर भुगतान विधि छिपी रहती है।

Niubiz खाता: Niubiz हर वातावरण के लिए एक merchant ID (código de comercio), एक API user और एक API password जारी करता है। Sandbox क्रेडेंशियल Niubiz की इंटीग्रेशन टीम से मिलते हैं, और प्रोडक्शन क्रेडेंशियल तब मिलते हैं जब Niubiz आपके इंटीग्रेशन को प्रमाणित कर दे। कोई वेबहुक सेट करने की ज़रूरत नहीं है: Niubiz अधिकृति का उत्तर तुरंत देता है।

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

इंस्टॉलेशन

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

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

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

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

5. Sandbox mode चालू रखें और sandbox का merchant ID, API user और API password डालें (कॉन्फ़िगरेशन देखें)।

6. Enable/Disable चालू करें और Niubiz के टेस्ट कार्ड से कुछ टेस्ट भुगतान करें।

7. Niubiz द्वारा आपके इंटीग्रेशन को प्रमाणित करने के बाद, प्रोडक्शन क्रेडेंशियल डालें और Sandbox mode का निशान हटा दें।

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

सारी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Niubiz। फ़ील्ड्स के ऊपर, जब स्टोर की मुद्रा PEN या USD न हो या वर्तमान मोड के क्रेडेंशियल अधूरे हों, तो पेज चेतावनी देता है (दोनों स्थितियों में चेकआउट पर भुगतान विधि छिप जाती है), और जब तक sandbox मोड चालू है, Sandbox मोड चालू है: भुगतान Niubiz sandbox पर जाते हैं और कोई असली शुल्क नहीं लिया जाता। दिखाता है। भुगतान विधियों की सूची में Niubiz तब तक सेटअप की आवश्यकता वाला दिखता है जब तक वर्तमान मोड के पूरे क्रेडेंशियल न हों।

सामान्य

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

Title: चेकआउट पर ग्राहक को दिखने वाला भुगतान विधि का नाम। डिफ़ॉल्ट: Credit or debit card (Niubiz)।

Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely with Visa, Mastercard, American Express or Diners Club in the Niubiz payment form.

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

Niubiz आपको sandbox के लिए, और प्रमाणन के बाद प्रोडक्शन के लिए, एक merchant ID, एक API user और एक API password देता है। डेवलपर दस्तावेज़ desarrolladores.niubiz.com.pe पर है।

Sandbox mode: Use the Niubiz sandbox (QA) environment — no real charges। यह API एंडपॉइंट और नीचे दिए क्रेडेंशियल सेट, दोनों बदल देता है। डिफ़ॉल्ट: चालू। असली भुगतान के लिए इसका निशान हटाएँ।

Sandbox merchant ID: आपके sandbox खाते का merchant कोड, केवल अंक। खाली स्थान हटा दिए जाते हैं। यदि मान में दूसरे वर्ण हों, तो सेटिंग्स पेज त्रुटि दिखाता है और पिछला मान रखता है।

Sandbox API user: sandbox का API user।

Sandbox API password: sandbox का API password।

Production merchant ID: आपके प्रोडक्शन (संबद्ध) खाते का merchant कोड, केवल अंक।

Production API user: प्रोडक्शन का API user।

Production API password: प्रोडक्शन का API password।

भुगतान फ़ॉर्म

Logo URL: वैकल्पिक। आपके लोगो का HTTPS पता, जो Niubiz भुगतान फ़ॉर्म में दिखता है, लगभग 187 × 40 px। इसके बिना स्टोर का नाम दिखता है। https:// से शुरू न होने वाला पता अस्वीकार होता है और पिछला मान रहता है।

उन्नत

Debug log: Log API calls Niubiz अनुरोध WooCommerce > Status > Logs में, स्रोत wcp_niubiz_payment के रूप में लिखता है। त्रुटियाँ हमेशा लॉग होती हैं। क्रेडेंशियल, टोकन और कार्ड या ग्राहक का डेटा कभी लॉग नहीं होता। डिफ़ॉल्ट: बंद।

Delete data on uninstall: Remove the settings and logs of this plugin when it is deleted। निष्क्रिय करने से कुछ भी नहीं मिटता। ऑर्डर पर सहेजा गया भुगतान डेटा रहता है। डिफ़ॉल्ट: बंद।

संस्करण 1.0 की सेटिंग्स, जिसमें केवल एक क्रेडेंशियल सेट था, अपने-आप स्थानांतरित हो जाती हैं: यदि टेस्ट मोड चालू था तो sandbox फ़ील्ड में, अन्यथा प्रोडक्शन फ़ील्ड में।

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit or debit card (Niubiz)) और ऑर्डर देता है। प्लगइन ऑर्डर राशि के लिए Niubiz से एक एक्सेस टोकन और भुगतान सत्र माँगता है, और ग्राहक को आपके स्टोर के ऑर्डर भुगतान पेज पर भेज देता है। Sandbox मोड में चेकआउट और भुगतान पेज पर SANDBOX मोड: Niubiz टेस्ट कार्ड का उपयोग करें। कोई असली शुल्क नहीं लिया जाता। दिखता है।

भुगतान पेज पर Niubiz भुगतान फ़ॉर्म अपने-आप खुलता है। पेज पर ऑर्डर राशि वाला Pay बटन है जिससे फ़ॉर्म दोबारा खोला जा सकता है, एक Cancel order बटन और एक Choose another payment method लिंक भी है। JavaScript ज़रूरी है। यदि Niubiz फ़ॉर्म लोड न हो सके, तो पेज पर Niubiz भुगतान फ़ॉर्म लोड नहीं हो सका। कृपया पेज रीलोड करें या बाद में फिर प्रयास करें। दिखता है।

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

कार्ड अस्वीकृत: ग्राहक Your payment was declined: और Niubiz के कारण के साथ भुगतान पेज पर लौटता है, और उसी या किसी दूसरे कार्ड से फिर से प्रयास कर सकता है। संदेश के ऊपर फ़ॉर्म फिर से नहीं खुलता; ग्राहक Pay पर क्लिक करता है।

Niubiz से कोई उत्तर नहीं: यदि Niubiz कोई निश्चित परिणाम नहीं देता (टाइमआउट, सर्वर त्रुटि, न पढ़ा जा सकने वाला उत्तर), तो ग्राहक को हम Niubiz के साथ आपके भुगतान की पुष्टि नहीं कर सके। कृपया दोबारा भुगतान न करें — स्टोर भुगतान की जाँच करेगा और आपसे संपर्क करेगा। के साथ ऑर्डर प्राप्ति पेज दिखता है।

सत्र समाप्त: भुगतान सत्र अधिकतम 20 मिनट तक चलता है। जब वह इस्तेमाल हो चुका हो या समाप्त होने वाला हो, या जब ऑर्डर राशि या मोड बदले, तो भुगतान पेज नया सत्र बनाता है।

हर भुगतान प्रयास को नई खरीद संख्या मिलती है: ऑर्डर ID के बाद तीन अंकों की प्रयास संख्या (अधिकतम 12 वर्ण), क्योंकि Niubiz हर अधिकृति के लिए अद्वितीय खरीद संख्या माँगता है। ग्राहक Pay for order पेज से बिना भुगतान वाले या विफल ऑर्डर का फिर से भुगतान कर सकता है।

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

प्लगइन केवल एक-बार के कार्ड भुगतान लेता है। WooCommerce से कोई रिफ़ंड या रद्दीकरण नहीं होता, सेव किए गए कार्ड, सब्सक्रिप्शन या आवर्ती भुगतान नहीं हैं, किस्तों (cuotas) का चयन नहीं है, और PagoEfectivo, Yape या अन्य वॉलेट और QR भुगतान नहीं हैं। उत्तर खो जाने के कारण ऑन होल्ड किए गए ऑर्डर अपने-आप दोबारा नहीं जाँचे जाते।

ऑर्डर

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

भुगतान लंबित: ग्राहक को भुगतान पेज पर भेजा गया है और उसने अभी भुगतान नहीं किया है।

प्रोसेसिंग: Niubiz ने भुगतान स्वीकृत किया और उत्तर ऑर्डर से मेल खाया। केवल डाउनलोड योग्य वर्चुअल उत्पादों वाले ऑर्डर WooCommerce की सामान्य व्यवस्था के अनुसार पूर्ण हो जाते हैं। ऑर्डर नोट में वातावरण, लेन-देन ID, प्राधिकरण कोड, खरीद संख्या और मास्क किए गए कार्ड नंबर के साथ कार्ड ब्रांड दिखता है। ऑर्डर का लेन-देन ID Niubiz का लेन-देन ID है।

विफल: कार्ड अस्वीकृत हुआ। ऑर्डर नोट में Niubiz का कारण, क्रिया कोड और खरीद संख्या दिखती है। ग्राहक फिर से भुगतान कर सकता है।

ऑन होल्ड, स्वीकृत लेकिन मेल नहीं खाता: Niubiz ने ऐसा भुगतान स्वीकृत किया जिसकी खरीद संख्या, राशि या मुद्रा ऑर्डर से अलग है, या जिसके उत्तर में राशि या मुद्रा नहीं है। ऑर्डर भुगतान किया हुआ चिह्नित नहीं होता; नोट अंतर सूचीबद्ध करता है। Niubiz कंसोल में लेन-देन जाँचें। ग्राहक को आपका भुगतान प्राप्त हो गया है और स्टोर द्वारा इसकी समीक्षा की जा रही है। दिखता है।

ऑन होल्ड, कोई निश्चित उत्तर नहीं: Niubiz ने साफ़ उत्तर नहीं दिया, इसलिए कार्ड पर शुल्क लिया गया हो सकता है। नोट में खरीद संख्या दी गई है। इसे Niubiz कंसोल में खोजें: यदि लेन-देन स्वीकृत और सही है, तो ऑर्डर को प्रोसेसिंग पर सेट करें; नहीं तो उसे रद्द करें।

रद्द: ग्राहक ने भुगतान पेज पर Cancel order पर क्लिक किया, या ऑर्डर आपके द्वारा या WooCommerce स्टॉक होल्ड टाइमआउट से रद्द हुआ।

जब Niubiz अनुरोध को स्वयं अस्वीकार करता है (उदाहरण के लिए दोहराई गई खरीद संख्या, HTTP 406 या अमान्य क्रेडेंशियल), तो ऑर्डर की स्थिति नहीं बदलती। नोट बताता है कि कार्ड पर शुल्क नहीं लिया गया, और ग्राहक नई खरीद संख्या के साथ फिर से प्रयास कर सकता है।

रिफ़ंड

रिफ़ंड और रद्दीकरण WooCommerce से उपलब्ध नहीं हैं। Niubiz कंसोल में लेन-देन का रिफ़ंड या void करें और ऑर्डर को मैन्युअल रूप से अपडेट करें, उदाहरण के लिए WooCommerce में मैन्युअल रिफ़ंड के साथ।

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

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

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

सक्रिय कुंजी के बिना, Niubiz चेकआउट पर ग्राहकों को नहीं दिखाया जाता। फिर भी यदि भुगतान शुरू हो जाए, तो ग्राहक को यह भुगतान विधि उपलब्ध नहीं है। कृपया कोई दूसरी चुनें। दिखता है। लॉग इन किए हुए स्टोर मैनेजर को भुगतान विधि अब भी (unlicensed — visible to admins only) चिह्न के साथ दिखती है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट अप और टेस्ट कर सकें। Plugins पेज और WooCommerce पेजों पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते; Niubiz फ़ॉर्म में पहले से शुरू हुए भुगतान अब भी अधिकृत होते हैं।

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

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

चेकआउट पर Niubiz दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, वर्तमान मोड का merchant ID, API user और API password भरा है (sandbox मोड में sandbox फ़ील्ड, अन्यथा प्रोडक्शन फ़ील्ड), और मुद्रा PEN या USD है। Pay for order पेज पर ऑर्डर की मुद्रा मायने रखती है। क्रेडेंशियल या मुद्रा गलत होने पर सेटिंग्स पेज चेतावनी दिखाता है।

भुगतान हो गया, लेकिन ऑर्डर भुगतान लंबित पर अटका है: इस भुगतान फ़ॉर्म के लिए Niubiz का कोई वेबहुक नहीं है, इसलिए ऑर्डर केवल अधिकृति के उत्तर से अपडेट होता है। यदि ऑर्डर नोट के साथ ऑन होल्ड है, तो Niubiz कंसोल में खरीद संख्या खोजें। यदि ऑर्डर अब भी भुगतान लंबित है, तो ग्राहक ने फ़ॉर्म पूरा नहीं किया; WooCommerce > Status > Logs, स्रोत wcp_niubiz_payment देखें।

ग्राहक को दिखता है: Niubiz से कनेक्ट नहीं हो सका: एक्सेस टोकन नहीं मिल सका। वर्तमान मोड का API user और API password जाँचें, और यह भी कि आपका सर्वर Niubiz API तक पहुँच सकता है या नहीं। विवरण के लिए Debug log चालू करें।

ग्राहक को दिखता है: Niubiz भुगतान शुरू नहीं हो सका: Niubiz ने भुगतान सत्र नहीं बनाया। वर्तमान मोड का merchant ID और लॉग जाँचें।

ग्राहक को दिखता है: यह भुगतान प्रयास पहले ही संसाधित हो चुका है: वही फ़ॉर्म दो बार सबमिट हुआ। ग्राहक भुगतान पेज पर भुगतान फिर से शुरू करता है; कार्ड पर दो बार शुल्क नहीं लगता।

ग्राहक को दिखता है: आपका भुगतान सत्र समाप्त हो गया है और आपके कार्ड पर शुल्क नहीं लिया गया: भुगतान पेज बहुत देर तक खुला रहा। ग्राहक उसी पेज पर फिर से प्रयास करता है।

ऑर्डर नोट: Niubiz ने दोहरी अधिकृति की सूचना दी: Niubiz इस खरीद संख्या को पहले ही जानता है। Niubiz कंसोल में जाँचें; ग्राहक नई खरीद संख्या से फिर प्रयास कर सकता है।

ऑर्डर Niubiz नोट के साथ ऑन होल्ड है: नोट पढ़ें। Niubiz ने निश्चित उत्तर नहीं दिया, या ऐसा भुगतान स्वीकृत किया जो ऑर्डर से मेल नहीं खाता। Niubiz कंसोल में खरीद संख्या खोजें और ऑर्डर को प्रोसेसिंग पर सेट करें या रद्द करें।

सेटिंग्स सहेजते समय त्रुटि: merchant ID में केवल अंक होने चाहिए, और लोगो URL एक मान्य https:// पता होना चाहिए। पिछला मान रहता है।

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

डेवलपर्स के लिए: यदि Niubiz व्यापारी-विशिष्ट एंटी-फ्रॉड फ़ील्ड (MDD) भेजने को कहे, तो उन्हें niubiz_p_merchant_define_data फ़िल्टर से जोड़ें। कुंजियाँ MDD और एक संख्या होती हैं, और मान अधिकतम 100 अक्षरों के हो सकते हैं। अन्य फ़िल्टर: niubiz_p_cardholder_data (भुगतान सत्र के साथ भेजा जाने वाला कार्डधारक डेटा), niubiz_p_purchase_number (एक प्रयास की खरीद संख्या, 1 से 12 अक्षर या अंक, हर प्रयास के लिए अद्वितीय) और niubiz_p_icon (भुगतान विधि का आइकन)।

अनइंस्टॉल

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

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