VibeFox Satispay for WooCommerce — सहायता

आवश्यकताएँ

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

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

PHP: 8.0 या बाद का संस्करण, OpenSSL एक्सटेंशन के साथ। OpenSSL के बिना प्लगइन एडमिन क्षेत्र में त्रुटि दिखाता है और भुगतान विधि लोड नहीं होती।

मुद्रा: EUR। Satispay केवल यूरो में शुल्क लेता है, इसलिए जब स्टोर की मुद्रा (या Pay for order पेज पर ऑर्डर की मुद्रा) EUR न हो, तो भुगतान विधि छिप जाती है।

Satispay खाता: एक Satispay Business खाता। आप कोई API कुंजी कॉपी नहीं करते: प्लगइन उस एक बार उपयोग होने वाले एक्टिवेशन कोड से जुड़ता है जिसे आप Satispay Business Dashboard में बनाते हैं (देखें कॉन्फ़िगरेशन)। परीक्षण के लिए आपको Satispay सैंडबॉक्स खाता चाहिए, जिसे आप Satispay for developers से माँग सकते हैं।

सार्वजनिक साइट: आपकी साइट इंटरनेट से पहुँच योग्य होनी चाहिए, ताकि भुगतान बदलने पर Satispay उसे कॉल कर सके। इसके लिए Satispay में कुछ कॉन्फ़िगर करने की ज़रूरत नहीं है।

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

इंस्टॉलेशन

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

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

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

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

5. वातावरण चुनें: परीक्षण के लिए Sandbox Mode पर निशान लगाएँ, असली भुगतान के लिए निशान हटाकर रखें।

6. उस वातावरण का एक्टिवेशन कोड Activation Code में चिपकाएँ और सहेजें। कनेक्शन की स्थिति में Key ID दिखेगा।

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

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

सारी सेटिंग एक ही पेज पर हैं: WooCommerce > Settings > Payments > Satispay। Satispay connection सेक्शन दोनों वातावरणों की स्थिति दिखाता है, जैसे Key ID के साथ Live: Connected या Sandbox: Not connected, और उपयोग में आने वाले वातावरण को चिह्नित करता है। जब तक उपयोग में आने वाला वातावरण कनेक्ट नहीं होता, पेज कहता है: उपयोग में आने वाला वातावरण कनेक्ट होने तक Satispay चेकआउट पर नहीं दिखता। WooCommerce की भुगतान विधियों की सूची में, उपयोग में आने वाला वातावरण कनेक्ट होने तक Satispay को सेटअप की ज़रूरत वाला दिखाया जाता है, और Sandbox Mode चालू रहने पर टेस्ट मोड बैज दिखता है।

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

Checkout

ग्राहक भुगतान विधियों की सूची में जो देखते हैं।

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

Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: Pay with the Satispay app: scan the QR code or confirm the payment on your phone.

Satispay connection

Sandbox Mode: Use the Satispay sandbox (staging) environment। सैंडबॉक्स भुगतान पर शुल्क नहीं लगता। डिफ़ॉल्ट: बंद। सैंडबॉक्स और लाइव की कुंजियाँ अलग हैं: हर वातावरण को उसी वातावरण के एक्टिवेशन कोड से जोड़ें। सैंडबॉक्स उपयोग में होने पर ग्राहकों को भुगतान विधि के नीचे सैंडबॉक्स मोड: कोई असली राशि नहीं ली जाती। दिखता है।

Activation Code: ऊपर चुने गए वातावरण को जोड़ने के लिए 6 अक्षरों का नया एक्टिवेशन कोड चिपकाएँ और सहेजें। लाइव कोड Satispay Business Dashboard के Online shop सेक्शन में बनते हैं। सैंडबॉक्स कोड Satispay सैंडबॉक्स खाते के साथ मिलते हैं। कोड केवल एक बार इस्तेमाल होता है और सहेजा नहीं जाता। मौजूदा कनेक्शन रखने के लिए यह फ़ील्ड खाली छोड़ दें।

कोड के साथ सहेजने पर प्लगइन RSA कुंजी जोड़ी बनाता है, सार्वजनिक कुंजी और कोड को Satispay को भेजता है, और WordPress डेटाबेस में Key ID तथा उस वातावरण की कुंजियाँ सहेजता है। सफल होने पर पेज पर, उदाहरण के लिए, Satispay Live connected. Key ID: और उसके बाद ID दिखता है। यदि Satispay कोड अस्वीकार करता है, तो पेज Satispay का संदेश दिखाता है और आपसे जाँचने को कहता है कि कोड इसी वातावरण का है और अभी तक इस्तेमाल नहीं हुआ है। अक्षरों और अंकों के अलावा अन्य वर्णों वाला कोड कुछ भी भेजे जाने से पहले अस्वीकार कर दिया जाता है। किसी वातावरण के लिए नया कोड सहेजने से उसका पिछला कनेक्शन बदल जाता है।

