VibeFox PayFast for OpenCart — सहायता

आवश्यकताएँ

OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या 4.0.2 और उसके बाद का संस्करण (4.1.0.3 पर परीक्षण किया गया)।

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

Currency: दक्षिण अफ़्रीकी रैंड (ZAR)। PayFast केवल रैंड में भुगतान निपटाता है, इसलिए ऑर्डर ZAR में होना चाहिए। यदि आपके स्टोर में यह मुद्रा अभी नहीं है, तो इसे System > Localisation > Currencies में जोड़ें। ऑर्डर की न्यूनतम राशि R5.00 है।

PayFast account: आपके PayFast खाते का Merchant ID और Merchant Key, जो PayFast डैशबोर्ड में Settings > Developer Settings के अंतर्गत मिलते हैं। पासफ़्रेज़ का उपयोग दृढ़ता से अनुशंसित है; यदि PayFast में कोई पासफ़्रेज़ सेट है, तो वही पासफ़्रेज़ एक्सटेंशन में भी दर्ज करना होगा। परीक्षण के लिए आपको PayFast सैंडबॉक्स के क्रेडेंशियल्स चाहिए।

Reachable store: भुगतान सूचना URL इंटरनेट से पहुँच योग्य होना चाहिए, बिना बेसिक ऑथ और बिना फ़ायरवॉल ब्लॉक के।

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

इंस्टॉलेशन

डाउनलोड एक zip फ़ाइल है, जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। इसे अपने कंप्यूटर पर अनज़िप करें। इसमें README.txt, OpenCart 3 का पैकेज wcp_payfast_pay-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज wcp_payfast_pay.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।

OpenCart 3

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_payfast_pay-oc3-(version).ocmod.zip चुनें। इस एक्सटेंशन में कोई OCMOD संशोधन नहीं है, इसलिए Extensions > Modifications को रिफ़्रेश करने की आवश्यकता नहीं है। इंस्टॉलर के बजाय आप इस पैकेज के upload फ़ोल्डर की सामग्री को अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।

2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox PayFast Pay Gateway खोजें और Install (हरा + बटन) पर क्लिक करें।

3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। अपनी VibeFox लाइसेंस कुंजी पेज के शीर्ष पर लाइसेंस ब्लॉक में License key में चिपकाएँ और Activate पर क्लिक करें (देखें लाइसेंस कुंजी अनुभाग)।

4. Merchant ID, Merchant Key और पासफ़्रेज़ दर्ज करें। परीक्षण के लिए Test mode चालू रखें और अपने सैंडबॉक्स क्रेडेंशियल्स दर्ज करें।

5. Enable/Disable चालू करें और Save पर क्लिक करें। एक परीक्षण भुगतान करें, फिर वास्तविक भुगतान लेने के लिए Test mode बंद करें।

OpenCart 4

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_payfast_pay.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।

2. पैकेज उसी पेज पर इंस्टॉल किए गए एक्सटेंशन की सूची में दिखाई देता है। उसके बगल में Install (हरा + बटन) पर क्लिक करें।

3. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox PayFast Pay Gateway खोजें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर।

4. लाइसेंस कुंजी और PayFast क्रेडेंशियल दर्ज करें, और OpenCart 3 के चरण 3 से 5 की तरह भुगतान का परीक्षण करें। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल Notification URL अलग है (देखें Notification URL); वह भी हर भुगतान के साथ PayFast को भेजा जाता है।

नई इंस्टॉलेशन भुगतान विधि बंद और टेस्ट मोड चालू के साथ शुरू होती है।

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox PayFast Pay Gateway > Edit। अनुभाग बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सहेजता है। सेटिंग्स के ऊपर पेज आपको चेतावनी देता है, जब वर्तमान मोड के क्रेडेंशियल्स खाली हों (तब PayFast चेकआउट में छिपा रहता है), जब स्टोर की डिफ़ॉल्ट मुद्रा ZAR न हो, जब लाइव मोड सार्वजनिक सैंडबॉक्स Merchant ID 10000100 का उपयोग करे, और जब कोई पासफ़्रेज़ सेट न हो। जब तक टेस्ट मोड चालू है, यह Test mode is on: orders are paid in the PayFast sandbox, no real money is charged. दिखाता है।

