VibeFox Razorpay for OpenCart — सहायता

आवश्यकताएँ

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

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

Razorpay खाता: टेस्ट मोड के लिए आपके Razorpay खाते का Key ID और Key Secret चाहिए, और लाइव मोड के लिए, खाता सक्रिय होने के बाद। आपकी पसंद के सीक्रेट वाला webhook बनाने की दृढ़ता से अनुशंसा की जाती है (कॉन्फ़िगरेशन देखें)। INR के अलावा किसी अन्य मुद्रा में भुगतान के लिए आपके Razorpay खाते में International Payments सक्षम होना चाहिए।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. अपना Test Key ID और Test Key Secret दर्ज करें, Razorpay Dashboard में webhook सेट करें और उसका सीक्रेट दर्ज करें (कॉन्फ़िगरेशन देखें)।

5. Enable/Disable चालू करें और Save पर क्लिक करें। Test mode चालू रखते हुए एक टेस्ट भुगतान करें। तैयार होने पर Live कुंजियाँ दर्ज करें और Test mode बंद करें।

OpenCart 4

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

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

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

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

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Razorpay Payment > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। एक्सटेंशन में बदलाव करने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

सेटिंग्स के ऊपर पेज बताता है कि भुगतान की पुष्टि Razorpay के साथ होने के बाद ही ऑर्डर को स्थिति मिलती है, और चेतावनियाँ दिखाता है: वर्तमान मोड की कुंजियाँ गायब हैं (तब चेकआउट पर Razorpay नहीं दिखाया जाता), टेस्ट मोड में Key ID rzp_test_ से या लाइव मोड में rzp_live_ से शुरू नहीं होता, टेस्ट मोड चालू है, webhook सीक्रेट खाली है, या स्टोर की डिफ़ॉल्ट मुद्रा INR नहीं है और आपके Razorpay खाते में International Payments की ज़रूरत है। हर सेव के बाद चेतावनियाँ अपडेट होती हैं।

सेव करते समय Title 1 से 128 अक्षरों का होना चाहिए (Enter a title for the payment method (1 to 128 characters).), Sort Order पूर्ण संख्या होनी चाहिए (ऋणात्मक संख्याएँ मान्य हैं), Total 0 या उससे बड़ी संख्या होनी चाहिए, और जियो ज़ोन तथा हर ऑर्डर स्थिति मौजूद होनी चाहिए। अन्यथा कुछ भी सेव नहीं होता। Key ID के साथ चिपकाए गए स्पेस हटा दिए जाते हैं।

Razorpay

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

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

Description: ग्राहक को Confirm Order चरण में, कन्फ़र्म बटन के ऊपर दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely via UPI, Credit/Debit Card, or Internet Banking through Razorpay।

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

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

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

API कुंजियाँ

अपनी कुंजियाँ Razorpay Dashboard में Account & Settings > API Keys के अंतर्गत प्राप्त करें (पेज वहाँ का लिंक देता है)। टेस्ट कुंजियाँ (rzp_test_...) बनाने के लिए Dashboard को Test मोड में बदलें। लाइव कुंजियाँ (rzp_live_...) खाता सक्रिय होने के बाद उपलब्ध होती हैं।

Test mode: टेस्ट मोड की कुंजियों का उपयोग करता है, इसलिए कोई असली पैसा नहीं काटा जाता। डिफ़ॉल्ट: चालू। असली भुगतान लेने के लिए इसे बंद करें। किसी ऑर्डर के भुगतान, कैप्चर और रिफ़ंड हमेशा उसी मोड की कुंजियों से होते हैं जिसमें ऑर्डर का भुगतान हुआ था, इसलिए बाद में मोड बदलने से मौजूदा ऑर्डर प्रभावित नहीं होते। चालू रहने पर ग्राहक Confirm Order चरण और भुगतान पेज पर Razorpay Test mode: no real money will be charged. देखते हैं।