Payment notifications

Satispay में कुछ भी कॉन्फ़िगर नहीं करना है। हर भुगतान का अपना कॉलबैक URL होता है, जिसे भुगतान बदलने पर Satispay कॉल करता है, और प्लगइन ऑर्डर बदलने से पहले Satispay API से भुगतान दोबारा पढ़ता है। यह सेक्शन इस URL का एक उदाहरण दिखाता है। यह कुछ ऐसा दिखता है: https://your-site/wc-api/satispay_payment_callback/?action=callback&order_id={order}&payment_id={uuid}। यह URL इंटरनेट से पहुँच योग्य होना चाहिए: /wc-api/ पर कोई मेंटेनेंस मोड या पासवर्ड सुरक्षा नहीं होनी चाहिए।

Advanced

Debug log: Log API calls and payment events WooCommerce > Status > Logs में लिखता है, स्रोत wcp_satispay_gateway, बिना कुंजियों या ग्राहक डेटा के। यह बंद होने पर भी त्रुटियाँ हमेशा दर्ज होती हैं। डिफ़ॉल्ट: बंद।

Delete data on uninstall: Remove the settings and Satispay keys when the plugin is deleted। ऑर्डर पर सहेजा गया भुगतान डेटा रखा जाता है। डिफ़ॉल्ट: बंद।

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Satispay) और Pay with Satispay पर क्लिक करता है। प्लगइन ऑर्डर के कुल योग के लिए यूरो में एक Satispay भुगतान बनाता है, संदर्भ के रूप में ऑर्डर नंबर रखता है, और ग्राहक को Satispay के भुगतान पेज पर भेज देता है। कंप्यूटर पर ग्राहक Satispay ऐप से QR कोड स्कैन करता है। फ़ोन पर ग्राहक ऐप में भुगतान की पुष्टि करता है।

भुगतान के बाद ग्राहक आपके स्टोर पर लौट आता है। ऑर्डर को भुगतान किया हुआ तभी चिह्नित किया जाता है जब Satispay भुगतान की पुष्टि कर दे: प्लगइन Satispay API से भुगतान पढ़ता है, जाँचता है कि वह इसी ऑर्डर के लिए बना था, और उसकी स्थिति, राशि (सेंट में) और मुद्रा की ऑर्डर से तुलना करता है। यह तब होता है जब Satispay कॉलबैक URL को कॉल करता है और जब ग्राहक लौटता है, जो भी पहले हो। यदि भुगतान की अभी पुष्टि नहीं हुई है, तो ऑर्डर प्राप्ति पेज पर दिखता है: Satispay ने अभी तक आपके भुगतान की पुष्टि नहीं की है। पुष्टि मिलते ही ऑर्डर अपने-आप अपडेट हो जाएगा।

यदि ग्राहक बिना भुगतान किए Satispay पेज छोड़ देता है, तो प्लगइन Satispay पर भुगतान रद्द कर देता है, ताकि छोड़ा हुआ पेज अब भुगतान योग्य न रहे। ग्राहक को चेकआउट (या Pay for order पेज) पर वापस भेजा जाता है, इस संदेश के साथ: Your Satispay payment was cancelled and nothing was charged. You can try again or choose another payment method. ऐप में भुगतान अस्वीकार करने पर भी यही संदेश दिखता है।

ग्राहक किसी बिना भुगतान वाले ऑर्डर को फिर से भुगतान कर सकता है, जैसे Pay for order पेज से। नया Satispay भुगतान बनाने से पहले पिछले भुगतान की जाँच होती है: लंबित भुगतान Satispay पर रद्द हो जाता है, और यदि वह पहले ही भुगतान हो चुका है, तो ऑर्डर उसी भुगतान से भुगतान किया हुआ चिह्नित हो जाता है और दूसरा भुगतान नहीं बनता।

यदि भुगतान शुरू नहीं हो पाता, तो ग्राहक को एक छोटा संदेश दिखता है और वह कोई अन्य भुगतान विधि चुन सकता है: Satispay is not available at the moment. Please choose another payment method. तब, जब स्टोर कनेक्ट न हो या Satispay कुंजियाँ अस्वीकार करे, या Unable to create the Satispay payment. Please try again or choose another payment method. अन्य त्रुटियों के लिए। कारण लॉग में लिखा जाता है।

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

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

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

