VibeFox Razorpay for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

PHP: 8.0 या उसके बाद का संस्करण। मॉड्यूल पुराने PHP संस्करणों पर इंस्टॉल नहीं होगा।

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

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

इंस्टॉलेशन

1. बैक ऑफ़िस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।

2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox Razorpay Payment खोजकर Configure पर क्लिक करें।

3. Configure पेज के शीर्ष पर लाइसेंस ब्लॉक में License key में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।

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

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

इंस्टॉल करते समय मॉड्यूल दो ऑर्डर स्थितियाँ बनाता है: Razorpay payment authorized और Razorpay payment on hold। PrestaShop सभी मुद्राओं, देशों और ग्राहक समूहों के लिए एक नया भुगतान मॉड्यूल देता है। आप इन्हें Payment > Preferences में सीमित कर सकते हैं।

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

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

Razorpay

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

Title: वह भुगतान तरीके का नाम जो ग्राहक चेकआउट पर देखते हैं। यही नाम ऑर्डर में भी सहेजा जाता है। डिफ़ॉल्ट: UPI, Cards, NetBanking। अनिवार्य: खाली शीर्षक दिए जाने पर Enter a title for the payment method. त्रुटि आती है।

Description: चेकआउट पर भुगतान तरीके के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely via UPI, Credit/Debit Card, or Internet Banking through Razorpay.

API कुंजियाँ

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

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

Test Key ID: Razorpay Dashboard में टेस्ट मोड की Key ID। यह rzp_test_ से शुरू होती है।

Test Key Secret: Razorpay Dashboard में टेस्ट मोड की Key Secret।

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

Live Key Secret: Razorpay Dashboard में लाइव मोड की Key Secret।

सहेजे गए secret फिर कभी नहीं दिखाए जाते। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल तभी नया मान दर्ज करें जब उसे बदलना हो।

सहेजे गए secret हटाएँ: Test Key Secret, Live Key Secret या Webhook Secret पर टिक करें और उसे हटाने के लिए Save पर क्लिक करें। खाली फ़ील्ड सहेजा गया मान बनाए रखता है।

भुगतान

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

Authorize & Capture: ग्राहक से तुरंत शुल्क लिया जाता है। यदि Razorpay अधिकृत भुगतान की सूचना देता है, तो मॉड्यूल उसे कैप्चर करता है।

Authorize Only: राशि रोकी जाती है। ऑर्डर Razorpay payment authorized स्थिति में बनता है, और आप भुगतान बाद में ऑर्डर पेज के Razorpay ब्लॉक में Capture Razorpay payment से या Razorpay Dashboard में कैप्चर करते हैं। समय पर कैप्चर न हुए अधिकृत भुगतानों को Razorpay अपने-आप रिफ़ंड कर देता है।

Webhook

वेबहुक भुगतान की पुष्टि करता है, भले ही ग्राहक भुगतान के तुरंत बाद ब्राउज़र बंद कर दे, और Razorpay Dashboard में किए गए रिफ़ंड दर्ज करता है। Razorpay Dashboard में Account & Settings > Webhooks पर जाएँ और टेस्ट मोड के लिए एक वेबहुक तथा लाइव मोड के लिए एक और वेबहुक जोड़ें। इस खंड में Webhook URL पर दिखने वाला URL उपयोग करें। फ़्रेंडली URL चालू होने पर यह कुछ इस तरह दिखता है: https://your-shop/module/wcp_razorpay_payment/webhook, जिसके आगे /en/ जैसा भाषा कोड भी हो सकता है। इसे ठीक उसी तरह कॉपी करें जैसा सेटिंग्स में दिखता है। Razorpay में अपनी पसंद का secret दर्ज करें और ये इवेंट चुनें (ये इस खंड में भी सूचीबद्ध हैं):

payment.authorized: एक भुगतान अधिकृत हुआ।

payment.captured: एक भुगतान कैप्चर हुआ, जिसमें Razorpay Dashboard में कैप्चर करना भी शामिल है।

payment.failed: भुगतान का एक प्रयास विफल हुआ।