Test Key ID: Test मोड में Razorpay Dashboard से मिला Key ID। यह rzp_test_ से शुरू होता है।

Test Key Secret: Test मोड में Razorpay Dashboard से मिला Key Secret।

Live Key ID: Live मोड में Razorpay Dashboard से मिला Key ID। यह rzp_live_ से शुरू होता है।

Live Key Secret: Live मोड में Razorpay Dashboard से मिला Key Secret।

सहेजे गए सीक्रेट फिर कभी नहीं दिखाए जाते। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलना हो तो ही नया मान दर्ज करें। सहेजा हुआ मान हटाने के लिए फ़ील्ड के नीचे Clear the saved value on save पर टिक करें और Save पर क्लिक करें।

भुगतान

Payment Action: पैसा कब काटा जाए। डिफ़ॉल्ट: Authorize & Capture।

Webhook

Webhook तब भी भुगतान की पुष्टि करता है जब ग्राहक भुगतान के तुरंत बाद ब्राउज़र बंद कर दे, और Razorpay Dashboard में किए गए रिफ़ंड दर्ज करता है। Razorpay Dashboard में Account & Settings > Webhooks पर जाएँ और Test मोड में एक webhook तथा Live मोड में एक और webhook जोड़ें। इस सेक्शन में Webhook URL के नीचे दिखाए गए URL का उपयोग करें। OpenCart 3 पर यह कुछ इस तरह दिखता है: https://your-store/index.php?route=extension/payment/wcp_razorpay_payment/webhook, और OpenCart 4 पर: https://your-store/index.php?route=extension/wcp_razorpay_payment/payment/wcp_razorpay_payment.webhook। यह आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। इसे ठीक वैसे ही कॉपी करें जैसा सेटिंग्स दिखाती हैं। Razorpay में अपनी पसंद का सीक्रेट दर्ज करें और ये इवेंट चुनें (ये इस सेक्शन में भी सूचीबद्ध हैं):

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

ऑर्डर

OpenCart Confirm Order चरण पर बिना स्थिति के ऑर्डर बनाता है (लापता ऑर्डर)। ऑर्डर को स्थिति तभी मिलती है जब Razorpay भुगतान की पुष्टि कर देता है। विफल या छोड़ा गया भुगतान ऑर्डर को बिना स्थिति के छोड़ देता है, और कार्ट बना रहता है। OpenCart में Authorized और On hold स्थितियाँ नहीं हैं, इसलिए आप मौजूदा स्थितियों में से चुनते हैं; कारण ऑर्डर नोट्स में समझाया जाता है। नीचे का हर फ़ील्ड आपकी OpenCart ऑर्डर स्थितियाँ सूचीबद्ध करता है।

Order Status After Payment: भुगतान कैप्चर हो गया है और राशि और मुद्रा मेल खाती हैं। डिफ़ॉल्ट: प्रसंस्करण में।

Authorized Status: Authorize Only: पैसा रोका गया है, अभी कैप्चर नहीं हुआ। डिफ़ॉल्ट: लंबित।

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

Cancelled Status: एक्सटेंशन यह स्थिति कभी सेट नहीं करता। यह बस एक्सटेंशन को बताता है कि कौन से ऑर्डर रद्द हैं: ऐसे ऑर्डर के लिए बाद में कैप्चर किया गया भुगतान उसे दोबारा खोलने के बजाय समीक्षा में डालता है; अधिकृत भुगतान केवल एक नोट जोड़ता है। डिफ़ॉल्ट: रद्द।

Refunded Status: भुगतान पूरी तरह रिफ़ंड होने के बाद सेट होता है, ऑर्डर टैब से या Razorpay Dashboard में। डिफ़ॉल्ट: वापस किया गया।

उन्नत