Order statuses

Pending payment: ग्राहक को Satispay पर भेजा गया है और उसने अभी भुगतान नहीं किया है, या Satispay ने अभी भुगतान की पुष्टि नहीं की है। ऑर्डर नोट में Satispay भुगतान ID, राशि और वातावरण (Live या Sandbox) दिखते हैं।

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

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

Cancelled: ऑर्डर का नवीनतम Satispay भुगतान रद्द हो गया या समाप्त हो गया, उदाहरण के लिए इसलिए कि ग्राहक Satispay पेज से चला गया। कोई पुराना भुगतान जो समाप्त होता है, वह किसी ऐसे ऑर्डर को रद्द नहीं करता जिसका नया भुगतान चल रहा हो। आपके द्वारा एडमिन क्षेत्र में बनाए गए ऑर्डर (भुगतान लिंक) रद्द नहीं होते: वे नोट के साथ Pending payment रहते हैं, ताकि ग्राहक अब भी भुगतान कर सके।

यदि पहले से भुगतान किए गए ऑर्डर के लिए दूसरा भुगतान स्वीकार होता है, तो ऑर्डर नहीं बदलता। एक नोट आपसे अनुरोध करता है कि डुप्लिकेट भुगतान का रिफ़ंड Satispay Dashboard से करें। दोहराई गई पुष्टि कभी रद्द या रिफ़ंड किए गए ऑर्डर को दोबारा नहीं खोलती।

Refunds

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

Satispay Dashboard में किए गए रिफ़ंड WooCommerce रिफ़ंड में नहीं बदलते। ज़रूरत हो तो Refund via Satispay का उपयोग किए बिना WooCommerce में मैन्युअल रिफ़ंड बनाएँ।

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

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

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

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

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

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

Satispay चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, उपयोग में आने वाला वातावरण कनेक्ट है (Satispay connection सेक्शन उसके लिए Connected दिखाता है) और मुद्रा EUR है।

भुगतान हो गया, लेकिन ऑर्डर Pending payment पर रहता है: ऑर्डर तब अपडेट होता है जब Satispay आपकी साइट को कॉल करता है या ग्राहक लौटता है। जाँचें कि आपकी साइट इंटरनेट से पहुँच योग्य है, /wc-api/ पर कोई मेंटेनेंस मोड या पासवर्ड सुरक्षा नहीं है, और WooCommerce > Status > Logs देखें, स्रोत wcp_satispay_gateway। भुगतान Satispay Dashboard में दिखता है।

कॉलबैक जवाब देता है Payment status unavailable, retry later या Not configured: प्लगइन Satispay से भुगतान नहीं पढ़ पाया, या ऑर्डर का वातावरण कनेक्ट नहीं है। ऑर्डर नहीं बदला जाता। कनेक्शन की स्थिति और लॉग जाँचें।

कॉलबैक जवाब देता है Busy, retry later: उसी समय कोई और अनुरोध ऑर्डर अपडेट कर रहा था। इस कॉलबैक से ऑर्डर नहीं बदलता। यह अगले कॉलबैक पर या ग्राहक के लौटने पर अपडेट होगा।

कॉलबैक जवाब देता है Unknown payment या Missing or invalid payment_id: भुगतान इस ऑर्डर के लिए नहीं बनाया गया था, या अनुरोध Satispay का कॉलबैक नहीं है। ऑर्डर नहीं बदलता।

एक्टिवेशन विफल: एक्टिवेशन कोड केवल एक बार इस्तेमाल हो सकते हैं। जाँचें कि कोड Sandbox Mode में चुने गए वातावरण का है (लाइव के लिए लाइव कोड, सैंडबॉक्स के लिए सैंडबॉक्स कोड), नया कोड बनाएँ और फिर से सहेजें। यदि पेज कहता है कि RSA कुंजी जोड़ी नहीं बन सकी, तो अपने होस्ट से PHP OpenSSL एक्सटेंशन चालू करने को कहें।

सैंडबॉक्स से लाइव पर जाने के बाद Satispay चेकआउट से गायब हो गया: सैंडबॉक्स और लाइव की कुंजियाँ अलग हैं। Sandbox Mode का निशान हटाकर लाइव एक्टिवेशन कोड चिपकाएँ और सहेजें।

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

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

Satispay did not accept the refund के साथ रिफ़ंड विफल: Satispay ने accepted से अलग स्थिति लौटाई। WooCommerce ने रिफ़ंड दर्ज नहीं किया। इसे Satispay Dashboard में जाँचें।

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

अनइंस्टॉल

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

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