VibeFox GoPay for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

मुद्रा: GoPay CZK, EUR, PLN, USD, GBP, HUF, RON और BGN स्वीकार करता है। दूसरी मुद्रा होने पर चेकआउट में भुगतान का तरीका छिपा रहता है।

GoPay खाता: आपको अपने GoPay मर्चेंट खाते का GoID, Client ID और Client Secret चाहिए। ये खाते की इंटीग्रेशन सेटिंग में मिलते हैं। सैंडबॉक्स (टेस्ट) खाते के अपने क्रेडेंशियल होते हैं। सूचनाओं के लिए GoPay खाते में कुछ सेट करने की ज़रूरत नहीं है, लेकिन आपका स्टोर इंटरनेट से पहुँच योग्य होना चाहिए।

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

इंस्टॉलेशन

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

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

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

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

5. सैंडबॉक्स GoID, Client ID और Client Secret दर्ज करें, Test Mode चालू रखें और Enable/Disable चालू करें।

6. एक टेस्ट ऑर्डर दें। सब कुछ ठीक चलने पर प्रोडक्शन क्रेडेंशियल दर्ज करें और Test Mode का चेक हटाएँ।

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

सभी सेटिंग एक ही पेज पर हैं: WooCommerce > Settings > Payments > GoPay। गेटवे के विवरण के नीचे पेज Sandbox mode — test payments only या Production mode — real payments दिखाता है। मौजूदा मोड का GoID, Client ID या Client Secret न होने पर, या GoPay द्वारा स्टोर की मुद्रा स्वीकार न किए जाने पर चेतावनी दिखाई जाती है। दोनों ही स्थितियों में चेकआउट पर GoPay उपलब्ध नहीं होता। भुगतान तरीकों की सूची में गेटवे को सेटअप की ज़रूरत वाला दिखाया जाता है, जब तक मौजूदा मोड के क्रेडेंशियल दर्ज न हों। सेव करते समय GoPay के कैश किए गए एक्सेस टोकन हटाए जाते हैं, ताकि नए क्रेडेंशियल तुरंत इस्तेमाल हों।

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

Title: चेकआउट पर दिखने वाला भुगतान तरीके का शीर्षक। डिफ़ॉल्ट: GoPay।

Description: चेकआउट पर दिखने वाला भुगतान तरीके का विवरण। डिफ़ॉल्ट: Pay securely via GoPay - cards, wallets, bank transfers।

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

GoID, Client ID और Client Secret आपके GoPay मर्चेंट खाते की इंटीग्रेशन सेटिंग में दिखते हैं। सैंडबॉक्स (टेस्ट) खाते के अपने क्रेडेंशियल होते हैं। API दस्तावेज़ doc.gopay.com पर हैं।

Test Mode: Enable sandbox/test mode सैंडबॉक्स क्रेडेंशियल के साथ भुगतान gw.sandbox.gopay.com पर भेजता है। वास्तविक पैसे नहीं लिए जाते। वास्तविक भुगतान स्वीकार करने के लिए इसे अनचेक करें और प्रोडक्शन क्रेडेंशियल (gate.gopay.cz) इस्तेमाल करें। डिफ़ॉल्ट: चालू।

Sandbox GoID: आपके GoPay सैंडबॉक्स (टेस्ट) खाते का GoID।

Sandbox Client ID: सैंडबॉक्स खाते का OAuth Client ID।

Sandbox Client Secret: सैंडबॉक्स खाते का OAuth Client Secret।

Production GoID: आपका GoPay मर्चेंट ID (GoID)।

Production Client ID: GoPay का OAuth Client ID।

Production Client Secret: GoPay का OAuth Client Secret।

GoID में केवल अंक होते हैं, उदाहरण के लिए 8123456789। कुछ और दर्ज करने पर पेज त्रुटि दिखाता है और पिछली वैल्यू बरकरार रखता है।

भुगतान

Payment Page Language: GoPay भुगतान पेज की भाषा। डिफ़ॉल्ट: Automatic (site language, then billing country)। स्वचालित विकल्प आपकी साइट की भाषा का उपयोग करता है; यदि GoPay उसे उपलब्ध नहीं कराता, तो बिलिंग देश के आधार पर भाषा चुनी जाती है, अन्यथा अंग्रेज़ी इस्तेमाल होती है। आप 19 भाषाओं में से एक को तय भी कर सकते हैं: चेक, अंग्रेज़ी, स्लोवाक, जर्मन, पोलिश, हंगेरियन, रोमानियन, बुल्गारियन, क्रोएशियाई, स्लोवेनियाई, एस्टोनियाई, लातवियाई, लिथुआनियाई, फ़्रेंच, इतालवी, स्पेनिश, पुर्तगाली, यूक्रेनी या रूसी।

