VibeFox CorvusPay for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

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

मुद्रा: AUD, BAM, BHD, CAD, CHF, CZK, DKK, EUR, GBP, HRK, HUF, ISK, MKD, NOK, PLN, RON, RSD, RUB, SEK या USD। किसी अन्य कार्ट मुद्रा में चेकआउट पर यह भुगतान विधि नहीं दिखती। राशियाँ 2 दशमलव स्थानों के साथ भेजी जाती हैं; अधिक दशमलव वाला कुल योग (जैसे 3 दशमलव वाली BHD कीमतों वाले स्टोर में) गोल करने के बजाय अस्वीकार कर दिया जाता है।

CorvusPay खाता: आपको एक CorvusPay मर्चेंट खाते की आवश्यकता है। CorvusPay हर स्टोर के लिए Store ID और Secret Key जारी करता है, टेस्ट और प्रोडक्शन स्टोर के लिए अलग-अलग; ये CorvusPay Merchant Center में दिखते हैं। मॉड्यूल का Success URL और Cancel URL वहीं दर्ज करने होंगे (देखें कॉन्फ़िगरेशन)।

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

इंस्टॉलेशन

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

2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox CorvusPay Gateway ढूँढकर Configure पर क्लिक करें।

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

4. अपने CorvusPay टेस्ट स्टोर का Store ID और Secret Key दर्ज करें (और वास्तविक भुगतान के लिए प्रोडक्शन स्टोर के)। Configure पेज पर दिखाए गए Success URL और Cancel URL को टेस्ट और प्रोडक्शन, दोनों स्टोर के लिए CorvusPay Merchant Center में कॉपी करें।

5. Enable/Disable चालू करें और Save पर क्लिक करें। एक टेस्ट ऑर्डर दें, फिर लाइव जाने के लिए Test Mode बंद करें।

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

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

सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox CorvusPay Gateway > Configure। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सहेजता है। जब टेस्ट मोड चालू हो, तब फ़ील्ड के ऊपर पेज यह संदेश दिखाता है: टेस्ट मोड चालू है। भुगतान CorvusPay टेस्ट वातावरण में जाते हैं — कोई वास्तविक राशि नहीं ली जाती। यह चेतावनी भी देता है जब गेटवे सक्रिय हो पर मौजूदा मोड का Store ID या Secret Key खाली हो (तब वह भरे जाने तक चेकआउट पर छिपा रहता है), और जब आपके स्टोर की डिफ़ॉल्ट मुद्रा CorvusPay द्वारा समर्थित न हो।

CorvusPay

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

Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखते हैं। यही नाम ऑर्डर में भुगतान विधि के रूप में भी सहेजा जाता है। डिफ़ॉल्ट: Credit/Debit Card (CorvusPay)।

Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely with your credit or debit card via CorvusPay। टेस्ट मोड में इसके साथ (टेस्ट मोड — कोई वास्तविक भुगतान नहीं लिया जाता।) जोड़ा जाता है।

स्टोर क्रेडेंशियल्स

Store ID और Secret Key CorvusPay हर स्टोर के लिए (टेस्ट और प्रोडक्शन अलग-अलग) जारी करता है और ये CorvusPay Merchant Center में दिखते हैं।

Test Mode: CorvusPay टेस्ट वातावरण (wallet.test.corvuspay.com) और टेस्ट Store ID तथा टेस्ट Secret Key का उपयोग करता है। डिफ़ॉल्ट: चालू। wallet.corvuspay.com पर वास्तविक भुगतान लेने के लिए इसे बंद करें।

Test Store ID: आपके CorvusPay टेस्ट स्टोर का संख्यात्मक Store ID।

Test Secret Key: आपके CorvusPay टेस्ट स्टोर की Secret Key, जो HMAC-SHA256 हस्ताक्षरों के लिए उपयोग होती है।

Live Store ID: आपके CorvusPay प्रोडक्शन स्टोर का संख्यात्मक Store ID।

Live Secret Key: आपके CorvusPay प्रोडक्शन स्टोर की Secret Key, जो HMAC-SHA256 हस्ताक्षरों के लिए उपयोग होती है।

Clear saved secrets: Test Secret Key या Live Secret Key पर टिक करें और हटाने के लिए Save पर क्लिक करें।

