VibeFox Stripe for OpenCart — सहायता

आवश्यकताएँ

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

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

Stripe खाता: आपको अपने Stripe खाते की secret API keys और Stripe Dashboard में एक webhook endpoint चाहिए (देखें कॉन्फ़िगरेशन)। केवल secret keys और webhook signing secrets उपयोग होते हैं। publishable keys (pk_...) की ज़रूरत नहीं है, क्योंकि Stripe Checkout Stripe द्वारा होस्ट किया गया पेज है।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. Stripe की secret keys चिपकाएँ, Stripe Dashboard में webhook सेट करें और उसकी signing secrets चिपकाएँ (देखें कॉन्फ़िगरेशन)।

5. Enable/Disable चालू करें और Save पर क्लिक करें। टेस्ट कार्ड 4242 4242 4242 4242 से टेस्ट मोड में एक भुगतान आज़माएँ, फिर Test Mode बंद करें।

OpenCart 4

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

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

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

4. लाइसेंस कुंजी, Stripe की secret keys और webhook वैसे ही दर्ज करें जैसे OpenCart 3 के चरण 3 से 5 में है। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल webhook URL अलग है (देखें Webhook)।

नई इंस्टॉलेशन भुगतान विधि बंद और टेस्ट मोड चालू के साथ शुरू होती है।

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

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

सेव करते समय Title 1 से 128 अक्षरों का होना चाहिए, Sort Order पूर्णांक होना चाहिए और Total 0 या उससे अधिक की संख्या होनी चाहिए। यदि कोई key या secret अपेक्षित prefix से शुरू नहीं होता, तो सेटिंग्स सेव हो जाती हैं और सेटिंग्स के ऊपर उस फ़ील्ड का नाम बताने वाली चेतावनी दिखती है।

Stripe Checkout

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

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

Description: Confirm Order चरण पर कन्फ़र्म बटन के ऊपर ग्राहक को दिखने वाला टेक्स्ट। डिफ़ॉल्ट: Pay securely with your credit or debit card via Stripe.

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

Geo Zone: Stripe केवल चुने गए geo zone के भुगतान पतों के लिए दें। डिफ़ॉल्ट: All zones। Geo zones System > Localisation > Geo Zones में सेट होते हैं।

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

API keys

Stripe Dashboard > Developers > API keys से secret keys कॉपी करें (पेज पर उसका लिंक है)। Test और live keys अलग-अलग हैं। Test mode केवल test keys, live mode केवल live keys का उपयोग करता है।

Test Mode: Stripe की test keys का उपयोग करता है। कोई वास्तविक राशि नहीं काटी जाती; 4242 4242 4242 4242 जैसे Stripe test cards से भुगतान करें। डिफ़ॉल्ट: चालू। वास्तविक भुगतान लेने के लिए इसे बंद करें। चालू रहने पर ग्राहकों को Confirm Order चरण पर टेस्ट मोड: कोई वास्तविक भुगतान नहीं लिया जा रहा है। दिखता है।

Test Secret Key: test mode की secret key। यह sk_test_ से शुरू होती है (restricted key हो तो rk_test_ से)।

Test Webhook Secret: test mode में बनाए गए webhook endpoint का signing secret (whsec_...)।

Live Secret Key: live mode की secret key। यह sk_live_ से शुरू होती है (restricted key हो तो rk_live_ से)।

Live Webhook Secret: live mode में बनाए गए webhook endpoint का signing secret (whsec_...)।

सेव की गई keys और secrets फिर कभी नहीं दिखाए जाते। फ़ील्ड खाली रहता है और सेव किया गया — रखने के लिए खाली छोड़ें। दिखाता है। केवल बदलने के लिए नया मान दर्ज करें। सेव किया हुआ मान हटाने के लिए फ़ील्ड के नीचे Clear the saved value on save पर निशान लगाएँ और Save पर क्लिक करें।

Webhook

