VibeFox Quickpay for WooCommerce — सहायता

आवश्यकताएँ

WordPress: 6.2 या उसके बाद।

WooCommerce: 7.1 या उसके बाद, इंस्टॉल और सक्रिय। इसके बिना प्लगइन सक्रिय नहीं होगा।

PHP: 8.0 या उसके बाद।

Quickpay खाता: आपको Quickpay manager से दो मान चाहिए: एक API उपयोगकर्ता की API कुंजी (भुगतान बनाने, कैप्चर करने और रिफ़ंड के लिए) और खाते की private key (Quickpay कॉलबैक के हस्ताक्षर की जाँच के लिए)। Quickpay में और कुछ सेट करने की ज़रूरत नहीं है। आपकी साइट इंटरनेट से पहुँच योग्य होनी चाहिए, पासवर्ड सुरक्षा या मेंटेनेंस मोड में नहीं, ताकि Quickpay कॉलबैक पहुँच सकें।

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

इंस्टॉलेशन

1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से wcp_quickpay_gateway फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।

2. Activate पर क्लिक करें।

3. सेटिंग्स खोलें: WooCommerce > Settings > Payments > Quickpay > Manage, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।

4. पेज के ऊपर वाले लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें।

5. Quickpay manager से API कुंजी और private key चिपकाएँ और Test API key पर क्लिक करें (कॉन्फ़िगरेशन देखें)।

6. कैप्चर मोड और भुगतान के बाद का ऑर्डर स्टेटस चुनें, Enable/Disable चालू करें और सेव करें। जब तक आपका Quickpay खाता टेस्ट मोड में है, Test payments चालू करें और किसी Quickpay टेस्ट कार्ड से भुगतान करें।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Quickpay। जब तक API कुंजी और private key दोनों दर्ज नहीं होतीं, भुगतान विधियों की सूची में Quickpay को सेटअप की ज़रूरत वाला दिखाया जाता है और चेकआउट पर वह छिपा रहता है, क्योंकि भुगतान न बनाया जा सकता है, न पुष्टि किया जा सकता है।

सामान्य

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

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

Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला टेक्स्ट। डिफ़ॉल्ट: Pay securely by card or MobilePay on the Quickpay payment page.

Quickpay API क्रेडेंशियल

Quickpay manager (manage.quickpay.net) में Settings > Integration खोलें। किसी API उपयोगकर्ता की API कुंजी (Settings > Users) और खाते की private key कॉपी करें। इस सेक्शन में आपके स्टोर का कॉलबैक URL भी दिखता है, जो https://your-site/wc-api/qpg_quickpay/ जैसा दिखता है। यह हर भुगतान के साथ अपने-आप भेजा जाता है, इसलिए Quickpay में कुछ कॉन्फ़िगर करने की ज़रूरत नहीं है।

API key: Quickpay API उपयोगकर्ता की API कुंजी। इसका उपयोग भुगतान बनाने, कैप्चर करने और रिफ़ंड के लिए होता है।

फ़ील्ड के नीचे Test API key बटन, फ़ील्ड में टाइप की गई कुंजी (या फ़ील्ड खाली होने पर सहेजी गई कुंजी) को Quickpay को एक प्रमाणित अनुरोध भेजकर जाँचता है। यह Connection successful — the API key is valid., Quickpay rejected the API key., API key is not configured. या Connection failed: के बाद कारण के साथ जवाब देता है।

Private key: खाते की private key। इसका उपयोग Quickpay कॉलबैक के हस्ताक्षर (HMAC-SHA256) की जाँच के लिए होता है। इसके बिना कोई भुगतान पुष्टि नहीं हो सकता, और कॉलबैक अस्वीकार हो जाते हैं।

Test payments: Accept payments made with Quickpay test cards। Quickpay का कोई अलग sandbox नहीं है: जब तक आपका Quickpay खाता टेस्ट मोड में है, भुगतान टेस्ट कार्ड से होते हैं और टेस्ट के रूप में चिह्नित होते हैं। इसे केवल टेस्टिंग के दौरान चालू करें। बंद होने पर टेस्ट भुगतान ऑर्डर को कभी भुगतान किया हुआ नहीं बनाता, बल्कि ऑर्डर पर एक नोट जुड़ जाता है। चालू होने पर चेकआउट पर Test mode: Quickpay test cards are accepted. दिखता है। डिफ़ॉल्ट: बंद।

भुगतान

Capture: जब कार्ड से पैसे काटे जाते हैं।