सहेजते समय Title खाली नहीं हो सकता (128 अक्षरों तक), Sort Order एक पूर्ण संख्या होनी चाहिए (ऋणात्मक संख्याएँ स्वीकार्य हैं), Total 0 या उससे बड़ी संख्या होनी चाहिए, और चयनित जियो ज़ोन तथा ऑर्डर स्थितियाँ मौजूद होनी चाहिए; अन्यथा कुछ भी सहेजा नहीं जाता और पेज संबंधित फ़ील्ड का नाम बताता है। यदि आप वर्तमान मोड के क्रेडेंशियल्स के बिना भुगतान विधि चालू करते हैं, तो सेटिंग्स चेतावनी के साथ सहेजी जाती हैं।

PayFast

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

Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखते हैं। यही नाम ऑर्डर में भी सहेजा जाता है। डिफ़ॉल्ट: PayFast। आवश्यक।

Description: ग्राहक को Confirm Order चरण पर, पुष्टि बटन के ऊपर दिखाया जाने वाला टेक्स्ट। डिफ़ॉल्ट: Pay securely by card, Instant EFT and other methods on the PayFast payment page.

Sort Order: चेकआउट पर भुगतान विधियों के बीच PayFast की स्थिति। इसे खाली छोड़ें या एक पूर्ण संख्या दर्ज करें।

Geo Zone: PayFast केवल चयनित जियो ज़ोन के भुगतान पतों के लिए ऑफ़र करें। डिफ़ॉल्ट: All zones। जियो ज़ोन System > Localisation > Geo Zones में सेट किए जाते हैं। OpenCart 4 पर, जब स्टोर भुगतान पता नहीं माँगता, तब शिपिंग पता उपयोग होता है।

Total: चेकआउट की वह राशि, स्टोर की डिफ़ॉल्ट मुद्रा में, जिस तक किसी ऑर्डर का पहुँचना आवश्यक है ताकि PayFast ऑफ़र किया जाए। किसी भी राशि के लिए PayFast ऑफ़र करने हेतु इसे खाली छोड़ें। PayFast स्वयं हमेशा कम से कम R5.00 माँगता है।

PayFast खाता (लाइव)

अपना Merchant ID और Merchant Key PayFast डैशबोर्ड में Settings > Developer Settings के अंतर्गत खोजें (वहाँ अनुभाग के लिंक दिए गए हैं)। यदि आपने वहाँ कोई पासफ़्रेज़ सेट किया है, तो यहाँ ठीक वही दर्ज करें।

Merchant ID: आपका लाइव PayFast Merchant ID।

Merchant Key: आपकी लाइव PayFast Merchant Key। यह हर भुगतान फ़ॉर्म के साथ PayFast को भेजी जाती है, इसलिए यह एक सामान्य टेक्स्ट फ़ील्ड है।

Passphrase: PayFast से salt पासफ़्रेज़, Settings > Developer Settings में। दृढ़ता से अनुशंसित: यह भुगतानों और सूचनाओं पर हस्ताक्षर करता है।

सैंडबॉक्स (टेस्ट मोड)

टेस्ट मोड में भुगतान PayFast सैंडबॉक्स में जाते हैं और कोई वास्तविक राशि नहीं ली जाती। सैंडबॉक्स क्रेडेंशियल्स PayFast सैंडबॉक्स में लॉग इन करने के बाद दिखाए जाते हैं (सार्वजनिक परीक्षण मर्चेंट 10000100 / 46f0cd694581a है)।

Test mode: Use the PayFast sandbox and the sandbox credentials below। चालू रहने पर ग्राहक Confirm Order चरण पर 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: केवल तभी जब आपके सैंडबॉक्स खाते में कोई पासफ़्रेज़ सेट हो।

सहेजे गए पासफ़्रेज़ फिर कभी नहीं दिखाए जाते। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल तभी नया मान दर्ज करें जब आप उसे बदलना चाहें। सहेजा गया पासफ़्रेज़ हटाने के लिए फ़ील्ड के नीचे Clear the saved passphrase on save पर टिक करें और Save पर क्लिक करें।

भुगतान सूचनाएँ (ITN)