order.paid: भुगतान का Razorpay ऑर्डर भुगतान हो गया।

refund.created: एक भुगतान का रिफ़ंड हुआ, उदाहरण के लिए Razorpay Dashboard में।

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

उन्नत

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

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

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

चेकआउट

भुगतान चरण में ग्राहक भुगतान तरीका चुनता है (डिफ़ॉल्ट रूप से UPI, Cards, NetBanking) और पुष्टि करता है। मॉड्यूल कार्ट के सटीक कुल और मुद्रा के लिए एक Razorpay ऑर्डर बनाता है और आपके स्टोर का Razorpay payment पेज खोलता है। Razorpay Checkout पॉपअप उस पेज पर अपने-आप खुलता है, जिसमें ग्राहक का नाम, ईमेल और फ़ोन पहले से भरे होते हैं। Razorpay में भुगतान Cart और कार्ट नंबर के साथ दिखता है। इस चरण पर अभी कोई PrestaShop ऑर्डर मौजूद नहीं होता। यदि पॉपअप बंद हो जाए, तो ग्राहक इसे दोबारा खोलने के लिए Pay Now पर क्लिक कर सकता है, या चेकआउट पर लौटने के लिए Choose another payment method पर। कार्ट सुरक्षित रहता है। टेस्ट मोड में पेज Razorpay Test mode: no real money will be charged. दिखाता है।

सफल भुगतान के बाद ग्राहक को Please wait while we process your payment... दिखता है। मॉड्यूल Razorpay हस्ताक्षर की जाँच करता है, Razorpay API से भुगतान प्राप्त करता है, और राशि तथा मुद्रा की तुलना कार्ट से करता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Razorpay पुष्टि करे। इसके बाद ऑर्डर बनता है और ग्राहक को मानक ऑर्डर पुष्टि पेज दिखता है। यदि हस्ताक्षर वैध है, पर उसी समय भुगतान प्राप्त नहीं किया जा सकता, तो ऑर्डर Razorpay payment on hold में बनता है और वेबहुक बाद में उसकी पुष्टि करता है।

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

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

Your session has expired. Please click "Pay Now" to try again.

We could not verify your payment. संदेश जोड़ता है कि यदि राशि काटी गई है, तो Razorpay की पुष्टि होते ही ऑर्डर अपने-आप अपडेट हो जाएगा।

This payment method is not available right now. Please choose another payment method. कुंजियाँ गायब हैं या गलत हैं।

Razorpay is temporarily unavailable. Please try again in a few minutes.

Razorpay could not accept this payment: इसके बाद Razorpay द्वारा बताया गया कारण आता है।

The order amount is too small to be paid with Razorpay.

Razorpay Checkout could not be loaded. पॉपअप स्क्रिप्ट अवरुद्ध है; संदेश कनेक्शन जाँचने, कंटेंट ब्लॉकर बंद करने और पेज दोबारा लोड करने को कहता है।

वेबहुक तब भी काम करता है जब स्टोर मेंटेनेंस मोड में हो, और आपके स्टोर के देश-प्रतिबंध से अवरुद्ध नहीं होता।

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

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

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

No order yet: ग्राहक ने भुगतान नहीं किया है, या Razorpay ने अभी भुगतान की पुष्टि नहीं की है। केवल कार्ट मौजूद है। विफल भुगतान प्रयास से ऑर्डर नहीं बनता; ग्राहक फिर से भुगतान कर सकता है।

Payment accepted: भुगतान कैप्चर और पुष्ट हो गया। भुगतान को Razorpay भुगतान ID (pay_...) के साथ लेनदेन ID के रूप में दर्ज किया जाता है, और एक नोट भुगतान ID, राशि और पुष्टि के तरीके (callback, webhook, sync या admin) को दिखाता है।

Razorpay payment authorized: भुगतान केवल अधिकृत हुआ है (Authorize Only)। ऑर्डर पूरा करने के लिए उसे कैप्चर करें।

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

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

Refunded: भुगतान पूरी तरह रिफ़ंड हो गया।

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

Razorpay भुगतान ब्लॉक

