VibeFox SimplePay for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

स्टोर मुद्रा: HUF, EUR या USD। SimplePay अन्य मुद्राएँ स्वीकार नहीं करता, और उनके लिए भुगतान विधि नहीं दिखाई जाती।

SimplePay मर्चेंट खाते: SimplePay हर मुद्रा के लिए अलग मर्चेंट खाता देता है, और लाइव तथा सैंडबॉक्स के लिए अलग खाते। हर खाते के लिए आपको SimplePay मर्चेंट एडमिन (लाइव के लिए admin.simplepay.hu, सैंडबॉक्स के लिए sandbox.simplepay.hu) से उसका MERCHANT और SECRET KEY चाहिए, जो account > Technical data में मिलता है। यदि आप केवल HUF में बेचते हैं, तो HUF खाता काफ़ी है। अन्य कुंजियों की ज़रूरत नहीं है।

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

इंस्टॉलेशन

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

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

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

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

5. जिस हर मुद्रा में आप बेचते हैं, उसके लिए अपने SimplePay खातों का MERCHANT और SECRET KEY दर्ज करें: परीक्षण के लिए सैंडबॉक्स खाते और असली भुगतान के लिए लाइव खाते (देखें कॉन्फ़िगरेशन)।

6. सेटिंग्स पेज पर दिखाया गया IPN URL SimplePay मर्चेंट एडमिन में हर मर्चेंट खाते (लाइव और सैंडबॉक्स) में कॉपी करें।

7. Enable/Disable चालू करें, Sandbox mode चालू रखकर एक परीक्षण भुगतान करें, फिर असली भुगतान लेने के लिए Sandbox mode का चिह्न हटा दें।

संस्करण 1.0 से अपडेट करने पर, 1.0 का एकल Merchant ID और Secret key उस मोड (सैंडबॉक्स या लाइव) में, जो तब सक्रिय था, स्टोर मुद्रा के खाते में चले जाते हैं। अपडेट के बाद खाते जाँच लें।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > SimplePay (OTP)। फ़ील्ड्स के ऊपर पेज चेतावनी देता है, जब स्टोर मुद्रा SimplePay द्वारा समर्थित नहीं होती, या जब स्टोर मुद्रा का वर्तमान मोड में कोई मर्चेंट खाता नहीं होता। दोनों ही स्थितियों में उस मुद्रा के ऑर्डर के लिए भुगतान विधि नहीं दिखाई जाती। जब sandbox मोड चालू होता है, पेज यह संदेश दिखाता है: Sandbox mode is on: payments go to the SimplePay sandbox, no real money is charged. भुगतान विधियों की सूची में SimplePay को तब तक "सेटअप आवश्यक" के रूप में चिह्नित किया जाता है, जब तक वर्तमान मोड में कम से कम एक मर्चेंट खाता न हो।

सामान्य

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

Title: चेकआउट पर ग्राहकों को दिखने वाला भुगतान विधि का नाम। डिफ़ॉल्ट: SimplePay (Card Payment)।

Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely with your credit or debit card via SimplePay। हंगेरियाई मर्चेंट्स को चेकआउट पर SimplePay का डेटा ट्रांसफ़र घोषणा (Adattovábbítási nyilatkozat) दिखाना होता है। आप इसे इसके लिंक के साथ यहाँ डाल सकते हैं।

Sandbox mode: Use the SimplePay sandbox भुगतान SimplePay सैंडबॉक्स पर भेजता है और सैंडबॉक्स खाते इस्तेमाल करता है। यह API पता और मर्चेंट खाते दोनों बदल देता है। कोई असली राशि नहीं ली जाती। डिफ़ॉल्ट: चालू। असली भुगतान लाइव खातों से लेने के लिए चिह्न हटा दें।

लाइव मर्चेंट खाते

ये खाते तब इस्तेमाल होते हैं जब Sandbox mode बंद हो। जिन मुद्राओं में आपका स्टोर बेचता है, उनके खाते भरें। MERCHANT और SECRET KEY के मान SimplePay मर्चेंट एडमिन (admin.simplepay.hu) में account > Technical data में हैं। कोई खाता तभी इस्तेमाल होता है जब दोनों फ़ील्ड भरे हों।

HUF account — Merchant ID: आपके लाइव HUF खाते का MERCHANT।

HUF account — Secret key: आपके लाइव HUF खाते का SECRET KEY।

EUR account — Merchant ID और EUR account — Secret key: आपके लाइव EUR खाते के लिए भी यही।

USD account — Merchant ID और USD account — Secret key: आपके लाइव USD खाते के लिए भी यही।

