VibeFox Satispay for OpenCart — सहायता

आवश्यकताएँ

OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या 4.0.2 और उसके बाद का संस्करण (4.1.0.3 पर परीक्षण किया गया)।

PHP: OpenSSL एक्सटेंशन के साथ 8.0 या उसके बाद का संस्करण। यह एक्सटेंशन अपनी RSA कुंजियाँ OpenSSL से बनाता है।

मुद्रा: EUR। Satispay केवल यूरो में भुगतान लेता है। EUR मुद्रा System > Localisation > Currencies में सक्षम होनी चाहिए, और भुगतान विधि केवल तभी दिखती है जब ग्राहक ने EUR चुना हो।

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

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

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

इंस्टॉलेशन

डाउनलोड एक zip फ़ाइल है, जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। इसे अपने कंप्यूटर पर अनज़िप करें। इसमें README.txt, OpenCart 3 का पैकेज wcp_satispay_gateway-oc3-(संस्करण).ocmod.zip और OpenCart 4 का पैकेज wcp_satispay_gateway.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।

OpenCart 3

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_satispay_gateway-oc3-(संस्करण).ocmod.zip चुनें। इस एक्सटेंशन में कोई OCMOD संशोधन नहीं है, इसलिए Extensions > Modifications को रिफ़्रेश करने की ज़रूरत नहीं है। इंस्टॉलर के बजाय आप इस पैकेज के upload फ़ोल्डर की सामग्री को अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।

2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Satispay Gateway ढूँढें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन उपयोगकर्ता के पास भुगतान एक्सटेंशन की सूची बदलने का अधिकार होना चाहिए।

3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। पेज के ऊपर लाइसेंस ब्लॉक में License key में अपनी VibeFox लाइसेंस कुंजी पेस्ट करें और Activate पर क्लिक करें (देखें License key)।

4. वातावरण चुनें: परीक्षण के लिए Sandbox Mode चालू करें, असली भुगतानों के लिए इसे बंद रखें।

5. उस वातावरण का एक एक्टिवेशन कोड Activation Code में पेस्ट करें और Save पर क्लिक करें। तब Status फ़ील्ड Key ID के साथ Connected दिखाएगा।

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

OpenCart 4

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_satispay_gateway.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।

2. इंस्टॉल किए गए एक्सटेंशन की सूची में पैकेज उसी पेज पर दिखता है। उसके आगे Install (हरा + बटन) पर क्लिक करें।

3. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Satispay Gateway खोजें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर क्लिक करें।

4. लाइसेंस कुंजी दर्ज करें, वातावरण चुनें और एक्टिवेशन कोड से उसे कनेक्ट करें, जैसा OpenCart 3 के चरण 3 से 6 में बताया गया है। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल callback URL अलग है (देखें Payment notifications)।

नया इंस्टॉल भुगतान विधि बंद और लाइव वातावरण चयनित होकर शुरू होता है।

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Satispay Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरे पेज को सेव करता है। सेटिंग्स के ऊपर पेज आपको चेतावनी देता है जब भुगतान विधि सक्षम हो, लेकिन उपयोग में आने वाला वातावरण कनेक्ट न हो (तब चेकआउट पर भुगतान विधि छिपी रहती है), और जब स्टोर की डिफ़ॉल्ट मुद्रा EUR न हो (तब भुगतान विधि केवल तभी दिखती है जब ग्राहक ने EUR चुना हो)। एक्सटेंशन को संशोधित करने के अधिकार के बिना पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

सेव करते समय Title 1 से 128 अक्षरों का होना चाहिए, Sort Order एक पूर्ण संख्या होनी चाहिए (ऋणात्मक संख्याएँ मान्य हैं), Total 0 या उससे बड़ी संख्या होनी चाहिए, और geo zone तथा ऑर्डर स्टेटस मौजूद होने चाहिए। यदि कोई मान गलत है, तो कुछ भी सेव नहीं होता और एक्टिवेशन कोड नहीं भेजा जाता।