Store ID में केवल अंक होने चाहिए। यदि आप कुछ और दर्ज करते हैं, तो पेज … में केवल अंक होने चाहिए — पिछला मान रखा गया। दिखाता है, और बाकी फ़ील्ड फिर भी सहेजे जाते हैं। सहेजी गई Secret Key दोबारा नहीं दिखाई जाती: फ़ील्ड खाली रहता है और सहेजा गया — रखने के लिए खाली छोड़ें। दिखाता है। नया मान केवल तभी डालें जब उसे बदलना हो। भुगतान हमेशा उसी स्टोर की Secret Key से सत्यापित होता है जिसमें वह शुरू हुआ था, इसलिए जब तक टेस्ट भुगतान वापस आ सकते हों, टेस्ट कुंजी भरी रखें।

Success URL और Cancel URL

इस सेक्शन में दिखाए गए दोनों पते टेस्ट और प्रोडक्शन, दोनों स्टोर के लिए CorvusPay Merchant Center में कॉपी करें। भुगतान के बाद CorvusPay ग्राहक को इन्हीं पतों पर वापस भेजता है। इन्हें पेज पर दिखाए गए रूप में ही हूबहू कॉपी करें; फ़्रेंडली URL के साथ ये नीचे दिए उदाहरणों जैसे दिखते हैं, संभवतः /en/ जैसे भाषा कोड के साथ।

भुगतान

Transaction Type: कार्ड से राशि कैसे ली जाती है।

Payment Page Language: CorvusPay भुगतान पेज की भाषा। Site language (डिफ़ॉल्ट) CorvusPay द्वारा समर्थित होने पर आपके स्टोर की वर्तमान भाषा का उपयोग करता है, अन्यथा अंग्रेज़ी। आप Hrvatski, English, Deutsch, Italiano, Srpski या Slovenščina भी चुन सकते हैं।

Order Status After Payment: सफल Sale भुगतान के बाद ऑर्डर की स्थिति। ऑर्डर सीधे इसी स्थिति में बनता है।

एडवांस्ड

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

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

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

चेकआउट

भुगतान के चरण में ग्राहक भुगतान विधि (डिफ़ॉल्ट रूप से Credit/Debit Card (CorvusPay)) चुनता है और पुष्टि करता है। अगला पेज CorvusPay पर भुगतान के लिए भेजा जा रहा है। कृपया प्रतीक्षा करें... दिखाता है और हस्ताक्षरित फ़ॉर्म CorvusPay भुगतान पेज पर भेजता है। यदि रीडायरेक्ट शुरू न हो, तो ग्राहक Pay via CorvusPay पर क्लिक करता है; Back to checkout चेकआउट पर वापस ले जाता है। कार्ट का कुल योग, मुद्रा, एक छोटा विवरण (कार्ट नंबर और स्टोर का नाम) तथा बिलिंग पते की जानकारी और ईमेल (भुगतान पेज को पहले से भरने के लिए) भेजे जाते हैं। इस समय तक कोई ऑर्डर नहीं होता। जब तक राशि, मुद्रा, मोड और लेन-देन का प्रकार नहीं बदलते, तब तक वही CorvusPay ऑर्डर नंबर फिर से उपयोग होता है, और CorvusPay उस नंबर के लिए दूसरा भुगतान स्वीकार नहीं करता।

भुगतान के बाद CorvusPay ग्राहक को Success URL पर वापस भेजता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब CorvusPay उसकी पुष्टि कर दे: CorvusPay ऑर्डर नंबर इसी स्टोर द्वारा जारी होना चाहिए, हस्ताक्षर उस स्टोर की Secret Key से मेल खाना चाहिए जिसमें भुगतान शुरू हुआ था, और राशि व मुद्रा कार्ट से मेल खानी चाहिए। फिर ऑर्डर बनता है और ग्राहक को मानक ऑर्डर पुष्टि पेज दिखता है, जिस पर आपका CorvusPay भुगतान प्राप्त हो गया है। लिखा होता है। Authorize only के लिए पेज पर आपका CorvusPay भुगतान अधिकृत हो गया है। जब स्टोर आपका ऑर्डर संसाधित करेगा, तब राशि काटी जाएगी। लिखा होता है, और होल्ड पर रखे ऑर्डर के लिए आपका भुगतान प्राप्त हो गया है और स्टोर इसकी समीक्षा कर रहा है। लिखा होता है।