Order Status After Payment: भुगतान की पुष्टि होने पर ऑर्डर को दिया जाने वाला स्टेटस। यह तुरंत सेट होता है, जिसमें स्टेटस एक बार बदलता है और ग्राहक को एक ईमेल भेजा जाता है।

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

सूचना आपके स्टोर को बताती है कि भुगतान किया गया है। हर भुगतान के साथ सूचना URL GoPay को भेजा जाता है, इसलिए GoPay खाते में कुछ सेट करने की ज़रूरत नहीं है। URL सेटिंग में दिखता है। इसका रूप https://your-site/?gopay-api=gopay_payment_notification जैसा होता है। इसे इंटरनेट से पहुँचा जा सकना चाहिए: इस पर पासवर्ड सुरक्षा, रखरखाव मोड या पहुँच रोकने वाला फ़ायरवॉल नहीं होना चाहिए।

GoPay सूचनाओं में केवल भुगतान ID होता है, हस्ताक्षर नहीं। प्रत्येक सूचना को GoPay API से भुगतान की स्थिति पूछकर सत्यापित किया जाता है, और भुगतान आपके स्टोर के किसी ऑर्डर के लिए प्लगइन द्वारा बनाया गया होना चाहिए। GoPay से स्थिति नहीं पढ़ी जा सके तो आपका स्टोर त्रुटि का जवाब देता है और GoPay सूचना दोबारा भेजता है। सूचनाओं के बिना, ग्राहक के भुगतान के बाद स्टोर लौटने पर ही ऑर्डर की पुष्टि होती है।

उन्नत

Logging: Enable logging GoPay इवेंट को WooCommerce > Status > Logs में wcp_gopay_gateway स्रोत के साथ लिखता है। त्रुटियाँ हमेशा लॉग होती हैं। क्रेडेंशियल, टोकन, कार्ड डेटा, ग्राहक का ईमेल, फ़ोन और पता कभी लॉग नहीं होते। डिफ़ॉल्ट: बंद।

Delete Data on Uninstall: Delete plugin settings, cached access tokens and log files when uninstalled। चालू होने पर प्लगइन हटाने से गेटवे सेटिंग, कैश किए गए GoPay एक्सेस टोकन और लॉग हट जाते हैं। डिफ़ॉल्ट: बंद।

चेकआउट

ग्राहक भुगतान का तरीका (डिफ़ॉल्ट रूप से GoPay) चुनकर ऑर्डर देता है। प्लगइन ऑर्डर की मुद्रा में ऑर्डर की कुल राशि के लिए GoPay भुगतान बनाता है, जिसमें ऑर्डर के आइटम, शिपिंग और शुल्क शामिल होते हैं, फिर ग्राहक को GoPay भुगतान पेज पर भेजता है। वहाँ GoPay आपके खाते में सक्रिय भुगतान कार्ड, Apple Pay, Google Pay और बैंक ट्रांसफ़र जैसे तरीके दिखाता है। ग्राहक का बिलिंग नाम, ईमेल, फ़ोन और पता GoPay को भेजे जाते हैं; खाली फ़ील्ड नहीं भेजे जाते। GoPay में भुगतान Order और ऑर्डर नंबर के रूप में दिखता है।

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब GoPay इसकी पुष्टि करे: सूचना से या ग्राहक के लौटने पर GoPay API को भेजे गए अनुरोध से। सूचना और ग्राहक की वापसी एक ही समय पर आने पर उन्हें एक के बाद एक संभाला जाता है, इसलिए ऑर्डर दो बार पूरा नहीं होता। भुगतान की पुष्टि होने पर ग्राहक ऑर्डर प्राप्ति पेज पर पहुँचता है।

यदि भुगतान पूरा नहीं हुआ, रद्द हो गया या समाप्त हो गया, तो ग्राहक को Pay for order पेज पर भेजा जाता है और संदेश दिखता है: The GoPay payment was not completed. You can try again or choose another payment method. या The GoPay payment was cancelled or has expired. You can try again or choose another payment method. ग्राहक इस पेज से बिना भुगतान वाले ऑर्डर का फिर से भुगतान कर सकता है। पहले से भुगतान किए गए ऑर्डर के लिए दूसरा GoPay भुगतान नहीं बनाया जाता।

यदि GoPay भुगतान शुरू नहीं कर पाता, तो ग्राहक को छोटा संदेश दिखता है, जैसे GoPay could not accept the payment details. Please check your billing details (e-mail, phone, address) or choose another payment method. या GoPay is temporarily unavailable. Please try again in a moment or choose another payment method. तकनीकी कारण ऑर्डर नोट में जोड़ा जाता है।