Enable Logging: लॉग OpenCart के लॉग फ़ोल्डर (storage/logs) में razorpay_p_debug.log.php में लिखा जाता है। यह फ़ाइल वेब से नहीं खोली जा सकती। त्रुटियाँ और चेतावनियाँ हमेशा लॉग होती हैं; यह विकल्प डीबग विवरण जोड़ता है। कुंजियाँ, सिग्नेचर और ग्राहक का संपर्क डेटा कभी लॉग नहीं होता। डिफ़ॉल्ट: बंद।

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

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

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

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

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

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से UPI, Cards, NetBanking)। Confirm Order चरण पर ग्राहक आपका विवरण और यह नोट देखता है: After "Confirm Order" the Razorpay Checkout window opens to pay securely (UPI, cards, NetBanking, wallets). OpenCart इसी चरण पर ऑर्डर बनाता है, अभी भी बिना स्थिति के। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर की सटीक राशि और मुद्रा के लिए Razorpay ऑर्डर बनाता है और आपके स्टोर का Razorpay payment पेज खोलता है। वहाँ Razorpay Checkout पॉपअप अपने-आप खुलता है, और ग्राहक का नाम, ईमेल और फ़ोन पहले से भरे होते हैं। OpenCart 4 पर ग्राहक Payment method options विंडो में, भुगतान विधि ब्लॉक के Choose बटन से भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। Razorpay में भुगतान Order # और ऑर्डर नंबर के रूप में दिखता है। यदि पॉपअप बंद हो जाए, तो ग्राहक उसे फिर से खोलने के लिए Pay Now पर, या चेकआउट पर लौटने के लिए Choose another payment method पर क्लिक कर सकता है। कार्ट बना रहता है।

सफल भुगतान के बाद ग्राहक को Please wait while we process your payment... दिखता है। एक्सटेंशन Razorpay सिग्नेचर जाँचता है, Razorpay API से भुगतान लाता है और राशि व मुद्रा की ऑर्डर से तुलना करता है। ऑर्डर तभी भुगतान किया हुआ माना जाता है जब Razorpay पुष्टि कर दे। उसके बाद ऑर्डर को OpenCart के सामान्य तरीके से स्थिति मिलती है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट होते हैं, और ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है। यदि सिग्नेचर वैध है पर उस समय भुगतान नहीं मिल सकता, तो ऑर्डर को On Hold (Review) Status मिलता है और webhook उसे बाद में पक्का करता है।

OpenCart 3 हर बार Confirm Order चरण दिखने पर नया ऑर्डर बनाता है। OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसी को अपडेट करता है, इसलिए पॉपअप बंद होने या Choose another payment method के बाद ग्राहक वही ऑर्डर चुकाता है। नया भुगतान शुरू होने से पहले एक्सटेंशन उसी कार्ट के खुले Razorpay ऑर्डर जाँचता है: जो पहले से भुगतान हो चुका है (उदाहरण के लिए ग्राहक ने ब्राउज़र बंद किया और webhook नहीं है), उसे दूसरा भुगतान माँगने के बजाय लागू किया जाता है, और बाकी अब नहीं दिए जाते। यदि ग्राहक वही ऑर्डर फिर से भुगतान करता है, तो राशि, मुद्रा और मोड न बदलने पर उसका Razorpay ऑर्डर फिर से इस्तेमाल होता है; अन्यथा नया बनता है। यदि कार्ट पहले ही किसी दूसरे ऑर्डर से भुगतान हो चुका है, तो ग्राहक सीधे सफलता पेज पर पहुँच जाता है।

ग्राहक को दिखने वाले संदेश:

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

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

यह एक्सटेंशन केवल एकल भुगतान लेता है। इसमें सदस्यता या आवर्ती भुगतान, सेव किए गए कार्ड, Razorpay Magic Checkout, Payment Links या Route (विभाजित भुगतान), और ऑफ़र या किस्त विजेट नहीं हैं।

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

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

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