Notification URL: PayFast हर भुगतान की पुष्टि सर्वर-से-सर्वर सूचना द्वारा यहाँ दिखाए गए URL पर करता है। OpenCart 3 पर यह कुछ इस तरह दिखता है https://your-store/index.php?route=extension/payment/wcp_payfast_pay/itn, और OpenCart 4 पर https://your-store/index.php?route=extension/wcp_payfast_pay/payment/wcp_payfast_pay.itn जैसा। यह आपकी OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। यह पता हर भुगतान के साथ भेजा जाता है, इसलिए PayFast में कुछ कॉन्फ़िगर करने की आवश्यकता नहीं है, लेकिन यह इंटरनेट से पहुँच योग्य होना चाहिए। ऑर्डर अपनी स्थिति केवल इन सत्यापित सूचनाओं से प्राप्त करते हैं; ग्राहक के स्टोर पर लौटने से ऑर्डर नहीं बदलता।

Source check: लाइव सूचनाएँ केवल PayFast सर्वरों से स्वीकार करता है। पते PayFast के DNS रिकॉर्ड्स (6 घंटे के लिए कैश्ड; सेटिंग्स सहेजने पर कैश रीसेट होता है) और PayFast की दस्तावेज़ित पता श्रेणियों से आते हैं। इसे केवल तभी बंद करें जब आपका स्टोर किसी प्रॉक्सी या CDN के पीछे हो जो विज़िटर का पता छिपाता है। हस्ताक्षर और सर्वर पुष्टि हमेशा जाँची जाती हैं। सैंडबॉक्स सूचनाएँ पते से नहीं जाँची जातीं। डिफ़ॉल्ट: चालू।

ऑर्डर

OpenCart ऑर्डर को Confirm Order चरण पर बिना स्थिति के (एक लापता ऑर्डर) बनाता है। ऑर्डर को स्थिति केवल किसी सत्यापित PayFast सूचना से मिलती है। रद्द, विफल या अधूरा छोड़ा गया भुगतान ऑर्डर को बिना स्थिति के छोड़ देता है, और ग्राहक फिर से भुगतान कर सकता है। नीचे का हर फ़ील्ड आपकी OpenCart ऑर्डर स्थितियाँ सूचीबद्ध करता है।

Order Status (paid): PayFast द्वारा भुगतान की पुष्टि और राशि व मुद्रा के मेल खाने के बाद की स्थिति। डिफ़ॉल्ट: प्रसंस्करण में।

Awaiting PayFast payment: PayFast ने भुगतान को लंबित बताया है (उदाहरण के लिए Instant EFT)। PayFast द्वारा इसे पूरा करने पर यह भुगतान-पूर्ण स्थिति में बदल जाता है। डिफ़ॉल्ट: लंबित।

PayFast payment on hold: ऐसा भुगतान जिसके लिए आपकी समीक्षा चाहिए (देखें ऑर्डर स्थितियाँ अनुभाग)। ऐसे ऑर्डर को भुगतान-पूर्ण के रूप में चिह्नित नहीं किया जाता; एक नोट इसका कारण बताता है। डिफ़ॉल्ट: लंबित, क्योंकि OpenCart में On hold स्थिति नहीं है। आप System > Localisation > Order Statuses में अपनी स्थिति बना सकते हैं और यहाँ चुन सकते हैं।

Payment failed: लंबित भुगतान विफल हो गया। यदि PayFast बाद में इसे पूरा करता है, तो ऑर्डर भुगतान-पूर्ण स्थिति में बदल जाता है। डिफ़ॉल्ट: विफल।

उन्नत

Debug log: भुगतान के चरणों को OpenCart लॉग फ़ोल्डर (storage/logs) में payfast_p_debug.log.php में दर्ज करता है। यह फ़ाइल वेब से नहीं खोली जा सकती, और 5 MB पर इसे payfast_p_debug.old.log.php में ले जाया जाता है। त्रुटियाँ और चेतावनियाँ हमेशा दर्ज होती हैं, भले ही स्विच बंद हो। कोई पासफ़्रेज़, कुंजी या ग्राहक विवरण नहीं लिखे जाते। डिफ़ॉल्ट: बंद।

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

Uninstall: Delete the gateway settings when the extension is uninstalled (सेटिंग्स, कैश्ड PayFast पते और लॉग)। PayFast भुगतान रिकॉर्ड और ऑर्डर हमेशा रखे जाते हैं। डिफ़ॉल्ट: बंद।

आयात / निर्यात

Export: Download JSON सेटिंग्स को एक JSON फ़ाइल के रूप में सहेजता है। पासफ़्रेज़ निर्यात नहीं किए जाते।