Webhook आपके स्टोर को बताता है कि भुगतान हो चुका है। Stripe Dashboard > Developers > Webhooks में test mode के लिए एक endpoint और live mode के लिए दूसरा endpoint जोड़ें। इस सेक्शन के Endpoint URL में दिखाए गए URL का उपयोग करें। OpenCart 3 पर यह कुछ इस तरह दिखता है: https://your-store/index.php?route=extension/payment/wcp_stripe_gateway/webhook, और OpenCart 4 पर: https://your-store/index.php?route=extension/wcp_stripe_gateway/payment/wcp_stripe_gateway.webhook। यह आपकी OpenCart इंस्टॉलेशन के storefront पते से बनता है। URL को ठीक वैसे ही कॉपी करें जैसा सेटिंग्स उसे दिखाती हैं।

हर endpoint के लिए ये इवेंट चुनें (ये इस सेक्शन में भी सूचीबद्ध हैं):

हर endpoint बनाने के बाद Stripe से उसका signing secret (whsec_...) कॉपी करें और Test Webhook Secret या Live Webhook Secret में चिपकाएँ। वैध signature के बिना webhooks अस्वीकार होते हैं। कोई इवेंट केवल तभी स्वीकार होता है जब वह उसी mode के secret से साइन किया गया हो जिसमें भुगतान हुआ था, इसलिए test secret कभी भी वास्तविक भुगतान की पुष्टि नहीं करता। Webhook के बिना ऑर्डर तभी कन्फ़र्म होता है जब ग्राहक भुगतान के बाद स्टोर पर लौटता है।

ऑर्डर

OpenCart Confirm Order चरण पर ऑर्डर बिना स्थिति के बनाता है (अधूरा ऑर्डर)। ऑर्डर को स्थिति तभी मिलती है जब Stripe भुगतान की पुष्टि कर दे। नीचे हर फ़ील्ड आपके OpenCart ऑर्डर स्थितियों की सूची दिखाता है।

Order Status After Payment: सफल भुगतान के बाद सेट होने वाली स्थिति। डिफ़ॉल्ट: Processing।

Awaiting Payment Status: विलंबित भुगतान: चेकआउट पूरा हो गया है, पर Stripe ने पैसे की पुष्टि नहीं की है। डिफ़ॉल्ट: Pending।

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

Failed Payment Status: विलंबित भुगतान विफल रहा। डिफ़ॉल्ट: Failed।

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

उन्नत

Logging: Stripe के अनुरोध और webhooks को OpenCart के लॉग फ़ोल्डर (storage/logs) में strg_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खुलती, और 5 MB होने पर इसे strg_debug.old.log.php में ले जाया जाता है। Keys और ग्राहक का डेटा दर्ज नहीं होते। डिफ़ॉल्ट: बंद। बंद रहने पर त्रुटियों सहित कुछ भी नहीं लिखा जाता।

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

Delete Data on Uninstall: चालू होने पर एक्सटेंशन हटाने पर गेटवे सेटिंग्स और लॉग हट जाते हैं। Stripe के लेन-देन और रिफ़ंड हमेशा बने रहते हैं, इसलिए पुराने ऑर्डर अब भी रिफ़ंडेबल रहते हैं। डिफ़ॉल्ट: बंद।

आयात / निर्यात

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