Order Status After Payment (डिफ़ॉल्ट प्रसंस्करण में): भुगतान कैप्चर और पुष्ट हो गया है। एक नोट में Razorpay भुगतान ID (pay_...), राशि और पुष्टि का तरीका (callback, webhook, sync या admin) दिखता है।

Authorized Status (डिफ़ॉल्ट लंबित): भुगतान केवल अधिकृत हुआ है (Authorize Only)। ऑर्डर पूरा करने के लिए इसे कैप्चर करें।

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

Cancelled Status: रद्द ऑर्डर के लिए बाद में आने वाला भुगतान उसे अपने-आप दोबारा नहीं खोलता: अधिकृत भुगतान कैप्चर नहीं होता और केवल एक नोट पाता है, और कैप्चर किया गया भुगतान ऑर्डर को समीक्षा में डालता है। जिस भुगतान ने ऑर्डर पहले ही पूरा कर दिया था, उसकी दोहराई गई सूचना कुछ नहीं बदलती, भले ही आपने बाद में ऑर्डर रद्द कर दिया हो।

Refunded Status (डिफ़ॉल्ट वापस किया गया): भुगतान पूरी तरह रिफ़ंड हो गया है।

यदि पहले से भुगतान किए गए ऑर्डर के लिए कोई अतिरिक्त भुगतान आता है, तो ऑर्डर नहीं बदलता। यदि यह जानबूझकर नहीं था, तो एक नोट आपसे उसे Razorpay Dashboard में रिफ़ंड करने को कहता है। भुगतान हो चुकी कार्ट के किसी पुराने ऑर्डर के लिए देर से आया भुगतान उस पुराने ऑर्डर को बिना स्थिति के छोड़ता है, और भुगतान किए गए ऑर्डर को नोट मिलता है। भुगतान किए गए ऑर्डर के लिए देर से आया payment.failed केवल एक नोट जोड़ता है।

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

VibeFox Razorpay Payment टैब

Sales > Orders में Razorpay से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Razorpay Payment टैब परीक्षण भुगतानों के लिए Test mode लेबल के साथ Payment ID, Razorpay order, भुगतान की Status, Paid / refunded (Razorpay द्वारा काटी गई राशि और रिफ़ंड की गई राशि), कैप्चर बटन, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के Razorpay notes दिखाता है। यह टैब उन उपयोगकर्ताओं को दिखता है जिनके पास एक्सटेंशन की पहुँच है। कैप्चर और रिफ़ंड के लिए एक्सटेंशन में बदलाव करने का अधिकार चाहिए (System > Users > User Groups में सेट)।

कैप्चर (Authorize Only)

ऑर्डर को Authorized Status में खोलें, टैब में Capture Razorpay payment पर क्लिक करें और Capture the authorized Razorpay payment? की पुष्टि करें। भुगतान उसी मोड में कैप्चर होता है जिसमें वह अधिकृत हुआ था, और ऑर्डर को Order Status After Payment पर सेट किया जाता है, बिना ग्राहक को सूचित किए और बिना स्टॉक बदले, जैसे मैन्युअल स्थिति बदलने पर होता है। यदि Razorpay मना कर दे, तो टैब और नोट्स कारण सहित Razorpay capture failed: दिखाते हैं। Razorpay Dashboard में किया गया कैप्चर webhook के ज़रिए ऑर्डर पूरा करता है।

रिफ़ंड

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

Sales > Returns में उत्पाद वापसी Razorpay के ज़रिए पैसे वापस नहीं भेजती।

Razorpay Dashboard में किए गए रिफ़ंड webhook से आते हैं और रिफ़ंड इतिहास (Razorpay Dashboard के रूप में चिह्नित) तथा नोट्स में एक बार दर्ज होते हैं। जब ऑर्डर पूरी तरह रिफ़ंड हो जाता है, तो उसकी स्थिति Refunded Status बन जाती है। किसी दूसरी मुद्रा में या रिफ़ंड योग्य राशि से अधिक का Dashboard रिफ़ंड अपने-आप दर्ज नहीं होता; एक नोट आपसे उसे मैन्युअल रूप से दर्ज करने को कहता है।

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

यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। License — VibeFox Razorpay Payment लाइसेंस ब्लॉक Extensions > Extensions > Payments > VibeFox Razorpay Payment > Edit पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को मास्क करके, स्थिति (जैसे वह तारीख जब तक लाइसेंस सक्रिय है और आपका डोमेन) और ये बटन दिखाता है: स्थिति फिर से जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: opencart-payment-razorpay की पंक्ति और 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 खाते में स्लॉट खाली करें।

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

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

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

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

भुगतान हो गया, पर ऑर्डर बिना स्थिति के रहा: webhook काम नहीं कर रहा। Razorpay Dashboard में जाँचें कि आपके उपयोग वाले मोड (Test या Live) में webhook मौजूद है, उसका URL Webhook URL में दिखाए गए URL से बिल्कुल मेल खाता है, और पाँचों इवेंट चुने गए हैं। जाँचें कि Webhook Secret Razorpay के सीक्रेट के समान है। ग्राहक के पॉपअप से लौटने पर, या उसी कार्ट का भुगतान फिर से शुरू करने पर भी ऑर्डर को स्थिति मिलती है।

Webhook का उत्तर Webhook secret not configured: Webhook Secret खाली है। Razorpay webhook का सीक्रेट दर्ज करें। Razorpay बाद में वह इवेंट फिर भेजेगा।

Webhook का उत्तर Invalid signature या Missing signature: सेटिंग्स का सीक्रेट Razorpay webhook के सीक्रेट से अलग है। Test और Live webhook के लिए दोनों जगह एक ही सीक्रेट दर्ज करें।

Webhook का उत्तर Retry later: एक्सटेंशन Razorpay API से कैप्चर की पुष्टि नहीं कर सका, ऑर्डर की स्थिति सेट नहीं हो सकी, या उसी समय कार्ट को किसी दूसरे अनुरोध द्वारा अपडेट किया जा रहा था। Razorpay इवेंट अपने-आप फिर भेजता है। कारण Log में है।

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

ऑर्डर समीक्षा स्थिति में है: VibeFox Razorpay Payment टैब के नोट्स पढ़ें। राशि या मुद्रा ऑर्डर से मेल नहीं खाई, भुगतान रद्द ऑर्डर के लिए आया, या उस समय Razorpay API से सत्यापित नहीं हो सका और webhook की प्रतीक्षा है।

भुगतान के समय ग्राहक को त्रुटि दिखती है: एक्सटेंशन पेज पर Log फ़ील्ड देखें। Enable Logging बंद होने पर भी त्रुटियाँ लॉग होती हैं। गलत कुंजियों पर यह संदेश आता है कि भुगतान विधि अभी उपलब्ध नहीं है। Razorpay के अन्य कारण Razorpay could not accept this payment: के बाद दिखाए जाते हैं।

पॉपअप नहीं खुलता: Razorpay Checkout स्क्रिप्ट को कंटेंट ब्लॉकर या कनेक्शन ने रोक दिया। ग्राहक को एक संदेश दिखता है और वह पेज रीलोड कर सकता है।

टैब में कैप्चर या रिफ़ंड फ़ॉर्म नहीं है: टैब कारण बताता है: भुगतान अभी कैप्चर नहीं हुआ, वह पूरी तरह रिफ़ंड हो चुका है, आपके उपयोगकर्ता समूह के पास एक्सटेंशन बदलने का अधिकार नहीं है, या जिस मोड में भुगतान हुआ था उसकी कुंजियाँ सेट नहीं हैं (The payment was made in Test mode, but the Test Key ID / Key Secret are not configured. या Live मोड के लिए वही संदेश)। उस मोड की कुंजियाँ दर्ज करें और फिर कोशिश करें।

अनइंस्टॉल

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

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

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