चेकआउट

Enable/Disable: Enable Satispay payment भुगतान विधि को चालू या बंद करता है। Default: off.

Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखते हैं। ऑर्डर में भी भुगतान विधि का यही नाम सेव होता है। Default: Satispay. आवश्यक, 128 अक्षरों तक।

Description: वह पाठ जो ग्राहक को Confirm Order चरण में, कन्फ़र्म बटन के ऊपर दिखता है। Default: Pay with the Satispay app: scan the QR code or confirm the payment on your phone.

Sort Order: चेकआउट पर भुगतान विधियों के बीच Satispay की स्थिति। खाली छोड़ें या एक पूर्ण संख्या दर्ज करें।

Geo Zone: Satispay केवल चुने गए geo zone में स्थित भुगतान पतों के लिए दें। Default: All zones। Geo zones System > Localisation > Geo Zones में सेट किए जाते हैं।

Total: स्टोर की डिफ़ॉल्ट मुद्रा में चेकआउट कुल राशि, जिसे Satispay दिखाए जाने से पहले ऑर्डर को पहुँचना चाहिए: 0 या उससे बड़ी एक संख्या। किसी भी कुल राशि के लिए Satispay दिखाने हेतु खाली छोड़ें।

Satispay कनेक्शन

Status: दोनों वातावरणों की स्थिति, उदाहरण के लिए Key ID के साथ Live: Connected या Sandbox: Not connected, और कौन-सा वातावरण in use है। जब तक उपयोग में आने वाला वातावरण कनेक्ट नहीं होता, यह फ़ील्ड कहता है: Satispay is hidden at checkout until the environment in use is connected.

Sandbox Mode: Satispay के सैंडबॉक्स (स्टेजिंग) वातावरण का उपयोग करता है। सैंडबॉक्स भुगतानों से कोई शुल्क नहीं लिया जाता। Default: off. सैंडबॉक्स और लाइव की कुंजियाँ अलग हैं: हर वातावरण को उसी वातावरण के एक्टिवेशन कोड से कनेक्ट करें। सैंडबॉक्स उपयोग में होने पर ग्राहकों को Confirm Order चरण पर Sandbox mode: no real money is charged. दिखता है।

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

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

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

Satispay में कुछ भी कॉन्फ़िगर नहीं करना है। हर भुगतान का अपना callback URL होता है, जिसे भुगतान बदलने पर Satispay कॉल करता है, और एक्सटेंशन ऑर्डर बदलने से पहले Satispay API से भुगतान को दोबारा पढ़ता है। Callback URL फ़ील्ड इस URL का एक उदाहरण दिखाता है। OpenCart 3 पर यह कुछ इस तरह दिखता है: https://your-store/index.php?route=extension/payment/wcp_satispay_gateway/callback&satispay_p_order={order}&payment_id={uuid}, और OpenCart 4 पर: https://your-store/index.php?route=extension/wcp_satispay_gateway/payment/wcp_satispay_gateway.callback&satispay_p_order={order}&payment_id={uuid}। यह आपकी OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। यह URL इंटरनेट से पहुँच योग्य होना चाहिए: इसके सामने कोई फ़ायरवॉल या बेसिक प्रमाणीकरण नहीं होना चाहिए। OpenCart का मेंटेनेंस मोड इसे ब्लॉक नहीं करता। यदि callback आपके स्टोर तक नहीं पहुँच पाता, तो ग्राहक के लौटने पर ऑर्डर की पुष्टि होती है।

ऑर्डर

OpenCart Confirm Order चरण पर ऑर्डर बिना स्टेटस के बनाता है (एक लापता ऑर्डर, missing order)। ऑर्डर को तभी स्टेटस मिलता है जब Satispay भुगतान स्वीकार कर लेता है। नीचे का हर फ़ील्ड आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध करता है।

