VibeFox ifthenpay for WooCommerce — सहायता
आवश्यकताएँ
WordPress: 6.0 या उसके बाद का संस्करण।
WooCommerce: 7.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। WooCommerce के बिना प्लगइन सक्रिय नहीं होता।
PHP: 8.0 या उसके बाद का संस्करण।
मुद्रा: केवल यूरो (EUR)। जब स्टोर या ऑर्डर की मुद्रा EUR नहीं होती, तब भुगतान विधि छिपी रहती है। ifthenpay 0.01 से 99,999.99 EUR तक की कुल राशि स्वीकार करता है।
ifthenpay खाता: ifthenpay.com पर साइन अप करें। आपको उस विधि की कुंजी चाहिए जो आप देते हैं: Multibanco, MB WAY या Credit Card (प्रारूप ABC-123456)। कुंजियाँ ifthenpay बैकऑफ़िस (backoffice.ifthenpay.com) में दिखती हैं, या आपके खाते में विधि सक्रिय होने पर ifthenpay उन्हें भेजता है। ifthenpay को आपकी कुंजी के लिए कॉलबैक भी सक्रिय करना होगा (देखें कॉन्फ़िगरेशन), और आपका स्टोर इंटरनेट से पहुँच योग्य होना चाहिए।
VibeFox लाइसेंस कुंजी: vibefox.net पर खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से wcp_ifthenpay_gateway फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।
2. Activate पर क्लिक करें। प्लगइन अपनी एंटी-फ़िशिंग कुंजी बनाता है।
3. सेटिंग्स खोलें: WooCommerce > Settings > Payments > ifthenpay > Manage, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।
4. पेज के शीर्ष पर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें।
5. Payment Method चुनें और उसकी ifthenpay कुंजी दर्ज करें। सेव करें, ताकि Callback URL चुनी हुई विधि से मेल खाए।
6. सेटिंग्स में दिखाई गई Anti-phishing Key और Callback URL कॉपी करें और ifthenpay से अपनी कुंजी के लिए कॉलबैक सक्रिय करने को कहें (बैकऑफ़िस में या ifthenpay सपोर्ट के ज़रिए)।
7. Enable/Disable चालू करें।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > ifthenpay। चुनी गई विधि की कुंजी के बिना भुगतान विधि चेकआउट पर नहीं दिखती, और भुगतान विधियों की सूची में उसे कार्रवाई की ज़रूरत वाला चिह्नित किया जाता है। बिना इस कुंजी के सक्षम गेटवे सेव करने पर पेज पर ifthenpay: enter the key of the selected payment method, otherwise the method is not shown at checkout. दिखता है।
Enable/Disable: Enable ifthenpay Payment भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: चेकआउट पर दिखने वाला भुगतान विधि का शीर्षक। डिफ़ॉल्ट: ifthenpay।
Description: चेकआउट पर दिखने वाला भुगतान विधि का विवरण। डिफ़ॉल्ट: Pay via Multibanco, MB WAY or Credit Card। इसे अपनी दी गई विधि के अनुसार बदलें।
Payment Method: चेकआउट पर दी गई विधि। केवल इसी विधि की कुंजी ज़रूरी है।
ifthenpay कुंजियाँ
कुंजियाँ (प्रारूप ABC-123456) ifthenpay बैकऑफ़िस में दिखती हैं, या आपके खाते में भुगतान विधि सक्रिय होने पर ifthenpay उन्हें भेजता है।
Multibanco Key: डायनामिक संदर्भों के लिए आपकी ifthenpay Multibanco (MB) कुंजी।
MB WAY Key: आपकी ifthenpay MB WAY कुंजी।
Credit Card Key: आपकी ifthenpay Credit Card कुंजी। यह कार्ड पेज से ग्राहक की वापसी के हस्ताक्षर की भी पुष्टि करती है।
कॉलबैक (भुगतान सूचनाएँ)
कॉलबैक आपके स्टोर को बताता है कि भुगतान हो चुका है। आप जो हर कुंजी इस्तेमाल करते हैं, उसके लिए नीचे दी गई एंटी-फ़िशिंग कुंजी और कॉलबैक URL के साथ ifthenpay से कॉलबैक सक्रिय करने को कहें। Multibanco और MB WAY के ऑर्डर केवल कॉलबैक से पुष्ट होते हैं; कार्ड भुगतान कार्ड पेज की हस्ताक्षरित वापसी से भी पुष्ट होते हैं।
Anti-phishing Key: प्लगइन द्वारा बनाई गई, कॉपी करने के लिए दिखाई जाती है। ifthenpay इसे हर कॉलबैक में वापस भेजता है; इसके बिना कॉलबैक अस्वीकार हो जाते हैं।
Callback URL: चुनी गई भुगतान विधि का कॉलबैक URL, ifthenpay प्लेसहोल्डर के साथ, कॉपी करने के लिए दिखाया गया। यह https://your-site/wc-api/ifthenpay_payment_callback/ से शुरू होता है और विधि के पैरामीटर आगे जोड़े जाते हैं। सेटिंग्स में दिखाया गया पूरा URL ठीक वैसे ही कॉपी करें।
हर कॉलबैक की एंटी-फ़िशिंग कुंजी आपकी कुंजी से मिलाई जाती है। गायब या गलत कुंजी पर 403 उत्तर मिलता है और ऑर्डर नहीं बदलता। कॉलबैक को इस गेटवे के किसी ऑर्डर से भी मेल खाना चाहिए: Multibanco के लिए एंटिटी और संदर्भ से, MB WAY के लिए ऑर्डर और उसके किसी MB WAY अनुरोध से, Credit Card के लिए ऑर्डर और उसके कार्ड अनुरोध से। काम करने वाले कॉलबैक के बिना Multibanco और MB WAY ऑर्डर कभी पुष्ट नहीं होते, और कार्ड भुगतान केवल हस्ताक्षरित वापसी से पुष्ट होते हैं।
एडवांस्ड
Test Mode: Enable test/sandbox mode। क्रेडिट कार्ड और Multibanco ifthenpay सैंडबॉक्स एंडपॉइंट का उपयोग करते हैं; कोई असली पैसा नहीं काटा जाता, और आप ifthenpay द्वारा दी गई टेस्ट कुंजियों का उपयोग करते हैं। MB WAY का कोई सैंडबॉक्स नहीं है: ifthenpay की टेस्ट कुंजी से इसे जाँचें। चेकआउट पर TEST MODE बैज दिखता है। डिफ़ॉल्ट: बंद।
Order Status After Payment: पुष्ट भुगतान के बाद सेट होने वाली ऑर्डर स्थिति, जिसमें एक स्थिति परिवर्तन और ग्राहक को एक ईमेल होता है। केवल डाउनलोड योग्य वर्चुअल उत्पाद वाले ऑर्डर हमेशा WooCommerce द्वारा पूर्ण किए जाते हैं।
Debug Log: Enable logging। API अनुरोध और कॉलबैक WooCommerce > Status > Logs में, स्रोत wcp_ifthenpay_gateway के नाम से लिखे जाते हैं। त्रुटियाँ हमेशा दर्ज होती हैं। कुंजियाँ, एंटी-फ़िशिंग कुंजी और फ़ोन नंबर कभी दर्ज नहीं होते। डिफ़ॉल्ट: बंद।
Delete Data on Uninstall: Remove the plugin settings, the anti-phishing key and the logs when the plugin is deleted (orders are kept)। डिफ़ॉल्ट: बंद।
चेकआउट
Multibanco। चेकआउट पर ग्राहक को You will receive a Multibanco reference to complete the payment. दिखता है। ऑर्डर देने पर प्लगइन ऑर्डर कुल के लिए एक डायनामिक Multibanco संदर्भ बनाता है। ऑर्डर होल्ड पर चला जाता है, स्टॉक घटता है और कार्ट खाली हो जाती है। धन्यवाद पेज और होल्ड के दौरान भेजे गए ऑर्डर ईमेल Multibanco Payment Details दिखाते हैं: एंटिटी, संदर्भ और राशि, साथ में Please use these details to pay at any Multibanco ATM or through your online banking. यदि ग्राहक उसी राशि पर दोबारा ऑर्डर देता है, तो वही संदर्भ दोबारा उपयोग होता है। ifthenpay भुगतान कॉलबैक भेजने पर ऑर्डर पुष्ट होता है।
MB WAY। ग्राहक MB WAY phone number दर्ज करता है (912 345 678, +351 912 345 678, या अन्य देशों के लिए 351#912345678); बिलिंग फ़ोन अपने-आप भर जाता है। प्लगइन फ़ोन पर भुगतान अनुरोध भेजता है, ऑर्डर होल्ड पर जाता है, स्टॉक घटता है और कार्ट खाली हो जाती है। धन्यवाद पेज पर A payment request has been sent to your phone via MB WAY. Please confirm it in the MB WAY app. लिखा होता है। ऑर्डर के सभी अनुरोध सुरक्षित रहते हैं, इसलिए ऐप में पहले स्वीकृत अनुरोध भी अब भी माना जाता है। ऑर्डर कॉलबैक से पुष्ट होता है।
क्रेडिट कार्ड। ग्राहक को You will be redirected to a secure page to enter your card details. दिखता है और वह ifthenpay कार्ड पेज पर भेजा जाता है। भुगतान होने तक ऑर्डर भुगतान लंबित रहता है, और उससे पहले स्टॉक नहीं घटता। सफल भुगतान के बाद ग्राहक आपके स्टोर पर लौट आता है। वापसी केवल तभी स्वीकार होती है जब मान्य ifthenpay हस्ताक्षर, ऑर्डर कुंजी, उस प्रयास का सीक्रेट और ऑर्डर का कार्ड अनुरोध सही हों; फिर ऑर्डर भुगतान किया हुआ चिह्नित होता है। यदि वापसी सत्यापित नहीं हो सकती, तो ऑर्डर नहीं बदलता, और धन्यवाद पेज पर Your card payment is being confirmed by ifthenpay. You will receive an e-mail as soon as it is confirmed. दिखता है। विफल कार्ड भुगतान ऑर्डर को विफल चिह्नित करता है, और रद्द भुगतान उसे भुगतान लंबित पर छोड़ देता है। दोनों स्थितियों में ग्राहक Pay for order पेज पर जाता है, जहाँ The card payment was not completed. You can try again or choose another payment method. या The card payment was cancelled. You can try again or choose another payment method. दिखता है।
ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब ifthenpay भुगतान की पुष्टि कर दे, और राशि की ऑर्डर कुल से सेंट तक तुलना होती है। यदि भुगतान शुरू नहीं हो पाता, तो ग्राहक को एक छोटा संदेश दिखता है, जैसे The Multibanco reference could not be created. Please try again or choose another payment method., The MB WAY payment request could not be sent. Please check that the phone number is linked to MB WAY, or choose another payment method., या The payment service is temporarily unavailable. Please try again in a few minutes.
यह भुगतान विधि क्लासिक चेकआउट, कार्ट और चेकआउट ब्लॉक (MB WAY फ़ोन फ़ील्ड के साथ) और Pay for order पेज पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।
प्लगइन एक समय में एक ifthenpay विधि देता है। इसमें Payshop, Cofidis Pay, Apple Pay, Google Pay, PIX या Pay-by-Link नहीं हैं, सब्सक्रिप्शन या सेव किए गए कार्ड नहीं हैं, और बिना भुगतान वाले Multibanco संदर्भों की स्वचालित समाप्ति या रद्दीकरण नहीं है, और भुगतान स्थिति की पोलिंग भी नहीं है।
ऑर्डर
Order statuses
On hold (waiting for payment): एक Multibanco संदर्भ जारी हुआ या MB WAY अनुरोध भेजा गया। बिना भुगतान वाले संदर्भ अपने-आप रद्द नहीं होते; ज़रूरत हो तो ऐसे ऑर्डर आप खुद रद्द करें।
Pending payment: एक कार्ड भुगतान शुरू हुआ और अभी पुष्ट नहीं हुआ, या रद्द हो गया।
Processing or Completed: भुगतान पुष्ट हो गया। स्थिति Order Status After Payment के अनुसार होती है। ऑर्डर नोट में Multibanco एंटिटी और संदर्भ, MB WAY लेन-देन या कार्ड अनुरोध ID दिखते हैं।
On hold after payment: प्राप्त राशि ऑर्डर कुल से अलग थी, या भुगतान ऑर्डर रद्द होने के बाद पहुँचा। ऑर्डर नोट इसे समझाता है। ifthenpay बैकऑफ़िस में भुगतान जाँचें और ऑर्डर को मैन्युअली पूरा करें या रिफ़ंड करें।
Failed: ग्राहक कार्ड पेज से एक त्रुटि के साथ लौटा।
पहले से भुगतान किए गए ऑर्डर के लिए दूसरी भुगतान सूचना केवल एक नोट जोड़ती है, ताकि आप ifthenpay बैकऑफ़िस में डुप्लिकेट भुगतान जाँच सकें। रिफ़ंड किए गए ऑर्डर और भुगतान के बाद रद्द किए गए ऑर्डर कभी दोबारा नहीं खुलते।
रिफ़ंड
WooCommerce से रिफ़ंड समर्थित नहीं हैं। ifthenpay बैकऑफ़िस में भुगतान रिफ़ंड करें और WooCommerce में उसे मैन्युअली दर्ज करें। रिफ़ंड किया गया (DEVOLVIDO) कॉलबैक केवल ऑर्डर नोट जोड़ता है। ifthenpay द्वारा बताई गई अन्य स्थितियाँ भी केवल नोट जोड़ती हैं।
लाइसेंस कुंजी
यह प्लगइन vibefox.net से ली गई VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Payments > ifthenpay पेज के शीर्ष पर है। कुंजी License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now, कोई दूसरी कुंजी दर्ज करने के लिए Change key, और इस साइट से कुंजी हटाने के लिए Remove key का उपयोग करें। लिंक Manage licenses and domains in your account आपका vibefox.net खाता खोलता है।
एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने से उसका डोमेन स्लॉट मुक्त नहीं होता। अपने vibefox.net खाते में स्लॉट मुक्त करें।
सक्रिय कुंजी के बिना ifthenpay चेकआउट पर ग्राहकों को नहीं दिखता। फिर भी यदि भुगतान शुरू हो जाए, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। लॉग-इन स्टोर मैनेजर अब भी भुगतान विधि देखते हैं, जिस पर (unlicensed — visible to admins only) लिखा होता है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट करके टेस्ट कर सकें। प्लगइन्स पेज और WooCommerce पेजों पर एक याद दिलाने वाला संदेश दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: पहले से शुरू हुए भुगतान अब भी पुष्ट होते हैं।
जब लाइसेंस की समय सीमा समाप्त होती है, तब भी प्लगइन काम करता रहता है, पर अपडेट और सपोर्ट के लिए नवीनीकरण चाहिए। स्थिति पृष्ठभूमि में अपने-आप फिर से जाँची जाती है।
समस्या निवारण
ifthenpay चेकआउट पर नहीं दिखता: जाँच करें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, चुनी हुई Payment Method की कुंजी भरी है, मुद्रा EUR है और कुल राशि 0.01 से 99,999.99 EUR के बीच है। Pay for order पेज पर ऑर्डर की मुद्रा मायने रखती है।
ग्राहक ने भुगतान किया, लेकिन ऑर्डर On hold या Pending payment पर रहता है: कॉलबैक आपके स्टोर तक नहीं पहुँच रहा। जाँचें कि ifthenpay ने जिस कुंजी का आप उपयोग करते हैं, उसके लिए कॉलबैक URL और एंटी-फ़िशिंग कुंजी सक्रिय की है, और URL चुनी हुई विधि का है। साइट इंटरनेट से पहुँच योग्य होनी चाहिए, localhost पर नहीं और लॉगिन के पीछे नहीं। WooCommerce > Status > Logs में, स्रोत wcp_ifthenpay_gateway, Callback rejected वाली पंक्तियाँ खोजें।
कॉलबैक 403 Forbidden लौटाता है: कॉलबैक में एंटी-फ़िशिंग कुंजी गायब है या सेटिंग्स की कुंजी से अलग है। सेटिंग्स में दिखाई गई कुंजी ifthenpay को फिर से भेजें।
कॉलबैक 503 Not configured लौटाता है: एंटी-फ़िशिंग कुंजी अभी तक नहीं बनी है। सेटिंग्स पेज एक बार खोलें; ifthenpay कॉलबैक दोबारा करेगा।
कॉलबैक Order not found लौटाता है: संदर्भ या अनुरोध इस गेटवे के किसी ऑर्डर का नहीं है, उदाहरण के लिए ऑर्डर देने के बाद भुगतान विधि बदल दी गई थी।
भुगतान किया हुआ ऑर्डर On hold क्यों हुआ? प्राप्त राशि ऑर्डर कुल से अलग थी, या भुगतान ऑर्डर रद्द होने के बाद पहुँचा। ऑर्डर नोट पढ़ें, ifthenpay बैकऑफ़िस में भुगतान जाँचें और ऑर्डर मैन्युअली पूरा करें या रिफ़ंड करें।
MB WAY अनुरोध नहीं भेजा जा सका: फ़ोन नंबर MB WAY से जुड़ा नहीं है या गलत प्रारूप में है। 912 345 678 का उपयोग करें, या अन्य देशों के नंबरों के लिए 351#912345678 का।
टेस्ट मोड और MB WAY: ifthenpay के पास MB WAY का सैंडबॉक्स नहीं है; ifthenpay द्वारा दी गई टेस्ट कुंजी उपयोग करें।
लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक के संदेश का पालन करें। उदाहरण के लिए, यदि कुंजी किसी दूसरे डोमेन पर पहले से उपयोग में है, तो अपने vibefox.net खाते में स्लॉट मुक्त करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक नहीं पहुँचा जा सकता, तो प्लगइन आखिरी ज्ञात स्थिति पर काम करता रहता है।
अनइंस्टॉल
प्लगइन को निष्क्रिय करने पर सारा डेटा रहता है। हटाने के लिए, इसे Plugins पेज पर निष्क्रिय करें और फिर डिलीट करें। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटाई जाती है। गेटवे सेटिंग्स, एंटी-फ़िशिंग कुंजी और लॉग केवल तभी हटते हैं जब Delete Data on Uninstall चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए रहते हैं। ऑर्डर और उनका ifthenpay डेटा (संदर्भ, अनुरोध ID) हमेशा रखे जाते हैं। मौजूदा ऑर्डर अपने भुगतान नोट और ट्रांज़ैक्शन ID रखते हैं।
ifthenpay उसके संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन ifthenpay से संबद्ध नहीं है और ifthenpay द्वारा समर्थित नहीं है।