ऑर्डर पेज पर एक Razorpay payment ब्लॉक दिखता है, जिसमें Razorpay भुगतान ID, Razorpay ऑर्डर, भुगतान स्थिति, Paid / refunded (Razorpay द्वारा काटी गई राशि और रिफ़ंड की गई राशि), टेस्ट भुगतानों के लिए Test mode बैज, रिफ़ंड का इतिहास और ऑर्डर के Razorpay notes शामिल हैं। कैप्चर और रिफ़ंड के लिए ऑर्डर संपादित करने का अधिकार चाहिए; मॉड्यूल कॉन्फ़िगरेशन तक पहुँच की आवश्यकता नहीं है।

कैप्चर (Authorize Only)

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

रिफ़ंड

Razorpay ब्लॉक में राशि दर्ज करें (जो राशि अभी रिफ़ंड नहीं हुई है, वह पहले से भरी होती है), वैकल्पिक रूप से कारण लिखें, और 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 पर सेट करता है। आंशिक रिफ़ंड स्थिति नहीं बदलता। रिफ़ंड तब उपलब्ध होते हैं जब भुगतान कैप्चर हो चुका हो।

मॉड्यूल क्रेडिट स्लिप नहीं बनाता। ऑर्डर पेज पर PrestaShop के मानक रिफ़ंड बटन Razorpay के माध्यम से पैसे वापस नहीं भेजते।

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

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

मॉड्यूल vibefox.net से प्राप्त VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Razorpay Payment, Modules > Module Manager > VibeFox Razorpay Payment > Configure पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी License key में डालें और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को मास्क करके दिखाता है, साथ में स्थिति (जैसे वह तारीख जब तक लाइसेंस सक्रिय है, और आपका डोमेन) और ये बटन: स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी डालने के लिए Change key, और इस शॉप से कुंजी हटाने के लिए Remove key। इनके नीचे Product: presta-payment-razorpay की पंक्ति और Manage licenses and domains in your account लिंक है, जो आपका vibefox.net खाता खोलता है। केवल वे कर्मचारी जिनके पास मॉड्यूल की Configure अनुमति है, कुंजी बदल सकते हैं। ब्लॉक के पाठ बैक ऑफ़िस की भाषा के अनुसार दिखते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

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

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

सक्रिय कुंजी के बिना चेकआउट पर ग्राहकों को Razorpay नहीं दिखाया जाता। फिर भी भुगतान शुरू हो, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। PrestaShop स्टोरफ़्रंट नहीं जानता कि आप बैक ऑफ़िस में लॉगिन हैं, इसलिए भुगतान विकल्प आपसे भी छिपा रहता है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, पर चेकआउट पर उसे टेस्ट नहीं कर सकते। Modules > Module Manager में Alerts टैब पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं, उनकी पुष्टि अब भी होती है, और कैप्चर व रिफ़ंड भी काम करते हैं।

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

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

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

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

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

वेबहुक का उत्तर Invalid signature या Missing signature है: सेटिंग्स का secret Razorpay वेबहुक के secret से अलग है। टेस्ट और लाइव वेबहुक, दोनों के लिए दोनों जगह एक ही secret दर्ज करें।

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

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

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

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

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

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

अनइंस्टॉल

Modules > Module Manager पर जाएँ, VibeFox Razorpay Payment के बगल वाला मेनू खोलें और Uninstall चुनें। इस मॉड्यूल की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती हैं। यदि Delete Data on Uninstall चालू है, तो मॉड्यूल की सेटिंग्स और लॉग हट जाते हैं। यदि बंद है, तो बाद में दोबारा इंस्टॉल करने के लिए सभी सेटिंग्स रखी जाती हैं। Razorpay लेनदेन और रिफ़ंड, तथा ऑर्डर स्थितियाँ Razorpay payment authorized और Razorpay payment on hold हमेशा रखी जाती हैं, ताकि पहले भुगतान किए गए ऑर्डर दोबारा इंस्टॉल करने के बाद भी कैप्चर और रिफ़ंड किए जा सकें। मौजूदा ऑर्डर अपने भुगतान नोट और लेनदेन ID रखते हैं।

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