Order Status After Payment: भुगतान स्वीकार होने के बाद सेट होने वाला स्टेटस। Default: Processing.

Satispay Payment On Hold Status: पैसे प्राप्त हो गए, लेकिन ऑर्डर की समीक्षा की आवश्यकता है (देखें Order statuses)। Default: Pending, क्योंकि OpenCart में On hold स्टेटस नहीं है। आप System > Localisation > Order Statuses में अपना स्टेटस बना सकते हैं और यहाँ चुन सकते हैं।

Refunded Status: ऑर्डर पेज से भुगतान पूरी तरह रिफ़ंड होने के बाद सेट होता है। Default: Refunded.

एडवांस्ड

Debug log: API कॉल और भुगतान इवेंट्स को OpenCart लॉग फ़ोल्डर (storage/logs) में satispay_p_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खोली जा सकती, और 5 MB पर इसे satispay_p_debug.old.log.php में ले जाया जाता है। कुंजियाँ, एक्टिवेशन कोड और ग्राहक का डेटा लॉग नहीं होते। यह बंद होने पर भी त्रुटियाँ हमेशा लॉग होती हैं। Default: off.

Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। लॉग खाली करने के लिए Clear log पर क्लिक करें।

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

इंपोर्ट / एक्सपोर्ट

Export: Download JSON सेटिंग्स को एक JSON फ़ाइल के रूप में सेव करता है। Satispay कुंजियाँ एक्सपोर्ट नहीं होतीं।

Import: पहले से एक्सपोर्ट किया गया JSON पेस्ट करें और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। Satispay कनेक्शन बना रहता है।

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Satispay)। Confirm Order चरण पर ग्राहक आपका विवरण और यह नोट देखता है: You will be redirected to the Satispay page: scan the QR code with the Satispay app or confirm the payment on your phone. OpenCart इस चरण पर ऑर्डर बनाता है, अभी भी बिना स्टेटस के। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर नंबर को संदर्भ के रूप में रखकर, यूरो में ऑर्डर कुल राशि के लिए एक Satispay भुगतान बनाता है और ग्राहक को Satispay भुगतान पेज पर भेजता है। कंप्यूटर पर ग्राहक Satispay ऐप से QR कोड स्कैन करता है। फ़ोन पर ग्राहक ऐप में भुगतान की पुष्टि करता है। OpenCart 4 पर ग्राहक Payment method options विंडो में, भुगतान विधि ब्लॉक के Choose बटन से भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है।

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर को भुगतान किया हुआ तभी चिह्नित किया जाता है जब Satispay उसकी पुष्टि करता है: एक्सटेंशन Satispay API से भुगतान पढ़ता है, जाँचता है कि वह इसी ऑर्डर के लिए बनाया गया था, और उसके स्टेटस, राशि (सेंट में) और मुद्रा की तुलना ऑर्डर से करता है। यह तब होता है जब Satispay callback URL को कॉल करता है और जब ग्राहक लौटता है, जो भी पहले हो। इसके बाद ऑर्डर OpenCart के मानक तरीके से स्टेटस पाता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है। यदि ग्राहक के लौटने तक Satispay ने भुगतान की पुष्टि नहीं की है, तो एक Payment confirmation पेज Satispay has not confirmed your payment yet. The order will be updated automatically as soon as the confirmation arrives. संदेश और एक Check again बटन दिखाता है। Callback के आते ही ऑर्डर स्टेटस सेट हो जाता है।

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

OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर एक नया ऑर्डर बनाता है। OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसे अपडेट करता है, इसलिए रद्द किए गए भुगतान के बाद वही ऑर्डर नए Satispay भुगतान से चुकाया जाता है। नया Satispay भुगतान बनाने से पहले कार्ट के पिछले भुगतान जाँचे जाते हैं: लंबित भुगतान Satispay पर रद्द कर दिया जाता है, और यदि उनमें से कोई पहले ही भुगतान हो चुका है, तो वह अपने ऑर्डर की पुष्टि करता है; कोई दूसरा भुगतान नहीं किया जाता और ग्राहक सीधे सफलता पेज पर जाता है।