Import: पहले निर्यात किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सेव की गई secret keys बनी रहती हैं।

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Stripe)। Confirm Order चरण पर ग्राहक को आपका विवरण और आपको सुरक्षित रूप से भुगतान पूरा करने के लिए Stripe पर भेजा जाएगा। नोट दिखता है। OpenCart इस चरण पर ऑर्डर बनाता है, पर अभी भी बिना स्थिति के। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर की राशि के लिए ऑर्डर की मुद्रा में Stripe Checkout session बनाता है और ग्राहक को Stripe के भुगतान पेज पर भेजता है। वहाँ ग्राहक क्रेडिट या डेबिट कार्ड से भुगतान करता है। OpenCart 4 पर ग्राहक Payment method options विंडो में, भुगतान विधि ब्लॉक के Choose बटन से भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। ग्राहक का ईमेल Stripe को दिया जाता है, और Stripe पेज पर भुगतान Order # और ऑर्डर नंबर के रूप में दिखता है।

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर को भुगतान किया हुआ तभी चिह्नित किया जाता है जब Stripe उसकी पुष्टि कर दे: या तो signed webhook के ज़रिए, या ग्राहक के लौटने पर Stripe को server-side अनुरोध के ज़रिए। फिर ऑर्डर OpenCart के मानक तरीके से स्थिति पाता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट होते हैं, और ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है। विलंबित भुगतान के लिए पेज पर आपका भुगतान Stripe द्वारा कन्फ़र्म किया जा रहा है। कन्फ़र्म होते ही आपको ईमेल मिलेगा। भी दिखता है। यदि ग्राहक के लौटने पर Stripe ने भुगतान की पुष्टि नहीं की है, तो वही पाठ और Check again बटन वाला एक भुगतान पुष्टि पेज दिखता है; webhook के पहुँचते ही ऑर्डर स्थिति सेट हो जाती है।

यदि ग्राहक Stripe पेज पर रद्द करता है, तो Stripe session बंद हो जाता है और ग्राहक भुगतान रद्द कर दिया गया। आप दोबारा कोशिश कर सकते हैं या कोई दूसरी भुगतान विधि चुन सकते हैं। संदेश के साथ चेकआउट पर लौट आता है। यदि भुगतान पूरा नहीं हुआ या विलंबित भुगतान विफल हुआ, तो संदेश भुगतान पूरा नहीं हुआ। आप दोबारा कोशिश कर सकते हैं या कोई दूसरी भुगतान विधि चुन सकते हैं। होता है। कार्ट सुरक्षित रहता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखते हैं। हर नया प्रयास (OpenCart 3 हर बार Confirm Order चरण दिखने पर नया ऑर्डर बनाता है, OpenCart 4 चेकआउट का ऑर्डर अपडेट करता है) उसी कार्ट के पिछले खुले Stripe sessions बंद कर देता है, इसलिए उसका दोबारा भुगतान नहीं हो सकता। यदि कोई पिछला session पहले से भुगतान किया हुआ निकलता है, तो नया भुगतान शुरू करने के बजाय वही भुगतान कन्फ़र्म होता है। यदि उसी कार्ट का कोई दूसरा ऑर्डर पहले से Stripe से भुगतान किया हुआ है, तो नया भुगतान शुरू नहीं होता और ग्राहक को ऑर्डर सफलता पेज दिखता है। किसी कार्ट में बदलाव, जिसमें नई मात्रा भी शामिल है, एक नए कार्ट के रूप में गिना जाता है जिसे अपना भुगतान चाहिए।

OpenCart 4 ऑर्डर को तब तक चेकआउट में रखता है जब तक सफलता पेज नहीं दिखता। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद हो गया (उदाहरण के लिए उसका विलंबित भुगतान विफल हुआ, या आपने उसे रद्द किया), तो ग्राहक को न चुकाए गए भुगतान के संदेश के साथ चेकआउट पर वापस भेजा जाता है, और अगला Confirm Order एक नए ऑर्डर का भुगतान करता है। कोई भुगतान किया हुआ ऑर्डर किसी अलग कार्ट के लिए भुगतान किया हुआ नहीं दिखाया जाता।

यदि Stripe भुगतान शुरू नहीं कर पाता, तो ग्राहक Confirm Order चरण पर रहता है और बटन के ऊपर एक छोटा संदेश दिखता है, उदाहरण के लिए ऑर्डर की राशि इस मुद्रा में Stripe द्वारा लिए जा सकने वाले न्यूनतम मान से कम है। कृपया कोई दूसरी भुगतान विधि चुनें। तकनीकी कारण लॉग में लिखा जाता है।

स्टोर maintenance mode में होने पर भी webhook काम करता है, क्योंकि OpenCart भुगतान एक्सटेंशन के अनुरोधों को आगे जाने देता है।