Order status after payment: Quickpay द्वारा कैप्चर किए गए भुगतान की पुष्टि के बाद का ऑर्डर स्टेटस। स्टेटस एक ही बार में सेट होता है, एक ही स्टेटस बदलाव और ईमेल का एक ही सेट भेजा जाता है।

एडवांस्ड

Debug log: Enable logging। लॉग WooCommerce > Status > Logs में होता है, स्रोत wcp_quickpay_gateway। त्रुटियाँ और चेतावनियाँ, जैसे अस्वीकृत कॉलबैक और Quickpay API त्रुटियाँ, हमेशा लॉग होती हैं। हर अनुरोध और कॉलबैक भी लॉग करने के लिए इसे चालू करें। API कुंजियाँ, कार्ड डेटा और ग्राहक का विवरण कभी लॉग नहीं होता। डिफ़ॉल्ट: बंद।

Delete data: Delete the gateway settings and logs when the plugin is deleted। प्लगइन को निष्क्रिय करने पर कुछ भी नहीं हटता। ऑर्डर डेटा (Quickpay भुगतान ID, नोट्स) हमेशा रखा जाता है। डिफ़ॉल्ट: बंद।

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Quickpay, Visa और Mastercard आइकन के साथ दिखता है) और ऑर्डर देता है। प्लगइन ऑर्डर की मुद्रा में ऑर्डर के लिए एक Quickpay भुगतान और ऑर्डर कुल के लिए भुगतान लिंक बनाता है, और ग्राहक को Quickpay भुगतान विंडो पर भेजता है। ग्राहक वहाँ आपकी Quickpay भुगतान विंडो पर सक्षम तरीकों में से किसी एक से भुगतान करता है। बिलिंग ईमेल Quickpay को भेजा जाता है। यदि Quickpay उपलब्ध कराता है, तो भुगतान विंडो आपकी साइट की भाषा में खुलती है (डेनिश, जर्मन, अंग्रेज़ी, स्पेनिश, फिनिश, फ़्रेंच, इतालवी, डच, नॉर्वेजियन, पोलिश, स्वीडिश), अन्यथा अंग्रेज़ी में।

भुगतान के बाद ग्राहक आपके स्टोर के ऑर्डर प्राप्ति पेज पर लौटता है। लौटने से अपने-आप कुछ भी भुगतान किया हुआ नहीं बनता। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Quickpay हस्ताक्षरित कॉलबैक से पुष्टि करे और राशि व मुद्रा ऑर्डर से मेल खाएँ। Authorize only के साथ ऑर्डर इसके बजाय होल्ड पर चला जाता है, और आप भुगतान बाद में कैप्चर करते हैं।

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

यदि भुगतान शुरू नहीं किया जा सकता, तो ग्राहक को The Quickpay payment could not be started. Please try again or choose another payment method. दिखता है। तकनीकी कारण ऑर्डर नोट्स और लॉग में जोड़ा जाता है। यदि कुंजियाँ गायब हैं, तो ग्राहक को Quickpay is not available at the moment. Please choose another payment method. दिखता है।

यह भुगतान विधि क्लासिक चेकआउट, Checkout ब्लॉक और Pay for order पेज पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।

प्लगइन केवल एकल भुगतान लेता है। इसमें सब्सक्रिप्शन या आवर्ती भुगतान नहीं हैं, सेव किए गए कार्ड नहीं हैं, भुगतान शुल्क नहीं हैं, कार्ट या इनवॉइस लाइनें Quickpay को नहीं भेजी जातीं, और अलग MobilePay, Apple Pay या Klarna तरीके नहीं हैं: ग्राहक आपकी Quickpay भुगतान विंडो के तरीकों में से चुनता है।

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

ऑर्डर स्टेटस

Pending payment: ग्राहक को Quickpay पर भेजा गया था और उसने अभी तक भुगतान नहीं किया है। ऑटो-कैप्चर के साथ, कैप्चर का इंतज़ार कर रहा प्राधिकृत भुगतान ऑर्डर पर नोट किया जाता है।

Processing or Completed: Quickpay ने सही राशि और मुद्रा के साथ कैप्चर किए गए भुगतान की पुष्टि की। स्टेटस Order status after payment का पालन करता है। ऑर्डर नोट में Quickpay भुगतान ID दिखता है (टेस्ट भुगतान के लिए TEST चिह्नित), और यह ऑर्डर की transaction ID के रूप में सहेजी जाती है।