OpenCart 4 पर रद्द किए गए भुगतान का संदेश चेकआउट पेज के ऊपर दिखता है। यदि चेकआउट का ऑर्डर स्टोर ने इस बीच बंद कर दिया हो (उदाहरण के लिए रद्द या रिफ़ंड), या वह पहले से भुगतान किया जा चुका हो लेकिन उसके बाद कार्ट बदल गया हो, जिसमें नई मात्रा भी शामिल है, तो ग्राहक Your previous order is already closed. Please confirm the order again: the cart will be paid with a new order. संदेश के साथ चेकआउट पर वापस भेजा जाता है, और अगला Confirm Order एक नए ऑर्डर का भुगतान करता है।

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

Callback और ग्राहक की वापसी दोनों तब काम करते हैं जब स्टोर मेंटेनेंस मोड में हो: OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को जाने देता है, और OpenCart 4 पर एक्सटेंशन इनके लिए एक स्टार्टअप क्रिया जोड़ता है।

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

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

ऑर्डर स्टेटस

No status (missing order): ग्राहक को Satispay पर भेजा गया था और उसने भुगतान नहीं किया, या Satispay ने अभी भुगतान की पुष्टि नहीं की है। Sales > Orders में ऐसे ऑर्डर केवल तब दिखते हैं जब फ़िल्टर Order Status को Missing Orders पर सेट किया गया हो। रद्द किया गया Satispay भुगतान ऑर्डर को बिना स्टेटस के छोड़ देता है, और ग्राहक फिर से भुगतान कर सकता है।

Order Status After Payment (default Processing): भुगतान स्वीकार हो गया। एक नोट Satispay भुगतान, राशि और यह दिखाता है कि उसकी पुष्टि कैसे हुई (callback, redirect या checkout)।

Satispay Payment On Hold Status (default Pending): Satispay ने ऑर्डर कुल से अलग राशि या मुद्रा बताई, या ऑर्डर को कोई दूसरा स्टेटस (उदाहरण के लिए रद्द) मिलने के बाद भुगतान स्वीकार हुआ। नोट इसे समझाता है। Satispay Dashboard में भुगतान जाँचें, फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें। यदि उसी कार्ट का सही राशि वाला कोई और भुगतान बाद में स्वीकार होता है, तो ऑर्डर Order Status After Payment पर चला जाता है।

Refunded Status (default Refunded): भुगतान एक्सटेंशन के ज़रिए पूरी तरह रिफ़ंड किया गया।

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

नोट्स ऑर्डर के History की वे प्रविष्टियाँ हैं जिन्हें ग्राहक नहीं देखता।

VibeFox Satispay Gateway tab

Sales > Orders में Satispay से भुगतान किया गया एक ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Satispay Gateway टैब सैंडबॉक्स भुगतानों के लिए Sandbox लेबल के साथ Satispay payment ID, भुगतान का Status, Paid / refunded राशियाँ, रिफ़ंड फ़ॉर्म, Refunds इतिहास, Satispay payments of this cart सूची (हर भुगतान प्रयास, उसके ऑर्डर और वातावरण के साथ), और ऑर्डर के Satispay notes दिखाता है। यह टैब उन उपयोगकर्ताओं को दिखता है जिनकी एक्सटेंशन तक पहुँच है।

रिफ़ंड