यदि उसी क्षण ऑर्डर नहीं बन पाता (उदाहरण के लिए, कोई और अनुरोध उसी कार्ट की पुष्टि कर रहा हो), तो ग्राहक को आपके भुगतान की पुष्टि हो रही है संदेश और Check again बटन दिखता है; ऑर्डर बनते ही यह बटन ऑर्डर पुष्टि पेज पर ले जाता है। यदि Success URL अनुरोध सत्यापित नहीं हो पाता, तो ग्राहक को भुगतान की पुष्टि नहीं हुई और हम इस CorvusPay भुगतान की पुष्टि नहीं कर सके। यदि आपके कार्ड से राशि कट गई है, तो कृपया स्टोर से संपर्क करें — दोबारा भुगतान न करें। दिखता है। कुछ भी नहीं बदलता। स्टोर मेंटेनेंस मोड में होने पर भी Success URL काम करता है।

यदि ग्राहक CorvusPay पेज पर रद्द करता है, तो वह कार्ट को जस का तस रखते हुए चेकआउट पर लौट आता है और CorvusPay भुगतान रद्द कर दिया गया और ऑर्डर का भुगतान नहीं हुआ। आपकी कार्ट अभी भी यहीं है — आप फिर से प्रयास कर सकते हैं या कोई दूसरी भुगतान विधि चुन सकते हैं। संदेश देखता है।

यदि भुगतान शुरू नहीं हो पाता, तो ग्राहक चेकआउट पर एक छोटे संदेश के साथ रुका रहता है: CorvusPay कॉन्फ़िगर नहीं है। कृपया कोई दूसरी भुगतान विधि चुनें।, CorvusPay … में भुगतान स्वीकार नहीं करता या इस ऑर्डर की कुल राशि CorvusPay से नहीं चुकाई जा सकती (यह शून्य से अधिक और अधिकतम 2 दशमलव स्थानों वाली होनी चाहिए)। कृपया कोई दूसरी भुगतान विधि चुनें।

ऑर्डर तभी पक्का होता है जब CorvusPay ग्राहक को Success URL पर वापस भेजता है; सर्वर-से-सर्वर सूचनाएँ नहीं होती हैं। यदि ग्राहक भुगतान के तुरंत बाद ब्राउज़र बंद कर देता है, तो कोई ऑर्डर नहीं बनता। मॉड्यूल में PrestaShop से रिफ़ंड, कैप्चर या void नहीं हैं (CorvusPay सर्वर API को क्लाइंट सर्टिफ़िकेट चाहिए), और सेव किए गए कार्ड, सब्सक्रिप्शन, किस्तें या स्टोर पर कार्ड फ़ॉर्म भी नहीं हैं।

ऑर्डर

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

अभी कोई ऑर्डर नहीं: ग्राहक को CorvusPay पर भेजा गया था और वह पुष्ट भुगतान के साथ वापस नहीं लौटा। केवल कार्ट मौजूद है। यदि ग्राहक ने भुगतान किया पर वापस नहीं आया, तो CorvusPay Merchant Center में भुगतान जाँचें और ऑर्डर मैनुअली बनाएँ।

Payment accepted, Delivered या CorvusPay payment on hold: Sale भुगतान की पुष्टि हो गई। स्थिति Order Status After Payment का अनुसरण करती है। भुगतान CorvusPay लेन-देन ID के साथ दर्ज होता है या, यदि CorvusPay कोई ID नहीं भेजता, तो CorvusPay ऑर्डर नंबर के साथ, जिससे Merchant Center में भुगतान खोजा जा सकता है। ऑर्डर का निजी नोट CorvusPay ऑर्डर नंबर, अनुमोदन कोड और कार्ड का प्रकार दिखाता है।

CorvusPay payment on hold, authorized: Authorize only चुना गया है। CorvusPay Merchant Center में भुगतान कैप्चर करें, फिर ऑर्डर को Payment accepted पर सेट करें।

CorvusPay payment on hold, amount/currency mismatch: भुगतान की गई राशि या मुद्रा कार्ट से मेल नहीं खाती, उदाहरण के लिए इसलिए कि कार्ट दूसरे टैब में बदल दी गई थी। यदि भुगतान ऑर्डर की मुद्रा में है, तो वास्तव में भुगतान की गई राशि के साथ भुगतान दर्ज होता है। CorvusPay Merchant Center में भुगतान सत्यापित करने से पहले शिप न करें।