Import: पहले निर्यात किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सहेजे गए पासफ़्रेज़ बने रहते हैं।

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से PayFast)। Confirm Order चरण पर ग्राहक आपका विवरण और नोट Thank you for your order. You will be redirected to PayFast to complete the payment. देखता है। OpenCart इसी चरण पर ऑर्डर बनाता है, अभी भी बिना स्थिति के। OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से भुगतान विधि चुनता है, जो Payment method options विंडो में होता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन हस्ताक्षरित भुगतान फ़ॉर्म PayFast को भेजता है। इस फ़ॉर्म में ZAR में ऑर्डर की राशि, Order # के साथ ऑर्डर नंबर, ग्राहक का नाम और ईमेल, भुगतान संदर्भ (ऑर्डर नंबर और प्रयास) और प्रयास का एक यादृच्छिक टोकन शामिल होता है। हर नए प्रयास को नया संदर्भ और नया टोकन मिलता है।

PayFast पेज पर ग्राहक कार्ड, Instant EFT या आपके PayFast खाते की किसी अन्य विधि से भुगतान करता है। फिर PayFast भुगतान सूचना (ITN) आपके स्टोर को भेजता है। ऑर्डर को भुगतान-पूर्ण केवल तभी चिह्नित किया जाता है जब PayFast एक ऐसी सूचना से भुगतान की पुष्टि करे जो सभी जाँचों में सफल हो:

इसके बाद ऑर्डर OpenCart के मानक तरीके से स्थिति प्राप्त करता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ। एक ही कार्ट की सूचनाएँ एक-एक करके संसाधित होती हैं; यदि उसी कार्ट की कोई अन्य सूचना संसाधित हो रही है, तो PayFast को एक त्रुटि उत्तर मिलता है और वह सूचना फिर से भेजता है। Notification URL भी स्टोर के मेंटेनेंस मोड में काम करता है: OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को जाने देता है, और OpenCart 4 पर एक्सटेंशन एक startup action जोड़ता है, जो सूचना और PayFast से ग्राहक की वापसी को जाने देता है।

जब ग्राहक लौटता है और ऑर्डर की कोई स्थिति होती है, तो OpenCart ऑर्डर सफलता पेज दिखाया जाता है। यदि PayFast ने भुगतान को लंबित बताया था, तो यह 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. दिखाया जाता है। यदि कोई लंबित भुगतान बाद में विफल हो गया, तो Your PayFast payment was not completed. Please contact us about this order. दिखाया जाता है (OpenCart 4 पर ग्राहक इसके बजाय चेकआउट पर लौटा दिया जाता है, देखें नीचे)। यदि सूचना अभी तक नहीं आई है, तो एक Payment confirmation पेज बताता है कि PayFast भुगतान की पुष्टि कर रहा है, जिसमें Check again और Back to checkout बटन होते हैं।

यदि ग्राहक PayFast पेज पर रद्द करता है, तो वह The PayFast payment was cancelled. You can try again or choose another payment method. संदेश के साथ चेकआउट पर लौट आता है। यदि PayFast ने भुगतान को विफल बताया, तो संदेश The payment was not completed. You can try again or choose another payment method. होता है। कार्ट सुरक्षित रहता है और फिर से भुगतान किया जा सकता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखाए जाते हैं। OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर नया ऑर्डर बनाता है; OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसे अपडेट करता है, इसलिए रद्द या विफल भुगतान के बाद ग्राहक नए प्रयास के साथ उसी ऑर्डर का भुगतान करता है। यदि उसी कार्ट का कोई अन्य ऑर्डर PayFast द्वारा पहले ही संभाला जा चुका है (उदाहरण के लिए दूसरे ब्राउज़र टैब में), तो ग्राहक दोबारा भुगतान करने के बजाय सफलता पेज पर पहुँच जाता है।

OpenCart 4 सफलता पेज दिखाए जाने तक ऑर्डर को चेकआउट में रखता है। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद हो गया (उदाहरण के लिए उसका लंबित भुगतान विफल हो गया या आपने उसे रद्द कर दिया), तो ग्राहक Your previous order was cancelled or its payment failed. Please confirm the order again. संदेश के साथ चेकआउट पर लौटा दिया जाता है, और अगला Confirm Order एक नया ऑर्डर भुगतान करता है। यदि उस ऑर्डर की पहले से कोई स्थिति है और कार्ट में अब दूसरे उत्पाद या मात्राएँ हैं, तो संदेश Your previous order has already been placed for other cart contents. Please confirm the order of your current cart again. होता है।