VibeFox Satispay Gateway टैब में Amount दर्ज करें (जो राशि अभी तक रिफ़ंड नहीं हुई है, वह अपने-आप भर जाती है), वैकल्पिक रूप से एक Reason (optional), और Refund via Satispay पर क्लिक करें। प्रश्न Refund this amount through Satispay? This cannot be undone. की पुष्टि करें। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। आपको एक्सटेंशन संशोधित करने का अधिकार चाहिए (System > Users > User Groups में सेट)। रिफ़ंड की राशि उस राशि तक सीमित है जो Satispay ने भुगतान के लिए ली थी, इसलिए राशि में अंतर होने के बाद आप ऑर्डर कुल के बजाय ग्राहक द्वारा वास्तव में चुकाई गई राशि तक ही रिफ़ंड कर सकते हैं। रिफ़ंड उस वातावरण (लाइव या सैंडबॉक्स) में भेजा जाता है जहाँ भुगतान हुआ था, इसलिए वह वातावरण अभी भी कनेक्ट होना चाहिए। रिफ़ंड तभी पूरा माना जाता है जब Satispay उसे स्वीकार करता है: सफल रिफ़ंड Satispay रिफ़ंड ID और कारण के साथ इतिहास और नोट्स में जुड़ता है। यदि Satispay रिफ़ंड स्वीकार नहीं करता, तो टैब त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। पूर्ण रिफ़ंड ग्राहक को सूचित किए बिना और उत्पादों को स्टॉक में वापस किए बिना ऑर्डर को Refunded Status पर सेट करता है, जैसे मैनुअल स्टेटस परिवर्तन। आंशिक रिफ़ंड स्टेटस नहीं बदलता। रिफ़ंड तब उपलब्ध होते हैं जब Satispay भुगतान स्वीकार कर चुका हो।

Sales > Returns में उत्पाद वापसी Satispay के ज़रिए पैसे वापस नहीं भेजती। Satispay Dashboard में किए गए रिफ़ंड OpenCart में दर्ज नहीं होते। ज़रूरत हो तो ऑर्डर मैन्युअली अपडेट करें।

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

यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Satispay Gateway Extensions > Extensions > Payments > VibeFox Satispay Gateway > Edit पर पहला ब्लॉक है, सेटिंग्स के ऊपर। कुंजी को License key में पेस्ट करें और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को मास्क करके, स्टेटस (उदाहरण के लिए वह तारीख जब तक लाइसेंस सक्रिय है और आपका डोमेन) और बटन दिखाता है: स्टेटस दोबारा जाँचने के लिए Check now, दूसरी कुंजी डालने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। उनके नीचे Product: opencart-payment-satispay वाली पंक्ति और Manage licenses and domains in your account लिंक है, जो आपका vibefox.net खाता खोलता है। केवल वे एडमिन उपयोगकर्ता कुंजी बदल सकते हैं जिनके पास इस एक्सटेंशन के लिए Modify अधिकार है। ब्लॉक के पाठ एडमिन भाषा का अनुसरण करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

यदि कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, उदाहरण के लिए Key not found, This key belongs to another product, Domain limit reached, या एक तारीख के साथ License expired on। स्टोर का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं हो पाती, तो एक्सटेंशन अंतिम ज्ञात स्टेटस के साथ काम करता रहता है।

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

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

जब लाइसेंस की अवधि समाप्त होती है, तो एक्सटेंशन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। जब आप एडमिन Dashboard या Edit पेज खोलते हैं, तो स्टेटस अपने-आप फिर से जाँचा जाता है: कुंजी डालने के बाद पहले 14 दिनों तक दिन में एक बार, फिर सप्ताह में एक बार। cron जॉब की ज़रूरत नहीं है। एक्सटेंशन अनइंस्टॉल करने पर लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हट जाते हैं।

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

Satispay चेकआउट पर दिखाई नहीं दे रहा: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, उपयोग में आने वाला वातावरण कनेक्ट है (Status फ़ील्ड उसके लिए Connected दिखाता है), और ग्राहक ने EUR चुना है। यह भी जाँचें कि भुगतान पता चुने हुए Geo Zone में है और ऑर्डर सेटिंग्स में दिए गए Total तक पहुँचता है।