यह भुगतान तरीका क्लासिक चेकआउट, Cart और Checkout ब्लॉक तथा Pay for order पेज पर काम करता है। सैंडबॉक्स मोड में Checkout ब्लॉक Sandbox mode: no real payment will be made. दिखाता है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।

ग्राहक भुगतान का तरीका GoPay पेज पर चुनता है; WooCommerce में इसे नहीं चुना जा सकता। प्लगइन में सब्सक्रिप्शन या बार-बार होने वाले भुगतान, सेव किए गए कार्ड, एम्बेडेड भुगतान फ़ॉर्म, या WooCommerce से प्री-ऑथराइज़ेशन को कैप्चर या रद्द करने की सुविधा नहीं है।

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

ऑर्डर स्टेटस

Pending payment: ग्राहक को GoPay भेजा गया है और उसने अभी भुगतान नहीं किया है, या GoPay ने अभी तक भुगतान की पुष्टि नहीं की है।

Processing or Completed: भुगतान की पुष्टि हो गई है। स्टेटस Order Status After Payment के अनुसार होता है। ऑर्डर नोट में GoPay भुगतान ID और भुगतान माध्यम दिखता है। लेन-देन ID GoPay भुगतान ID ही है।

On hold: GoPay ने भुगतान की पुष्टि की है, लेकिन राशि या मुद्रा ऑर्डर से अलग है; या भुगतान ऑर्डर रद्द होने के बाद आया; या भुगतान केवल प्री-ऑथराइज़ किया गया है और राशि अभी कैप्चर नहीं हुई है। ऑर्डर नोट में कारण बताया जाता है। प्री-ऑथराइज़ भुगतान को GoPay में कैप्चर करना होगा, फिर आप ऑर्डर को मैन्युअल रूप से पूरा करें।

Failed: बिना भुगतान वाले ऑर्डर का आखिरी GoPay भुगतान रद्द हो गया या समाप्त हो गया।

Refunded: ऑर्डर का GoPay भुगतान पूरी तरह रिफ़ंड कर दिया गया, उदाहरण के लिए GoPay खाते से।

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

रिफ़ंड

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

GoPay खाते से किए गए रिफ़ंड सूचना के ज़रिए आते हैं। पूरा रिफ़ंड ऑर्डर को “रिफ़ंड किया गया” स्थिति में बदल देता है; आंशिक रिफ़ंड एक नोट जोड़ता है। ये WooCommerce रिफ़ंड के रूप में अपने-आप दर्ज नहीं होते।

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

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

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

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

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

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

चेकआउट पर GoPay दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, मौजूदा मोड में GoID, Client ID और Client Secret दर्ज हैं, और मुद्रा CZK, EUR, PLN, USD, GBP, HUF, RON या BGN में से एक है। Pay for order पेज पर ऑर्डर की मुद्रा लागू होती है। क्रेडेंशियल या मुद्रा गलत होने पर सेटिंग पेज चेतावनी दिखाता है।

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

सूचना में Order not found जवाब आता है: भुगतान इस स्टोर ने नहीं बनाया था या उसका ऑर्डर हटा दिया गया था।

सूचना में Payment state could not be verified जवाब आता है: GoPay API तक पहुँचा नहीं जा सका या उस मोड के क्रेडेंशियल गलत हैं। GoPay सूचना फिर भेजता है।

ऑर्डर देते समय ग्राहक को त्रुटि दिखती है: ऑर्डर नोट खोलें या Logging चालू करें। नोट में GoPay त्रुटि दिखती है। आम तौर पर गलत क्रेडेंशियल या दूसरे मोड के क्रेडेंशियल कारण होते हैं। बिलिंग विवरण के बारे में संदेश का अर्थ है कि GoPay ने ईमेल, फ़ोन या पता स्वीकार नहीं किया।

टेस्ट भुगतान वास्तविक ऑर्डर की पुष्टि नहीं करते: सैंडबॉक्स और प्रोडक्शन अलग-अलग हैं। हर भुगतान उसी मोड में जाँचा जाता है जिसमें वह बनाया गया था। Test Mode को इच्छित मोड पर बदलें और उसी मोड के क्रेडेंशियल इस्तेमाल करें।

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

रिफ़ंड विफल है: GoPay का संदेश पढ़ें। आंशिक रिफ़ंड भुगतान के 24 घंटे बाद ही संभव है। मोड के बारे में संदेश का अर्थ है कि भुगतान सैंडबॉक्स या प्रोडक्शन में हुआ था और उस मोड के क्रेडेंशियल सेट नहीं हैं।

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

डेवलपर के लिए: gopay_p_payment_payload फ़िल्टर भुगतान अनुरोध बदलता है और gopay_p_icon भुगतान तरीके का आइकन बदलता है।

अनइंस्टॉल करना

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

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