सैंडबॉक्स मर्चेंट खाते

ये खाते तब इस्तेमाल होते हैं जब Sandbox mode चालू हो। फ़ील्ड लाइव खातों जैसे ही हैं: HUF account — Merchant ID, HUF account — Secret key और EUR व USD के लिए वही जोड़े। मान SimplePay सैंडबॉक्स मर्चेंट एडमिन (sandbox.simplepay.hu) में account > Technical data से लें।

IPN URL

IPN वह संदेश है जो भुगतान की स्थिति बदलने पर SimplePay आपके स्टोर को भेजता है। ऑर्डर के भुगतान किए जाने का यह सामान्य तरीका है। सेटिंग्स पेज आपके स्टोर का IPN URL दिखाता है। यह कुछ इस तरह दिखता है: https://your-site/wc-api/simplepay_payment_callback/। इस URL को SimplePay मर्चेंट एडमिन में हर मर्चेंट खाते (लाइव और सैंडबॉक्स) में सेट करें। यदि आपकी साइट URL में भाषा प्रीफ़िक्स इस्तेमाल करती है या दूसरे पते रीडायरेक्ट करती है, तो URL को बिल्कुल वैसा ही कॉपी करें जैसा सेटिंग्स दिखाती हैं, क्योंकि रीडायरेक्ट हुआ IPN खो जाता है।

IPN उस मर्चेंट खाते के SECRET KEY से हस्ताक्षरित होना चाहिए, जिसका वह नाम लेता है। बिना वैध हस्ताक्षर के IPN अस्वीकार किए जाते हैं। प्लगइन हर वैध IPN की पुष्टि SimplePay को उस हस्ताक्षरित रूप में करता है, जिसकी SimplePay माँग करता है। ये IPN स्थितियाँ ऑर्डर बदलती हैं:

विफल और रद्द केवल उस ऑर्डर के नवीनतम भुगतान प्रयास पर सेट होते हैं जो अभी भी भुगतान लंबित है। अन्य स्थितियाँ लॉग में दर्ज होती हैं और ऑर्डर नहीं बदलतीं। IPN के बिना, ऑर्डर तभी पक्का होता है जब ग्राहक सफल भुगतान के बाद स्टोर पर लौटता है।

ऑर्डर

Order Status After Payment: सफल भुगतान के बाद सेट होने वाली ऑर्डर स्थिति। स्थिति तुरंत सेट होती है, दूसरी स्थिति-बदलाव के बिना।

उन्नत

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

Delete Data on Uninstall: Remove all plugin data when uninstalling। चालू होने पर प्लगइन हटाने से गेटवे सेटिंग्स और प्लगइन के लॉग हट जाते हैं। ऑर्डर का डेटा हमेशा रखा जाता है। डिफ़ॉल्ट: बंद।

चेकआउट

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

सफल भुगतान के बाद ग्राहक आपके स्टोर के प्राप्त ऑर्डर पेज पर लौटता है। केवल लौट आने से ऑर्डर कभी भुगतान किया हुआ नहीं होता: प्लगइन हस्ताक्षरित अनुरोध के साथ SimplePay से लेन-देन की स्थिति माँगता है, इसलिए IPN देर से आने पर भी ऑर्डर पक्का होता है। प्राप्त ऑर्डर पेज Successful transaction. SimplePay transaction ID: और ID दिखाता है। यदि भुगतान अभी पक्का नहीं हुआ है, तो वह Your payment is being confirmed by SimplePay. SimplePay transaction ID: और ID दिखाता है।

यदि भुगतान विफल होता है, रद्द होता है या समय-सीमा समाप्त होती है, तो ग्राहक को चेकआउट पर वापस भेजा जाता है, या यदि कार्ट खाली है तो Pay for order पेज पर। वहाँ ग्राहक को लेन-देन ID के साथ SimplePay का संदेश दिखता है, जैसे Cancelled payment. You cancelled the payment या Timeout. The time allowed to complete the payment has expired। विफल भुगतान पर ग्राहक से कहा जाता है कि वह दर्ज किया गया डेटा जाँचे और कार्ड जारी करने वाले बैंक से संपर्क करे। ग्राहक फिर से कोशिश कर सकता है। हर नए प्रयास को अपना SimplePay संदर्भ मिलता है, जैसे 123, 123-2, 123-3।