एक्सटेंशन केवल कार्ड भुगतान लेता है, जो Stripe पेज पर तुरंत कैप्चर होते हैं। इसमें सेव किए गए कार्ड, सब्सक्रिप्शन या आवर्ती भुगतान नहीं हैं, आपकी साइट पर कार्ड फ़ॉर्म नहीं है, आपकी साइट पर Apple Pay या Google Pay बटन नहीं हैं, और authorize और capture अलग-अलग नहीं होते।

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

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

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

Order Status After Payment (डिफ़ॉल्ट Processing): भुगतान की पुष्टि हुई। एक नोट में Stripe भुगतान (pi_...), session, और पुष्टि का तरीका (webhook या वापसी) दिखते हैं।

Awaiting Payment Status (डिफ़ॉल्ट Pending): ग्राहक ने विलंबित भुगतान विधि से चेकआउट पूरा किया। जब Stripe भुगतान की पुष्टि करता है, तो ऑर्डर Order Status After Payment पर चला जाता है; जब भुगतान विफल होता है, तो Failed Payment Status पर चला जाता है। OpenCart इन बदलावों की सूचना ग्राहक को देता है।

On Hold (Review) Status (डिफ़ॉल्ट Pending): Stripe ने ऑर्डर की कुल राशि या मुद्रा से अलग राशि या मुद्रा बताई, या भुगतान तब आया जब ऑर्डर रद्द हो चुका था या उसकी स्थिति बदल चुकी थी। नोट इसे समझाता है। ऑर्डर की जाँच करें और उसे पूरा करें, या भुगतान रिफ़ंड करें।

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

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

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

VibeFox Stripe Gateway टैब

Sales > Orders में Stripe से भुगतान किया हुआ ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Stripe Gateway टैब Stripe Payment ID दिखाता है (Stripe Dashboard में भुगतान से लिंक), और टेस्ट भुगतानों के लिए Test mode लेबल। साथ में Checkout Session, भुगतान का Status, Paid / refunded राशियाँ, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के Stripe notes भी दिखते हैं। यह टैब उन उपयोगकर्ताओं को दिखता है जिनकी एक्सटेंशन तक पहुँच है।

रिफ़ंड

VibeFox Stripe Gateway टैब में Amount दर्ज करें (जो राशि अभी रिफ़ंड नहीं हुई है, वह अपने-आप भर जाती है), वैकल्पिक रूप से Reason (optional) लिखें, और Refund via Stripe पर क्लिक करें। प्रश्न क्या यह राशि Stripe के माध्यम से रिफ़ंड करनी है? इसे वापस नहीं किया जा सकता। की पुष्टि करें। पूर्ण और आंशिक दोनों रिफ़ंड समर्थित हैं। आपको एक्सटेंशन बदलने का अधिकार चाहिए (System > Users > User Groups में सेट)। रिफ़ंड ऑर्डर के कुल मान में नहीं, बल्कि उसी राशि और मुद्रा में होते हैं जो Stripe ने चार्ज की थी। रिफ़ंड उसी mode (test या live) में भेजा जाता है जिसमें भुगतान हुआ था, इसलिए उस mode की secret key सेट होनी चाहिए। यदि Stripe रिफ़ंड स्वीकार नहीं करता, तो टैब त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड Stripe refund ID के साथ इतिहास और नोट्स में जुड़ता है। पूर्ण रिफ़ंड ऑर्डर को Refunded Status पर सेट करता है, बिना ग्राहक को सूचित किए और बिना उत्पाद स्टॉक में लौटाए, जैसे मैन्युअल स्थिति बदलने पर होता है। आंशिक रिफ़ंड स्थिति नहीं बदलता। रिफ़ंड तभी उपलब्ध होते हैं जब Stripe भुगतान की पुष्टि कर चुका हो।

Sales > Returns में उत्पाद वापसी Stripe के माध्यम से पैसे वापस नहीं भेजती।