जब वर्तमान मोड के क्रेडेंशियल्स गायब हों, चेकआउट मुद्रा ZAR न हो, या कुल राशि R5.00 से कम हो, तो भुगतान विधि छिपी रहती है। यदि ग्राहक फिर भी भुगतान तक पहुँच जाता है, तो बटन के ऊपर एक छोटा संदेश इसका कारण समझाता है, उदाहरण के लिए PayFast accepts payments from R5.00. Please choose another payment method.

यह एक्सटेंशन केवल ZAR में एकमुश्त भुगतान स्वीकार करता है। इसमें ऑर्डर पेज से रिफ़ंड, सब्सक्रिप्शन, सहेजे गए (टोकनाइज़्ड) कार्ड और विभाजित भुगतान की सुविधा नहीं है।

ऑर्डर

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

No status (missing order): ग्राहक को PayFast पर भेजा गया था और भुगतान सूचना अभी तक नहीं आई है, या PayFast ने भुगतान को विफल बताया है। Sales > Orders में ऐसे ऑर्डर केवल तभी दिखाए जाते हैं जब फ़िल्टर Order Status को Missing Orders पर सेट किया गया हो।

OpenCart 4 पर चेकआउट का कोई बिना भुगतान वाला ऑर्डर Voided स्थिति पा सकता है, जिसे OpenCart 4 तब सेट करता है जब ग्राहक Confirm Order चरण पर वापस आता है। एक्सटेंशन ऐसे ऑर्डर को बिना स्थिति वाला ऑर्डर मानता है, और बाद का कोई भी भुगतान उसकी पुष्टि कर देता है।

Order Status (paid) (default Processing): PayFast ने भुगतान की पुष्टि की है। एक नोट PayFast भुगतान ID दिखाता है। सैंडबॉक्स भुगतान को यह नोट मिलता है कि कोई वास्तविक राशि नहीं ली गई।

Awaiting PayFast payment (default Pending): PayFast ने भुगतान को लंबित बताया है। PayFast द्वारा भुगतान पूरा करने पर ऑर्डर भुगतान-पूर्ण स्थिति में जाता है, या भुगतान विफल होने पर Payment failed में। ग्राहक को इन बदलावों की सूचना ईमेल से दी जाती है।

Payment failed (default Failed): एक लंबित भुगतान विफल हो गया। यदि PayFast इसे बाद में पूरा करता है, तो ऑर्डर भुगतान-पूर्ण स्थिति में बदल जाता है।

PayFast payment on hold (default Pending): चुकाई गई राशि ऑर्डर के कुल योग से भिन्न है, या ऑर्डर ZAR में नहीं है; ऐसे ऑर्डर के लिए भुगतान आया जिसकी स्थिति आपने इस बीच बदल दी थी (उदाहरण के लिए रद्द कर दी थी) या जिसकी भुगतान विधि अब PayFast नहीं है; या गेटवे लाइव मोड में होने पर सैंडबॉक्स भुगतान आया। नोट इसे समझाता है। ऑर्डर और अपना PayFast डैशबोर्ड जाँचें, फिर ऑर्डर को भुगतान-पूर्ण स्थिति पर सेट करें या ऑर्डर रद्द करके PayFast में भुगतान रिफ़ंड करें।

एक ही भुगतान की दोहराई गई सूचना से कुछ नहीं बदलता। देर से आने वाली विफल या लंबित सूचनाएँ कभी भुगतान-पूर्ण ऑर्डर को नहीं बदलतीं। यदि किसी पहले से भुगतान-पूर्ण ऑर्डर के लिए, या पहले से भुगतान-पूर्ण कार्ट के दूसरे ऑर्डर के लिए, कोई और पूर्ण भुगतान आता है, तो भुगतान-पूर्ण ऑर्डर पर एक नोट आपसे डुप्लिकेट भुगतान PayFast में रिफ़ंड करने के लिए कहता है।

नोट ऑर्डर के History की वे प्रविष्टियाँ हैं जो ग्राहक को दिखाई नहीं देतीं।