On hold: भुगतान केवल प्राधिकृत है और Capture Quickpay payment का इंतज़ार कर रहा है; या Quickpay ने ऑर्डर कुल से अलग राशि या मुद्रा बताई है (उदाहरण के लिए, भुगतान शुरू होने के बाद ऑर्डर संपादित हुआ, या Quickpay manager में अलग राशि कैप्चर हुई); या कैप्चर विफल रहा और राशि अभी भी केवल रोकी हुई है। ऑर्डर नोट इसे समझाता है, और तब भी जब ऑर्डर पहले से होल्ड पर था।

Failed: भुगतान प्रयास अस्वीकार हो गया। ग्राहक फिर से भुगतान कर सकता है।

Cancelled: ग्राहक ने भुगतान विंडो पर रद्द किया, ऑर्डर आपके द्वारा या WooCommerce स्टॉक होल्ड टाइमआउट से रद्द हुआ, या Quickpay manager में भुगतान रद्द किया गया।

पहले से भुगतान किए, रद्द किए या रिफ़ंड किए गए ऑर्डर के लिए आया भुगतान ऑर्डर को नहीं बदलता। एक नोट आपसे Quickpay manager में भुगतान जाँचने को कहता है, उदाहरण के लिए दोहरे भुगतान को रिफ़ंड करने के लिए।

कैप्चर

Authorize only के साथ ऑर्डर खोलें, ऑर्डर एक्शन में Capture Quickpay payment चुनें और अपडेट बटन पर क्लिक करें। ऑर्डर कुल राशि कैप्चर होती है; आंशिक कैप्चर उपलब्ध नहीं है। यदि Quickpay तुरंत पुष्टि करता है, तो ऑर्डर भुगतान किया हुआ चिह्नित होता है। अन्यथा एक नोट बताता है कि कैप्चर का अनुरोध किया गया था, और Quickpay कॉलबैक की पुष्टि होने पर ऑर्डर भुगतान किया हुआ चिह्नित होता है। अस्वीकृत कैप्चर ऑर्डर स्क्रीन पर दिखता है और ऑर्डर पर नोट होता है।

प्राधिकृत ऑर्डर रद्द करने पर रोकी गई राशि अपने-आप मुक्त नहीं होती। ऑर्डर नोट याद दिलाता है कि Quickpay manager में भुगतान रद्द करें; अन्यथा प्राधिकरण समाप्त होने पर रोक खत्म हो जाती है।

रिफ़ंड

ऑर्डर खोलें, Refund पर क्लिक करें, राशि दर्ज करें और Refund via Quickpay पर क्लिक करें। कैप्चर किए गए भुगतानों के लिए पूर्ण और आंशिक रिफ़ंड समर्थित हैं। Quickpay रिफ़ंड को असिंक्रोनस रूप से प्रोसेस करता है: एक नोट बताता है कि रिफ़ंड का अनुरोध किया गया था, और कॉलबैक अंतिम परिणाम जोड़ता है, confirmed या कारण सहित FAILED। यदि Quickpay तुरंत रिफ़ंड अस्वीकार करता है, तो WooCommerce त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। जो प्राधिकृत भुगतान कभी कैप्चर नहीं हुआ, उसका रिफ़ंड नहीं हो सकता; उसे Quickpay manager में रद्द करें।

Quickpay manager में सीधे किए गए भुगतान और रिफ़ंड केवल ऑर्डर पर नोट किए जाते हैं। वे अपने-आप WooCommerce रिफ़ंड के रूप में दर्ज नहीं होते। ज़रूरत हो तो Refund via Quickpay के बिना WooCommerce में मैन्युअल रिफ़ंड बनाएँ।

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

यह प्लगइन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Payments > Quickpay के ऊपर है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्टेटस दिखाता है, उदाहरण के लिए वह तारीख जिस तक लाइसेंस सक्रिय है, और आपका डोमेन। स्टेटस दोबारा जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key और इस साइट से कुंजी हटाने के लिए Remove key का उपयोग करें। लिंक Manage licenses and domains in your account आपका vibefox.net खाता खोलता है।

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

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

जब लाइसेंस समाप्त होता है, तब भी प्लगइन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। स्टेटस पृष्ठभूमि में अपने-आप फिर से जाँचा जाता है।

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

Quickpay चेकआउट पर दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और API key तथा Private key दोनों दर्ज हैं। दोनों कुंजियों के बिना विधि छिपी रहती है।