Stripe Dashboard में किए गए रिफ़ंड charge.refunded webhook के ज़रिए आते हैं और Stripe में कुल रिफ़ंड की राशि के साथ नोट्स में जुड़ जाते हैं। ऑर्डर की स्थिति अपने-आप नहीं बदलती। ज़रूरत हो तो उसे मैन्युअल रूप से अपडेट करें।

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

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

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

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

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

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

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

Stripe चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और वर्तमान मोड में secret key मौजूद है: test mode में Test Secret Key, live mode में Live Secret Key। key न होने पर सेटिंग्स पेज चेतावनी दिखाता है। यह भी जाँचें कि भुगतान पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स में दिए गए Total तक पहुँचता है।

भुगतान हो गया, पर ऑर्डर बिना स्थिति के है: webhook काम नहीं कर रहा। Stripe Dashboard में जाँचें कि endpoint उस mode (test या live) में मौजूद है जिसका आप उपयोग करते हैं, उसका URL Endpoint URL में दिखाए गए URL से ठीक मेल खाता है, और चारों इवेंट चुने गए हैं। जाँचें कि उस endpoint का signing secret सही फ़ील्ड (Test Webhook Secret या Live Webhook Secret) में है। Stripe Dashboard हर webhook के लिए आपके स्टोर का उत्तर दिखाता है। ग्राहक के भुगतान के बाद स्टोर पर लौटने पर भी ऑर्डर को स्थिति मिल जाती है।

Webhook का उत्तर Webhook secret not configured है: कोई webhook secret सेट नहीं है। signing secret को सेटिंग्स में चिपकाएँ।

Webhook का उत्तर Invalid signature है: signing secret किसी दूसरे endpoint या दूसरे mode का है, या सर्वर की घड़ी गलत है। Stripe signatures केवल सर्वर समय से 5 मिनट के भीतर स्वीकार होते हैं। जब live भुगतान का इवेंट test secret से साइन किया गया हो या उल्टा, तब भी उत्तर Invalid signature होता है: जाँचें कि test और live secrets आपस में बदले तो नहीं गए हैं।

Webhook का उत्तर Busy, retry है: ऑर्डर उसी समय किसी दूसरे अनुरोध से कन्फ़र्म हो रहा था, या ऑर्डर स्थिति सेट नहीं हो सकी। Stripe webhook को अपने-आप दोबारा भेजता है। कारण देखने के लिए Logging चालू करें।

ब्राउज़र में webhook URL Method not allowed दिखाता है: यह सामान्य है। यह URL केवल Stripe के अनुरोध स्वीकार करता है।

सेव करते समय "The value does not look right" चेतावनी: कोई key गलत फ़ील्ड में चिपकाई गई है। Secret keys sk_test_ / rk_test_ या sk_live_ / rk_live_ से शुरू होती हैं, webhook secrets whsec_ से।

ग्राहक Confirm Order के बाद त्रुटि देखता है: Logging चालू करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें। This payment method is not available. Please reload the checkout page. का अर्थ है कि भुगतान session अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान विधि बंद हो गई है: ग्राहक चेकआउट को रीलोड करता है। गलत key पर संदेश आता है कि भुगतान विधि सही तरह कॉन्फ़िगर नहीं है। मुद्रा के Stripe न्यूनतम (उदाहरण के लिए 0.50 EUR) से कम ऑर्डर कुल Stripe से नहीं चुकाया जा सकता।

टेस्ट भुगतान live भुगतान की पुष्टि नहीं करते: टेस्ट और live भुगतान अलग रखे जाते हैं। Test Mode को वांछित mode पर बदलें और उस mode की keys और webhook का उपयोग करें।

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

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

मोड से संबंधित संदेश के साथ रिफ़ंड विफल: भुगतान test या live mode में हुआ था, और उस mode की secret key सेट नहीं है। उसे दर्ज करें और फिर प्रयास करें।

डेवलपर्स के लिए: Stripe session बनने से पहले एक्सटेंशन session parameters और ऑर्डर के साथ OpenCart इवेंट strg_checkout_session_params ट्रिगर करता है।

अनइंस्टॉल

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

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

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