VibeFox PayFast Pay Gateway टैब

Sales > Orders में PayFast से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox PayFast Pay Gateway टैब Payment reference (m_payment_id), PayFast payment ID, Environment (लाइव या सैंडबॉक्स), अनुरोधित राशि, स्थिति, ZAR में सकल, शुल्क और शुद्ध राशियाँ, और PayFast notes दिखाता है। होल्ड पर किसी ऑर्डर के लिए यह भुगतान की समीक्षा करने की याद दिलाता है। यह टैब उन उपयोगकर्ताओं को दिखाया जाता है जिनके पास एक्सटेंशन की पहुँच है।

रिफ़ंड

ऑर्डर पेज से रिफ़ंड समर्थित नहीं हैं। अपने PayFast डैशबोर्ड में भुगतान रिफ़ंड करें, फिर OpenCart में ऑर्डर को मैन्युअल रूप से अपडेट करें।

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

यह एक्सटेंशन vibefox.net से प्राप्त VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox PayFast Pay Gateway, Extensions > Extensions > Payments > VibeFox PayFast Pay Gateway > Edit पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक कुंजी को मास्क करके, स्थिति (जैसे वह तिथि जब तक लाइसेंस सक्रिय है, और आपका डोमेन) के साथ दिखाता है, और बटन भी: स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: opencart-payment-payfast वाली पंक्ति और वह लिंक है जो आपका vibefox.net खाता खोलता है: Manage licenses and domains in your account। केवल वे एडमिन उपयोगकर्ता जिनके पास इस एक्सटेंशन के लिए Modify अनुमति है, कुंजी बदल सकते हैं। ब्लॉक के पाठ एडमिन भाषा का पालन करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

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

एक कुंजी एक डोमेन पर काम करती है: OpenCart कॉन्फ़िगरेशन का स्टोर पता। स्टोर से कुंजी हटाने से उसका डोमेन स्लॉट मुक्त नहीं होता। स्लॉट अपने vibefox.net खाते में मुक्त करें।

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

जब लाइसेंस की समय-सीमा समाप्त हो जाती है, तो एक्सटेंशन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण आवश्यक है। एडमिन Dashboard या Edit पेज खोलने पर स्थिति स्वतः दोबारा जाँची जाती है: कुंजी दर्ज होने के बाद पहले 14 दिनों तक दिन में एक बार, उसके बाद सप्ताह में एक बार। किसी cron जॉब की आवश्यकता नहीं है। एक्सटेंशन अनइंस्टॉल करने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती है।

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

PayFast does not appear at checkout: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, वर्तमान मोड का Merchant ID और Merchant Key भरा हुआ है, चेकआउट मुद्रा ZAR है, और ऑर्डर की राशि कम से कम R5.00 है। कुछ भी गायब होने पर सेटिंग्स पेज चेतावनी दिखाता है। यह भी जाँचें कि भुगतान का पता चयनित Geo Zone में है और ऑर्डर सेटिंग्स में तय Total तक पहुँचता है।

The payment went through, but the order stays without a status: PayFast भुगतान सूचना नहीं पहुँचा सका, या वह अस्वीकार कर दी गई। एक्सटेंशन पेज पर Log फ़ील्ड देखें; त्रुटियाँ और अस्वीकृत सूचनाएँ हमेशा दर्ज होती हैं, और Debug log हर चरण जोड़ता है। सामान्य कारण: स्टोर इंटरनेट से पहुँच योग्य नहीं है (बेसिक ऑथ, फ़ायरवॉल), PayFast और एक्सटेंशन में अलग-अलग पासफ़्रेज़, या लाइव मोड में किसी प्रॉक्सी या CDN के पीछे होने पर स्रोत जाँच। ऐसी स्थिति में Source check बंद करें।

The notification answers Invalid signature: एक्सटेंशन का पासफ़्रेज़ वह नहीं है जो PayFast में उस मोड के लिए सेट है जिसमें भुगतान हुआ था।

The notification answers Invalid source: सूचना किसी PayFast पते से नहीं आई, या कोई प्रॉक्सी या CDN वास्तविक पता छिपा रहा है। यदि आपका स्टोर किसी प्रॉक्सी या CDN के पीछे है, तो Source check बंद करें।