भुगतान हो गया, लेकिन ऑर्डर Pending payment पर अटका है: Quickpay कॉलबैक आपके स्टोर तक नहीं पहुँचा या अस्वीकार हुआ। जाँचें कि आपकी साइट इंटरनेट से पहुँच योग्य है (पासवर्ड सुरक्षा या मेंटेनेंस मोड नहीं), और Private key उसी Quickpay खाते की private key है। अस्वीकृत कॉलबैक हमेशा WooCommerce > Status > Logs में, स्रोत wcp_quickpay_gateway के साथ लिखे जाते हैं। हर कॉलबैक देखने के लिए Debug log चालू करें।

लॉग में Callback rejected: invalid checksum. दिखता है: सेटिंग्स की private key उस खाते की नहीं है जिसने कॉलबैक भेजा। Quickpay manager में Settings > Integration से उसे फिर से कॉपी करें।

लॉग में Callback rejected: the private key is not configured. दिखता है: private key दर्ज करें। उसके बिना कॉलबैक कभी स्वीकार नहीं होते।

लॉग में Callback: no order found for payment … दिखता है: कॉलबैक एक Quickpay भुगतान का है जिसे इस स्टोर का कोई ऑर्डर नहीं जानता, उदाहरण के लिए WooCommerce के बाहर बनाया गया भुगतान या हटाए गए ऑर्डर का भुगतान।

लॉग में Callback: order #… is locked by another request. दिखता है: उसी ऑर्डर का कोई दूसरा कॉलबैक उसी समय लागू हो रहा था। इस कॉलबैक को त्रुटि उत्तर दिया जाता है, इसलिए वह संभाला हुआ नहीं माना जाता। यदि ऑर्डर अपरिवर्तित रहता है, तो Quickpay manager में भुगतान जाँचें।

टेस्ट भुगतान ने ऑर्डर को भुगतान किया हुआ नहीं बनाया: Test payments बंद है। ऑर्डर नोट बताता है कि टेस्ट भुगतान स्वीकार नहीं हुआ। टेस्टिंग के दौरान सेटिंग चालू करें, और जब आपका खाता लाइव हो जाए तब बंद करें।

भुगतान के बाद ऑर्डर On hold है: ऑर्डर नोट पढ़ें। भुगतान केवल प्राधिकृत हो सकता है और Capture Quickpay payment का इंतज़ार कर रहा हो, भुगतान की गई राशि या मुद्रा ऑर्डर से अलग हो सकती है, या कैप्चर विफल हुआ हो। Quickpay manager में कैप्चर करें, ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

Test API key कहता है Quickpay rejected the API key.: कुंजी गलत है या ऐसे उपयोगकर्ता की है जिसके पास API एक्सेस नहीं है। Quickpay manager से किसी API उपयोगकर्ता की API कुंजी कॉपी करें।

ग्राहक को The Quickpay payment could not be started. दिखता है: ऑर्डर नोट्स या लॉग खोलें। नोट में Quickpay की त्रुटि दिखती है, उदाहरण के लिए ऐसी मुद्रा जिसे आपका Quickpay खाता स्वीकार नहीं करता।

रिफ़ंड विफल होता है: ऑर्डर में कैप्चर किया हुआ Quickpay भुगतान होना चाहिए। संदेश The Quickpay payment of this order has not been captured — there is nothing to refund. का अर्थ है कि भुगतान केवल प्राधिकृत है; इसके बजाय उसे Quickpay manager में रद्द करें।

लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक के संदेश का पालन करें। उदाहरण के लिए, यदि कुंजी किसी और डोमेन पर पहले से उपयोग में है, तो vibefox.net खाते में स्लॉट खाली करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं हो सकती, तो प्लगइन अंतिम ज्ञात स्टेटस पर काम करता रहता है।

अनइंस्टॉल

प्लगइन को निष्क्रिय करने पर सारा डेटा सुरक्षित रहता है। हटाने के लिए उसे Plugins पेज पर निष्क्रिय करके डिलीट करें। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटा दिए जाते हैं। गेटवे सेटिंग्स और प्लगइन के लॉग (लॉग फ़ाइलें, जिनमें रोटेट की गई फ़ाइलें भी शामिल हैं, और डेटाबेस लॉग एंट्रियाँ) केवल तभी हटाए जाते हैं जब Delete data चालू था। अन्यथा वे बाद में पुनः इंस्टॉल करने के लिए रहते हैं। मौजूदा ऑर्डर अपने भुगतान नोट्स और transaction ID रखते हैं।

Quickpay उसके संबंधित मालिक का ट्रेडमार्क है। यह प्लगइन Quickpay से संबद्ध नहीं है और न ही Quickpay द्वारा समर्थित है।