VibeFox PayFast for WooCommerce — सहायता
आवश्यकताएँ
WordPress: 6.2 या उसके बाद का संस्करण।
WooCommerce: 8.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। इसके बिना प्लगइन सक्रिय नहीं होता।
PHP: 8.0 या उसके बाद का संस्करण।
मुद्रा: दक्षिण अफ़्रीकी रैंड (ZAR), जिसे WooCommerce > Settings > General में सेट किया जाता है। PayFast केवल रैंड में निपटान करता है। न्यूनतम ऑर्डर राशि R5.00 है।
PayFast खाता: आपके PayFast खाते का Merchant ID और Merchant Key, जो PayFast डैशबोर्ड में Settings > Developer Settings के अंतर्गत मिलते हैं। पासफ़्रेज़ की दृढ़ता से अनुशंसा की जाती है; यदि यह PayFast में सेट है, तो वही पासफ़्रेज़ प्लगइन में भी दर्ज करना होगा। परीक्षण के लिए आपको PayFast सैंडबॉक्स के क्रेडेंशियल्स चाहिए।
पहुँच योग्य साइट: भुगतान सूचना URL इंटरनेट से पहुँच योग्य होना चाहिए, बिना रखरखाव मोड, बेसिक ऑथेंटिकेशन या फ़ायरवॉल ब्लॉक के।
VibeFox लाइसेंस कुंजी: vibefox.net पर खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से wcp_payfast_pay फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।
2. Activate पर क्लिक करें।
3. WooCommerce > Settings > General में स्टोर मुद्रा को दक्षिण अफ़्रीकी रैंड पर सेट करें।
4. सेटिंग्स खोलें: WooCommerce > Settings > Payments > PayFast > Manage, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।
5. पेज के शीर्ष पर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें।
6. Merchant ID, Merchant Key और पासफ़्रेज़ दर्ज करें। परीक्षण के लिए Test mode चालू रखें और अपने सैंडबॉक्स क्रेडेंशियल्स दर्ज करें।
7. Enable/Disable चालू करें और सहेजें। एक परीक्षण भुगतान करें, फिर वास्तविक भुगतान लेने के लिए टेस्ट मोड बंद करें।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > PayFast। फ़ील्ड्स के ऊपर यह पेज चेतावनी देता है जब वर्तमान मोड के क्रेडेंशियल्स खाली हों (तब चेकआउट में PayFast छिपा रहता है), जब स्टोर मुद्रा ZAR न हो, जब लाइव मोड सार्वजनिक सैंडबॉक्स Merchant ID 10000100 का उपयोग कर रहा हो, और जब कोई पासफ़्रेज़ सेट न हो; और जब टेस्ट मोड चालू हो तो Test mode is on: orders are paid in the PayFast sandbox, no real money is charged. दिखाता है। भुगतान तरीकों की सूची में, जब तक वर्तमान मोड का Merchant ID और Merchant Key दर्ज नहीं होते, PayFast को सेटअप की आवश्यकता वाला दिखाया जाता है।
सामान्य
Enable/Disable: Enable PayFast भुगतान तरीके को चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: वह भुगतान तरीके का नाम जो ग्राहक चेकआउट पर देखता है। डिफ़ॉल्ट: PayFast।
Description: चेकआउट पर भुगतान तरीके के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely by card, Instant EFT and other methods on the PayFast payment page.
PayFast खाता (लाइव)
अपना Merchant ID और Merchant Key PayFast डैशबोर्ड में Settings > Developer Settings के अंतर्गत पाएँ। यदि वहाँ आपने कोई पासफ़्रेज़ सेट किया है, तो यहाँ बिल्कुल वही दर्ज करें।
Merchant ID: आपका लाइव PayFast Merchant ID।
Merchant Key: आपकी लाइव PayFast Merchant Key। यह हर भुगतान फ़ॉर्म के साथ PayFast को भेजी जाती है।
Passphrase: PayFast का सॉल्ट पासफ़्रेज़, Settings > Developer Settings में। दृढ़ता से अनुशंसित: यह भुगतानों और सूचनाओं पर हस्ताक्षर करता है।
सैंडबॉक्स (टेस्ट मोड)
टेस्ट मोड में भुगतान PayFast सैंडबॉक्स में जाते हैं और कोई वास्तविक राशि नहीं काटी जाती। PayFast सैंडबॉक्स में लॉग इन करने के बाद सैंडबॉक्स क्रेडेंशियल्स दिखते हैं (सार्वजनिक परीक्षण मर्चेंट 10000100 / 46f0cd694581a है)।
Test mode: Use the PayFast sandbox and the sandbox credentials below। चेकआउट पर ग्राहक को TEST MODE: payments go to the PayFast sandbox, no real money is charged. दिखता है। डिफ़ॉल्ट: चालू।
Sandbox Merchant ID: आपके सैंडबॉक्स खाते का Merchant ID।
Sandbox Merchant Key: आपके सैंडबॉक्स खाते की Merchant Key।
Sandbox Passphrase: केवल तभी जब आपके सैंडबॉक्स खाते में पासफ़्रेज़ सेट हो।
टेस्ट मोड में संस्करण 1.0 से अपडेट करने पर, आपके मौजूदा क्रेडेंशियल्स सैंडबॉक्स फ़ील्ड्स में कॉपी हो जाते हैं। टेस्ट मोड बंद करने से पहले लाइव क्रेडेंशियल्स जाँच लें।
भुगतान सूचनाएँ (ITN)
PayFast हर भुगतान की पुष्टि इस सेक्शन में दिखाए गए URL पर सर्वर-से-सर्वर सूचना के माध्यम से करता है। यह इस रूप का होता है: https://your-site/wc-api/payfast_pay/। यह पता हर भुगतान के साथ भेजा जाता है, इसलिए PayFast में कुछ भी कॉन्फ़िगर करने की आवश्यकता नहीं है, लेकिन यह इंटरनेट से पहुँच योग्य होना चाहिए।
स्रोत जाँच: Accept live notifications only from PayFast servers। पते PayFast के DNS रिकॉर्ड से लिए जाते हैं। इसे केवल तभी बंद करें जब आपकी साइट किसी प्रॉक्सी या CDN के पीछे हो जो विज़िटर का पता छिपाता है। हस्ताक्षर और सर्वर पुष्टि हमेशा जाँचे जाते हैं। सैंडबॉक्स सूचनाएँ पते से नहीं जाँची जातीं। डिफ़ॉल्ट: चालू।
उन्नत
Debug log: Log payment steps चरणों को WooCommerce > Status > Logs में लिखता है, स्रोत wcp_payfast_pay। त्रुटियाँ हमेशा दर्ज होती हैं। पासफ़्रेज़ या ग्राहक विवरण नहीं लिखे जाते। डिफ़ॉल्ट: बंद।
Uninstall: Delete the gateway settings and logs when the plugin is deleted। डिफ़ॉल्ट: बंद।
चेकआउट
ग्राहक भुगतान तरीका चुनता है (डिफ़ॉल्ट रूप से PayFast) और ऑर्डर देता है। ग्राहक ऑर्डर के Pay for order पेज पर जाता है, जिस पर Thank you for your order. You are being redirected to PayFast to complete the payment. दिखता है, और हस्ताक्षरित भुगतान फ़ॉर्म अपने-आप PayFast को भेज दिया जाता है। यदि ब्राउज़र खुद आगे नहीं बढ़ता, तो ग्राहक Pay with PayFast पर क्लिक करता है; Cancel order ऑर्डर रद्द करता है। फ़ॉर्म में ZAR में ऑर्डर की कुल राशि, Order # के साथ ऑर्डर नंबर, ग्राहक का नाम और ईमेल, और ऑर्डर कुंजी होती है। पेज खोले जाने पर यह हर बार फिर से बनता है, इसलिए ग्राहक PayFast से वापस आने के बाद इसे फिर से खोल सकता है।
PayFast के पेज पर ग्राहक कार्ड, Instant EFT या आपके PayFast खाते के किसी अन्य तरीके से भुगतान करता है। फिर PayFast आपके स्टोर को भुगतान सूचना (ITN) भेजता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब सूचना सभी जाँचों में सफल हो:
ग्राहक का ऑर्डर प्राप्ति पेज पर लौटना ऑर्डर को नहीं बदलता। जब तक सूचना नहीं आती, पेज पर PayFast is confirming your payment. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. दिखता है। यदि ऑर्डर होल्ड पर है, तो Your payment is being reviewed. We will contact you if anything else is needed. दिखता है।
यदि ग्राहक PayFast पेज पर रद्द करता है, तो ऑर्डर WooCommerce के मानक तरीके से रद्द हो जाता है। यदि ग्राहक बिना भुगतान किए चला जाता है, तो ऑर्डर अभी भी अनभुगतान रहता है और उसे Pay for order पेज से फिर से भुगतान किया जा सकता है।
यह भुगतान तरीका क्लासिक चेकआउट, Checkout ब्लॉक और Pay for order पेज पर काम करता है। यह तब छिपा रहता है जब वर्तमान मोड के क्रेडेंशियल्स गायब हों, जब स्टोर या ऑर्डर की मुद्रा ZAR न हो, या जब कुल राशि R5.00 से कम हो। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।
प्लगइन केवल ZAR में एकल भुगतान स्वीकार करता है। इसमें WooCommerce से रिफ़ंड, सब्सक्रिप्शन, सहेजे गए (टोकनाइज़्ड) कार्ड, प्री-ऑर्डर या स्प्लिट भुगतान की सुविधा नहीं है।
ऑर्डर
ऑर्डर स्थितियाँ
Pending payment: ग्राहक को PayFast पर भेजा गया था और भुगतान सूचना अभी तक नहीं आई है।
Processing: PayFast ने भुगतान की पुष्टि कर दी है। भुगतान के बाद यह WooCommerce की मानक स्थिति है; केवल वर्चुअल डाउनलोड योग्य उत्पादों वाले ऑर्डर पूर्ण हो जाते हैं। ऑर्डर नोट में PayFast भुगतान ID दिखता है, जो ऑर्डर की ट्रांज़ैक्शन ID भी है। सैंडबॉक्स भुगतान को यह नोट मिलता है कि कोई वास्तविक राशि नहीं काटी गई। PayFast शुल्क और शुद्ध राशि ऑर्डर पर सहेजी जाती है।
On hold: PayFast ने भुगतान को लंबित बताया है; या भुगतान की गई राशि ऑर्डर के कुल योग से अलग है, या ऑर्डर ZAR में नहीं है; या ऐसे ऑर्डर के लिए भुगतान आया जो पहले ही रद्द हो चुका था। ऑर्डर नोट इसका कारण बताता है। ऑर्डर और अपना PayFast डैशबोर्ड जाँचें, फिर ऑर्डर भेजें या PayFast में भुगतान रिफ़ंड करें।
Failed: ऑर्डर अनभुगतान रहते हुए PayFast ने भुगतान को विफल बताया। ग्राहक फिर से भुगतान कर सकता है।
Cancelled: ग्राहक ने PayFast पेज पर रद्द किया, या आपने ऑर्डर रद्द किया, या WooCommerce स्टॉक होल्ड समय-सीमा से ऑर्डर रद्द हुआ।
उसी भुगतान के लिए दोहराई गई सूचना कुछ नहीं बदलती। यदि पहले से भुगतान किए गए ऑर्डर के लिए एक और पूरा हुआ भुगतान आता है, तो एक नोट आपको PayFast में डुप्लीकेट को रिफ़ंड करने की याद दिलाता है। रिफ़ंड किए गए ऑर्डर के लिए आया भुगतान केवल एक नोट जोड़ता है। जब गेटवे लाइव मोड में हो, तब प्राप्त सैंडबॉक्स भुगतान एक नोट जोड़ता है और ऑर्डर को भुगतान किया हुआ नहीं बनाता।
रिफ़ंड
WooCommerce से रिफ़ंड समर्थित नहीं हैं। अपने PayFast डैशबोर्ड में भुगतान रिफ़ंड करें, फिर WooCommerce में मैन्युअल रिफ़ंड बनाएँ।
लाइसेंस कुंजी
यह प्लगइन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Payments > PayFast के शीर्ष पर है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now, कोई दूसरी कुंजी दर्ज करने के लिए Change key, और इस साइट से कुंजी हटाने के लिए Remove key का उपयोग करें। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।
एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने से उसका डोमेन स्लॉट मुक्त नहीं होता। अपने vibefox.net खाते में स्लॉट मुक्त करें।
सक्रिय कुंजी के बिना चेकआउट पर ग्राहकों को PayFast नहीं दिखता। यदि फिर भी भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। लॉग इन किए हुए स्टोर मैनेजरों को भुगतान तरीका अब भी (unlicensed — visible to admins only) चिह्न के साथ दिखता है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट अप और टेस्ट कर सकें। प्लगइन पेज और WooCommerce पेजों पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: पहले से शुरू हुए भुगतान अब भी पुष्ट होते हैं।
जब लाइसेंस समाप्त हो जाता है, तो प्लगइन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। स्थिति पृष्ठभूमि में अपने-आप फिर से जाँची जाती है।
समस्या निवारण
चेकआउट पर PayFast नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, वर्तमान मोड का Merchant ID और Merchant Key भरे हैं, स्टोर मुद्रा ZAR है और ऑर्डर की कुल राशि कम से कम R5.00 है। कुछ गायब होने पर सेटिंग्स पेज चेतावनी दिखाता है।
भुगतान हो गया, लेकिन ऑर्डर भुगतान लंबित पर ही रहता है: PayFast भुगतान सूचना नहीं पहुँचा सका, या वह अस्वीकार हो गई। Debug log चालू करें और WooCommerce > Status > Logs, स्रोत wcp_payfast_pay, देखें। सामान्य कारण: साइट इंटरनेट से पहुँच योग्य नहीं है (रखरखाव मोड, बेसिक ऑथेंटिकेशन, फ़ायरवॉल), PayFast और प्लगइन में अलग पासफ़्रेज़ हैं, या लाइव मोड में प्रॉक्सी या CDN के पीछे होने पर स्रोत जाँच। ऐसी स्थिति में Source check बंद करें।
सूचना का उत्तर Invalid signature है: प्लगइन का पासफ़्रेज़ उस पासफ़्रेज़ से मेल नहीं खाता जो इस मोड के लिए PayFast में सेट है।
सूचना का उत्तर Invalid source है: सूचना PayFast के किसी पते से नहीं आई, या प्रॉक्सी या CDN असली पता छिपा रहा है। यदि आपकी साइट प्रॉक्सी या CDN के पीछे है, तो Source check बंद करें।
सूचना का उत्तर Merchant mismatch या Order mismatch है: भुगतान किसी दूसरे PayFast खाते में किया गया था या इस ऑर्डर का नहीं है। कुछ नहीं बदला जाता।
सूचना का उत्तर Confirmation unavailable या Busy है: सर्वर पुष्टि के लिए PayFast तक नहीं पहुँचा जा सका, या उसी ऑर्डर की कोई दूसरी सूचना उसी समय प्रोसेस हो रही थी। PayFast सूचना को फिर से भेजता है।
सूचना का उत्तर Not configured है: जिस मोड में ऑर्डर का भुगतान हुआ, उसके क्रेडेंशियल्स नहीं हैं।
ग्राहक को PayFast accepts payments from R5.00 दिखता है: ऑर्डर का कुल योग PayFast की न्यूनतम सीमा से कम है।
ऑर्डर On hold है: PayFast ने ऐसा भुगतान पुष्ट किया जो ऑर्डर से मेल नहीं खाता (अलग राशि, या ZAR के अलावा कोई मुद्रा), या ऐसा भुगतान आया जिसका ऑर्डर पहले ही रद्द हो चुका था। ऑर्डर नोट्स और अपना PayFast डैशबोर्ड जाँचें।
सैंडबॉक्स भुगतान से ऑर्डर का भुगतान नहीं हुआ: गेटवे लाइव मोड में है। लाइव मोड में सैंडबॉक्स भुगतान कभी किसी ऑर्डर का भुगतान नहीं करते; ऑर्डर पर एक नोट इसकी जानकारी देता है।
लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक के संदेश का पालन करें। उदाहरण के लिए, यदि कुंजी किसी दूसरे डोमेन पर पहले से उपयोग में है, तो अपने vibefox.net खाते में स्लॉट मुक्त करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं है, तो प्लगइन अंतिम ज्ञात स्थिति के साथ काम करता रहता है।
अनइंस्टॉल
प्लगइन को निष्क्रिय करने पर सारा डेटा सुरक्षित रहता है। इसे हटाने के लिए Plugins पेज पर इसे निष्क्रिय करके हटाएँ। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती है। गेटवे सेटिंग्स, प्लगइन के अन्य विकल्प, कैश्ड PayFast पते और इसके लॉग केवल तभी हटाए जाते हैं जब Delete the gateway settings and logs when the plugin is deleted चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए रहते हैं। मौजूदा ऑर्डर अपने भुगतान नोट्स और ट्रांज़ैक्शन ID बनाए रखते हैं।
PayFast उसके स्वामी का ट्रेडमार्क है। यह प्लगइन PayFast से संबद्ध नहीं है और न ही PayFast द्वारा अनुमोदित है।