The notification answers Merchant mismatch or Order mismatch: भुगतान किसी अन्य PayFast खाते पर किया गया था, या यह इस भुगतान प्रयास से संबंधित नहीं है। कुछ नहीं बदला जाता।

The notification answers Order not found: यह भुगतान संदर्भ इस स्टोर के लिए अज्ञात है। कुछ नहीं बदला जाता।

The notification answers Confirmation unavailable, Busy or Temporary error: सर्वर पुष्टि के लिए PayFast तक नहीं पहुँचा जा सका, या उसी कार्ट की कोई अन्य सूचना ठीक उसी समय संसाधित हो रही थी, या ऑर्डर स्थिति सेट नहीं की जा सकी। PayFast सूचना दोबारा भेजता है। लॉग कारण दिखाता है।

The notification answers Not configured: जिस मोड में भुगतान शुरू हुआ था, उसके क्रेडेंशियल्स गायब हैं। उन्हें फिर से दर्ज करें, उदाहरण के लिए परीक्षण भुगतान के लिए सैंडबॉक्स क्रेडेंशियल्स।

The customer sees PayFast accepts payments in South African rand (ZAR) only: ऑर्डर किसी अन्य मुद्रा में है। ग्राहक को रैंड में भुगतान करने दें या कोई अन्य भुगतान विधि चुनने दें।

The customer sees This payment method is not available. Please reload the checkout page. चेकआउट सत्र अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान विधि बंद कर दी गई थी। ग्राहक को चेकआउट पेज दोबारा लोड करना होगा।

Order is in the on-hold status: VibeFox PayFast Pay Gateway टैब के नोट (देखें ऑर्डर स्थितियाँ अनुभाग) और अपना PayFast डैशबोर्ड पढ़ें, फिर भुगतान-पूर्ण स्थिति सेट करें या भुगतान रिफ़ंड करें।

A sandbox payment did not pay the order: गेटवे लाइव मोड में है। लाइव मोड में सैंडबॉक्स भुगतान कभी ऑर्डर का भुगतान नहीं करते; ऑर्डर पर एक नोट यह बताता है।

डेवलपरों के लिए: भुगतान फ़ॉर्म पर हस्ताक्षर करने से पहले, एक्सटेंशन फ़ॉर्म फ़ील्ड्स और ऑर्डर के साथ OpenCart इवेंट payfast_p_payment_data ट्रिगर करता है। इससे मर्चेंट क्रेडेंशियल्स, URLs, भुगतान संदर्भ, राशि और टोकन नहीं बदले जा सकते।

अनइंस्टॉल

Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox PayFast Pay Gateway के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटाई जाती हैं। OpenCart एक्सटेंशन की अपनी सेटिंग्स हमेशा हटाता है: Enable/Disable, Sort Order, Geo Zone, Total, और Orders अनुभाग की ऑर्डर स्थितियाँ, जो दोबारा इंस्टॉल करने पर अपने डिफ़ॉल्ट मानों पर लौट आती हैं। एक्सटेंशन का OpenCart इवेंट भी हटा दिया जाता है (OpenCart 4 पर उसके इवेंट और उसका startup action भी, जो मेंटेनेंस मोड में सूचना और ग्राहक की वापसी को जाने देता है)। यदि Delete the gateway settings when the extension is uninstalled चालू है, तो बाकी गेटवे सेटिंग्स (शीर्षक, विवरण, क्रेडेंशियल्स, पासफ़्रेज़, टेस्ट मोड, स्रोत जाँच, लॉगिंग), कैश्ड PayFast पते और लॉग हटा दिए जाते हैं। यदि यह बंद है, तो उन्हें बाद में दोबारा इंस्टॉल करने के लिए रखा जाता है। PayFast भुगतान रिकॉर्ड और ऑर्डर हमेशा रखे जाते हैं। मौजूदा ऑर्डर अपने भुगतान नोट बनाए रखते हैं।

OpenCart 4 पर, एक्सटेंशन की फ़ाइलें भी हटाने के लिए अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल किए गए एक्सटेंशन की सूची में VibeFox PayFast Pay Gateway के बगल में Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किया गया पैकेज हटाने के लिए Delete (लाल कूड़ेदान बटन) पर क्लिक करें।

PayFast उसके संबंधित स्वामी का ट्रेडमार्क है। यह एक्सटेंशन PayFast से संबद्ध नहीं है और PayFast द्वारा समर्थित नहीं है।