भुगतान हो गया, लेकिन ऑर्डर बिना स्टेटस के है: ऑर्डर को स्टेटस तब मिलता है जब Satispay आपके स्टोर को कॉल करता है या जब ग्राहक लौटता है। जाँचें कि आपका स्टोर इंटरनेट से पहुँच योग्य है, callback URL के सामने कोई फ़ायरवॉल या बेसिक प्रमाणीकरण नहीं है, और Log फ़ील्ड में callbacks देखने के लिए Debug log चालू करें। भुगतान Satispay Dashboard में दिखता है।

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

Callback जवाब देता है Busy, retry later.: कार्ट उसी समय किसी दूसरे अनुरोध द्वारा कन्फ़र्म किया जा रहा था, या ऑर्डर स्टेटस सेट नहीं हो सका। Satispay फिर से कॉल करता है। लॉग कारण दिखाता है।

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

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

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

ग्राहक को This payment method is not available. दिखता है: चेकआउट अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान विधि बंद कर दी गई थी। ग्राहक चेकआउट को रीलोड करता है।

भुगतान के बाद ऑर्डर समीक्षा स्टेटस में है: VibeFox Satispay Gateway टैब में नोट्स पढ़ें (देखें Order statuses), Satispay Dashboard में भुगतान जाँचें, फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

टैब में रिफ़ंड फ़ॉर्म नहीं है: टैब कारण बताता है: ऑर्डर का कोई स्वीकृत Satispay भुगतान नहीं है, वह पूरी तरह रिफ़ंड हो चुका है, आपके उपयोगकर्ता समूह के पास एक्सटेंशन संशोधित करने का अधिकार नहीं है, या भुगतान का वातावरण अब कनेक्ट नहीं है।

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

Satispay did not accept the refund के साथ रिफ़ंड विफल: Satispay ने accepted से अलग स्टेटस लौटाया। OpenCart ने रिफ़ंड दर्ज नहीं किया, और एक नोट यह बताता है। Satispay Dashboard में जाँचें।

अनइंस्टॉल

Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox Satispay Gateway के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटा दिए जाते हैं। OpenCart एक्सटेंशन की अपनी सेटिंग्स हमेशा हटा देता है: Enable/Disable, Sort Order, Geo Zone, Total और Orders सेक्शन के ऑर्डर स्टेटस, जो दोबारा इंस्टॉल करने पर डिफ़ॉल्ट पर लौट आते हैं। OpenCart 4 पर एक्सटेंशन का इवेंट और उसकी स्टार्टअप क्रिया भी हटा दिए जाते हैं, जो मेंटेनेंस मोड में callback और ग्राहक की वापसी को जाने देती है। यदि Delete data on uninstall चालू है, तो बाकी गेटवे सेटिंग्स (शीर्षक, विवरण, सैंडबॉक्स मोड, लॉगिंग), दोनों वातावरणों की Satispay कुंजियाँ और लॉग हटा दिए जाते हैं। यदि यह बंद है, तो वे बाद में दोबारा इंस्टॉल करने के लिए रखे जाते हैं, Satispay कनेक्शन सहित। ऑर्डरों के लिए सेव किए गए Satispay भुगतान और रिफ़ंड हमेशा रखे जाते हैं, इसलिए पहले से भुगतान किए गए ऑर्डर वातावरण फिर से कनेक्ट होने के बाद, दोबारा इंस्टॉल करने पर भी रिफ़ंड किए जा सकते हैं। मौजूदा ऑर्डर अपने भुगतान नोट्स रखते हैं।

OpenCart 4 पर, एक्सटेंशन की फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल किए गए एक्सटेंशन की सूची में VibeFox Satispay Gateway के आगे Uninstall (नारंगी − बटन) पर क्लिक करें, और फिर अपलोड किए गए पैकेज को हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।

Satispay उसके संबंधित स्वामी का ट्रेडमार्क है। यह एक्सटेंशन Satispay से संबद्ध नहीं है और Satispay द्वारा समर्थित नहीं है।