यदि SimplePay भुगतान शुरू नहीं कर पाता, तो ग्राहक को The SimplePay payment could not be started. Please try again or choose another payment method. दिखता है। यदि ऑर्डर की मुद्रा का कोई मर्चेंट खाता नहीं है, तो संदेश होता है SimplePay is not available for the currency of this order. Please choose another payment method. तकनीकी कारण ऑर्डर नोट्स और लॉग में जुड़ जाता है। लॉग-इन स्टोर मैनेजर संदेश में भी इसे देखते हैं।

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

प्लगइन केवल SimplePay पेज पर लिए जाने वाले एक-बार के कार्ड भुगतान स्वीकार करता है। इसमें सेव किए गए कार्ड या वन-क्लिक भुगतान, सब्सक्रिप्शन या आवर्ती भुगतान नहीं हैं, और अलग-अलग authorize और capture भी नहीं है।

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

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

Pending payment: ग्राहक को SimplePay पर भेजा गया है और उसने अभी भुगतान नहीं किया है, या SimplePay ने अभी भुगतान की पुष्टि नहीं की है। ऑर्डर नोट में शुरू किया गया लेन-देन, राशि और मोड (सैंडबॉक्स या लाइव) दिखता है।

Processing or Completed: भुगतान की पुष्टि हो गई है। स्थिति Order Status After Payment का पालन करती है। ऑर्डर नोट में लेन-देन ID दिखता है, और यह भी कि भुगतान की पुष्टि IPN ने की या स्थिति-अनुरोध ने। SimplePay लेन-देन ID को ऑर्डर के लेन-देन ID के रूप में सेव किया जाता है। देर से आया सफल भुगतान उस ऑर्डर को भी पूरा कर देता है जो विफल या रद्द था।

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

Failed: SimplePay ने बताया कि नवीनतम भुगतान प्रयास अधिकृत नहीं था या धोखाधड़ी था।

Cancelled: SimplePay ने बताया कि नवीनतम भुगतान प्रयास का समय समाप्त हो गया या वह रद्द हो गया।

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

रिफ़ंड

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

SimplePay मर्चेंट एडमिन में किए गए रिफ़ंड WooCommerce के साथ सिंक नहीं होते। उन्हें Refund via SimplePay (OTP) का उपयोग किए बिना WooCommerce में मैन्युअली दर्ज करें।

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

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

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

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

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

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

चेकआउट पर SimplePay दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, ऑर्डर की मुद्रा HUF, EUR या USD है, और उस मुद्रा में वर्तमान मोड के लिए Merchant ID और Secret key दोनों हैं: Sandbox mode चालू होने पर सैंडबॉक्स खाते, और बंद होने पर लाइव खाते। जब स्टोर मुद्रा का कोई खाता नहीं होता, तो सेटिंग्स पेज चेतावनी दिखाता है।

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

IPN का उत्तर Invalid signature है: IPN ऐसे मर्चेंट खाते का नाम लेता है जो सेटिंग्स में नहीं है, या उसकी Secret key गलत है। MERCHANT और SECRET KEY को ठीक वैसे ही दर्ज करें जैसे SimplePay मर्चेंट एडमिन उन्हें दिखाता है। SimplePay पुष्टि न हुए IPN दोबारा भेजता है।

IPN का उत्तर Order not found या Unknown transaction है: IPN ऐसे ऑर्डर या लेन-देन के लिए है जिसे यह स्टोर शुरू नहीं कर पाया। ऑर्डर नहीं बदलता।

IPN का उत्तर Busy, retry है: ऑर्डर उसी समय किसी दूसरे अनुरोध से पक्का किया जा रहा था। SimplePay IPN दोबारा भेजता है।

ग्राहक को ऑर्डर देते समय त्रुटि दिखती है: ऑर्डर नोट्स खोलें या WooCommerce > Status > Logs देखें, स्रोत wcp_simplepay_gateway। गलत secret key से Invalid response signature from SimplePay. Check the secret key of the merchant account. आता है। SimplePay की त्रुटियाँ SimplePay error code(s): के बाद कोड के रूप में दिखाई जाती हैं।

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

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

रिफ़ंड विफल होता है: संदेश पढ़ें। SimplePay refunds in HUF must be whole amounts. का अर्थ है कि HUF राशि में दशमलव था। यदि संदेश कहता है कि इस भुगतान का मर्चेंट खाता कॉन्फ़िगर नहीं है, तो वह खाता (मुद्रा और मोड) दोबारा दर्ज करें जिससे भुगतान हुआ था। यदि SimplePay ने कोई अलग राशि रिफ़ंड की है, तो संदेश आपसे SimplePay एडमिन में रिफ़ंड जाँचने को कहता है।

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

अनइंस्टॉल

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

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