CorvusPay payment on hold, payment after cancel: ग्राहक द्वारा रद्द किए गए भुगतान प्रयास के लिए एक सफल भुगतान आया है। ऑर्डर पूरा करें या CorvusPay Merchant Center में भुगतान रिफ़ंड करें।

यदि ऐसी कार्ट के लिए, जिस पर पहले से ऑर्डर है, कोई दूसरा अलग सफल भुगतान आता है, तो ऑर्डर नहीं बदलता। एक नोट आपसे CorvusPay Merchant Center जाँचने और ज़रूरत हो तो डुप्लिकेट भुगतान रिफ़ंड करने के लिए कहता है।

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

ऑर्डर पेज पर एक CorvusPay payment ब्लॉक दिखता है, जिसमें CorvusPay ऑर्डर नंबर, भुगतान प्रयास की स्थिति, लेन-देन का प्रकार (Sale या Authorize only), राशि (और यदि CorvusPay ने बताई हो तो प्राप्त राशि), अनुमोदन कोड, लेन-देन और कार्ड का प्रकार होता है। टेस्ट भुगतान पर Test का चिह्न लगता है।

रिफ़ंड: PrestaShop से रिफ़ंड, कैप्चर और void समर्थित नहीं हैं। ये CorvusPay Merchant Center में करें और परिणाम PrestaShop में मैनुअली दर्ज करें।

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

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

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

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

सक्रिय कुंजी के बिना CorvusPay चेकआउट पर ग्राहकों को नहीं दिखाया जाता। फिर भी यदि भुगतान शुरू होता है, तो ग्राहक को यह भुगतान विधि उपलब्ध नहीं है। कृपया कोई दूसरी चुनें। दिखता है। PrestaShop स्टोरफ़्रंट यह नहीं जानता कि आप बैक ऑफ़िस में लॉग इन हैं, इसलिए भुगतान विधि आपके लिए भी छिपी रहती है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, लेकिन चेकआउट पर उसे परख नहीं सकते। Modules > Module Manager में Alerts टैब पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं, ग्राहक के CorvusPay से लौटने पर उनकी पुष्टि अब भी होती है।

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

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

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

भुगतान हो गया, पर ऑर्डर नहीं बना: संभवतः Success URL CorvusPay Merchant Center में दर्ज नहीं है, या PrestaShop की Secret Key स्टोर से मेल नहीं खाती। मॉड्यूल पेज के Log फ़ील्ड में INVALID signature खोजें (त्रुटियाँ हमेशा दर्ज होती हैं)। यदि ग्राहक लौटने से पहले ब्राउज़र बंद कर दे, तब भी ऑर्डर नहीं बनता; ऐसे में Merchant Center में भुगतान जाँचें और ऑर्डर मैनुअली बनाएँ।

ग्राहक को भुगतान की पुष्टि नहीं हुई दिखता है: Success URL अनुरोध अस्वीकार हुआ: आवश्यक फ़ील्ड गायब थे, CorvusPay ऑर्डर नंबर इस स्टोर द्वारा जारी नहीं हुआ था, उस स्टोर की Secret Key खाली है या हस्ताक्षर मेल नहीं खाया। कुछ नहीं बदलता। लॉग कारण दिखाता है।

ग्राहक को लंबे समय तक आपके भुगतान की पुष्टि हो रही है दिखता है: ऑर्डर नहीं बन सका, उदाहरण के लिए मॉड्यूल बंद था या कार्ट अब मान्य नहीं है। लॉग कारण दिखाता है; Merchant Center में भुगतान जाँचें।

ग्राहक को इस ऑर्डर की कुल राशि CorvusPay से नहीं चुकाई जा सकती दिखता है: कुल राशि शून्य है या उसमें 2 से अधिक दशमलव स्थान हैं।

ग्राहक को CorvusPay कॉन्फ़िगर नहीं है या CorvusPay … में भुगतान स्वीकार नहीं करता दिखता है: मौजूदा मोड का Store ID या Secret Key गायब है, या कार्ट की मुद्रा समर्थित नहीं है।

ऑर्डर CorvusPay payment on hold में है: ऑर्डर के निजी नोट पढ़ें। Authorize only चुना गया है, भुगतान की गई राशि या मुद्रा कार्ट से मेल नहीं खाई, भुगतान ग्राहक के रद्द करने के बाद आया, या Order Status After Payment होल्ड पर सेट है।

अनइंस्टॉल

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

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