VibeFox Pesapal for OpenCart — सहायता
आवश्यकताएँ
OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या 4.0.2 और उसके बाद का संस्करण (4.1.0.3 पर परीक्षण किया गया)।
PHP: 8.0 या उसके बाद का संस्करण।
मुद्रा: ऑर्डर KES, UGX, TZS, ZMW, RWF या USD में होना चाहिए। अन्य मुद्राओं में चेकआउट पर भुगतान विधि छिपी रहती है। ऑर्डर उसकी अपनी मुद्रा में चार्ज होता है; एक्सटेंशन मुद्राओं का रूपांतरण नहीं करता। राशियाँ मुख्य इकाइयों में भेजी जाती हैं और मुद्रा की परिशुद्धता के अनुसार गोल की जाती हैं (UGX और RWF में दशमलव नहीं होते)।
Pesapal खाता: आपको Pesapal मर्चेंट खाते की consumer key और consumer secret चाहिए। Sandbox और लाइव कुंजियाँ अलग होती हैं। Sandbox कुंजियाँ cybqa.pesapal.com पर एक डेमो मर्चेंट खाते से मिलती हैं (Pesapal अपने डेवलपर पोर्टल पर भी डेमो कुंजियाँ प्रकाशित करता है)। लाइव कुंजियाँ आपके Pesapal मर्चेंट डैशबोर्ड से मिलती हैं। Pesapal डैशबोर्ड में और कुछ सेट करने की आवश्यकता नहीं है: एक्सटेंशन अपना नोटिफ़िकेशन URL स्वयं पंजीकृत करता है। आपका स्टोर इंटरनेट से पहुँच योग्य होना चाहिए, क्योंकि Pesapal उसे भुगतान की सूचनाएँ भेजता है।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
डाउनलोड एक zip फ़ाइल है, जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। उसे अपने कंप्यूटर पर अनज़िप करें। उसमें README.txt, OpenCart 3 का पैकेज wcp_pesapal_pay-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज wcp_pesapal_pay.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।
OpenCart 3
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_pesapal_pay-oc3-(version).ocmod.zip चुनें। इस एक्सटेंशन में कोई OCMOD संशोधन नहीं है, इसलिए Extensions > Modifications को रीफ़्रेश करने की ज़रूरत नहीं है। इंस्टॉलर के बजाय, आप इस पैकेज के upload फ़ोल्डर की सामग्री को अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।
2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Pesapal Pay Gateway ढूँढें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन उपयोगकर्ता के पास भुगतान एक्सटेंशन की सूची बदलने का अधिकार होना चाहिए।
3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। अपनी VibeFox लाइसेंस कुंजी को पेज के ऊपर लाइसेंस ब्लॉक में License key में चिपकाएँ और Activate पर क्लिक करें (देखें License key)।
4. Sandbox consumer key और consumer secret दर्ज करें, Enable/Disable चालू करें, Save पर क्लिक करें और एक परीक्षण ऑर्डर दें।
5. लाइव consumer key और consumer secret दर्ज करें, Sandbox mode बंद करें और असली भुगतान स्वीकार करने के लिए Save पर क्लिक करें।
OpenCart 4
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_pesapal_pay.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।
2. इंस्टॉल किया गया पैकेज उसी पेज पर इंस्टॉल किए गए एक्सटेंशनों की सूची में दिखता है। उसके बगल में Install (हरा + बटन) पर क्लिक करें।
3. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Pesapal Pay Gateway ढूँढें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर क्लिक करें।
4. लाइसेंस कुंजी और Pesapal कुंजियाँ वैसे ही डालें जैसे OpenCart 3 के चरण 3 से 5 में बताया गया है। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल IPN URL अलग है (देखें भुगतान सूचनाएँ)।
नई इंस्टॉलेशन में भुगतान विधि बंद और sandbox मोड चालू रहता है।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Pesapal Pay Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सहेजता है। सेटिंग्स के ऊपर एक बैज मोड दिखाता है: SANDBOX — cybqa.pesapal.com पर परीक्षण भुगतान — कोई असली धन नहीं काटा जाता। या LIVE — pay.pesapal.com पर असली भुगतान। जब वर्तमान मोड की कुंजियाँ गायब हों तो चेतावनी दिखती है (Sandbox consumer key और secret दर्ज करें — तब तक चेकआउट पर Pesapal नहीं दिखेगा।, या लाइव के लिए वही संदेश), और तब भी जब Pesapal आपके स्टोर की डिफ़ॉल्ट मुद्रा का समर्थन न करे। एक्सटेंशन बदलने के अधिकार के बिना पेज सेटिंग्स दिखाता है, पर उन्हें सहेज नहीं सकता।
सहेजते समय खाली Title स्वीकार नहीं होता: पिछला शीर्षक एक त्रुटि के साथ बना रहता है, और बाकी फ़ील्ड सहेजे जाते हैं। Sort Order पूर्ण संख्या होनी चाहिए (ऋणात्मक मान अनुमत हैं), Total 0 या उससे बड़ी संख्या, और Geo Zone तथा ऑर्डर स्टेटस मौजूद होने चाहिए; अन्यथा वह फ़ील्ड अपना पिछला मान रखता है और त्रुटि दिखाता है। सहेजने पर कैश किए गए Pesapal एक्सेस टोकन हटा दिए जाते हैं।
Pesapal
Enable/Disable: Enable Pesapal भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: भुगतान विधि का नाम, जो ग्राहक चेकआउट पर देखते हैं। यही नाम ऑर्डर में भुगतान विधि के रूप में भी सहेजा जाता है। डिफ़ॉल्ट: Pesapal (M-Pesa, Airtel Money, cards)। अनिवार्य, अधिकतम 128 अक्षर।
Description: Confirm Order चरण में पुष्टि बटन के ऊपर ग्राहक को दिखाया गया पाठ। डिफ़ॉल्ट: Pay securely with M-Pesa, Airtel Money, card or bank via Pesapal. You will be redirected to Pesapal to complete the payment.
Sort Order: चेकआउट पर भुगतान विधियों के बीच Pesapal की स्थिति। खाली छोड़ें या पूर्ण संख्या लिखें।
Geo Zone: Pesapal को केवल चुने हुए geo zone के भुगतान पते के लिए दिखाएँ। डिफ़ॉल्ट: All zones। Geo zones System > Localisation > Geo Zones में सेट किए जाते हैं।
Total: स्टोर की डिफ़ॉल्ट मुद्रा में चेकआउट की वह राशि जिस तक पहुँचने पर ही Pesapal दिखाया जाए। किसी भी राशि पर Pesapal दिखाने के लिए खाली छोड़ें।
API क्रेडेंशियल
इस सेक्शन में बताया गया है कि कुंजियाँ कहाँ से मिलेंगी, और cybqa.pesapal.com तथा pesapal.com के लिंक दिए गए हैं। Sandbox और लाइव कुंजियाँ अलग-अलग फ़ील्ड में दर्ज करें।
Sandbox mode: Use the Pesapal sandbox (no real money)। चालू होने पर नए भुगतान sandbox कुंजियों के साथ cybqa.pesapal.com पर होते हैं। असली भुगतान लाइव कुंजियों के साथ pay.pesapal.com पर स्वीकार करने के लिए इसे बंद करें। डिफ़ॉल्ट: चालू।
Sandbox consumer key: आपके sandbox (डेमो) मर्चेंट खाते की consumer key। केवल sandbox मोड में उपयोग होती है।
Sandbox consumer secret: आपके sandbox मर्चेंट खाते का consumer secret। केवल sandbox मोड में उपयोग होता है।
Live consumer key: आपके Pesapal मर्चेंट डैशबोर्ड की consumer key। तब उपयोग होती है जब sandbox मोड बंद हो।
Live consumer secret: आपके Pesapal मर्चेंट डैशबोर्ड का consumer secret। तब उपयोग होता है जब sandbox मोड बंद हो।
सहेजी गई कुंजियाँ और सीक्रेट दोबारा कभी नहीं दिखाए जाते। फ़ील्ड खाली रहता है और सहेजा गया — रखने के लिए खाली छोड़ें। दिखाता है। केवल बदलने के लिए ही नया मान दर्ज करें।
Clear saved consumer keys and secrets: कुंजी सहेजे होने पर दिखता है। बॉक्स चिह्नित करें और सहेजी गई चारों कुंजियाँ व सीक्रेट हटाने के लिए Save पर क्लिक करें।
मोड या कुंजियाँ बदलने पर दूसरे मोड या दूसरी कुंजियों का एक्सेस टोकन या नोटिफ़िकेशन ID कभी दोबारा उपयोग नहीं होता। एक मोड में शुरू हुआ भुगतान हमेशा उसी मोड में जाँचा जाता है, मोड बदलने के बाद भी।
ऑर्डर स्टेटस
OpenCart Confirm Order चरण पर ऑर्डर बिना स्टेटस के बनाता है (लापता ऑर्डर)। ऑर्डर को स्टेटस तभी मिलता है जब Pesapal भुगतान को Completed बताए। नीचे का हर फ़ील्ड आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध करता है।
Order Status After Payment: Pesapal द्वारा भुगतान की पुष्टि होने पर सेट होने वाला स्टेटस। डिफ़ॉल्ट: Processing।
Pesapal Payment On Hold Status: ऐसे भुगतान जिनकी राशि या मुद्रा ऑर्डर से मेल नहीं खाती, और रद्द होने के बाद मिले भुगतान। एक नोट कारण बताता है। डिफ़ॉल्ट: Pending, क्योंकि OpenCart में On hold स्टेटस नहीं है। आप System > Localisation > Order Statuses में अपना स्टेटस बना सकते हैं और यहाँ चुन सकते हैं।
Cancelled Order Status: इस स्टेटस (या रिफ़ंड स्टेटस) वाले ऑर्डर के लिए आया Pesapal भुगतान ऑर्डर को चुपचाप दोबारा खोलने के बजाय होल्ड पर रखता है। डिफ़ॉल्ट: Canceled।
Refunded Status: तब सेट होता है जब Pesapal ऑर्डर के भुगतान के उलटे जाने की सूचना देता है। डिफ़ॉल्ट: Refunded।
भुगतान सूचनाएँ (IPN)
IPN URL: आपके स्टोर का नोटिफ़िकेशन URL दिखाता है। यह कुछ इस तरह दिखता है: https://your-store/index.php?route=extension/payment/wcp_pesapal_pay/ipn जैसा, और OpenCart 4 में https://your-store/index.php?route=extension/wcp_pesapal_pay/payment/wcp_pesapal_pay.ipn जैसा। यह आपकी OpenCart इंस्टॉलेशन के storefront पते से बनता है। यह URL पहले भुगतान पर Pesapal के साथ अपने-आप पंजीकृत हो जाता है, sandbox और लाइव के लिए अलग-अलग, और हर consumer key के लिए अलग से, इसलिए कुछ कॉन्फ़िगर करने की ज़रूरत नहीं है। पहले भुगतान के बाद सेक्शन Registered IPN ID: के साथ वह ID दिखाता है जो Pesapal ने लौटाया; उससे पहले वह वर्तमान मोड और कुंजियों के लिए अभी पंजीकृत नहीं। कहता है। यह URL इंटरनेट से पहुँच योग्य होना चाहिए: उसके सामने कोई फ़ायरवॉल या पासवर्ड सुरक्षा न हो। स्टोर मेंटेनेंस मोड में होने पर भी यह काम करता रहता है, क्योंकि OpenCart भुगतान एक्सटेंशन के अनुरोधों को आगे जाने देता है (OpenCart 4 पर एक्सटेंशन इसके लिए अपनी स्टार्टअप ऐक्शन जोड़ता है, जो ग्राहक की Pesapal से वापसी को भी जाने देती है)।
एडवांस्ड
Debug log: Pesapal के अनुरोध और सूचनाएँ OpenCart के लॉग फ़ोल्डर (storage/logs) में pesapal_p_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खोली जा सकती, और 5 MB पर यह pesapal_p_debug.old.log.php में ले जाई जाती है। त्रुटियाँ और चेतावनियाँ स्विच बंद होने पर भी हमेशा लॉग होती हैं। कुंजियाँ, टोकन और ग्राहक डेटा कभी लॉग नहीं होते। डिफ़ॉल्ट: बंद।
Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।
Delete data: एक्सटेंशन अनइंस्टॉल होने पर एक्सटेंशन की सेटिंग्स और लॉग हटा देता है। ऑर्डर पर सहेजा गया Pesapal डेटा (ट्रैकिंग ID, नोट) भुगतान इतिहास का हिस्सा है और हमेशा रखा जाता है। एक्सटेंशन बंद करने से कुछ नहीं हटता। डिफ़ॉल्ट: बंद।
इंपोर्ट / एक्सपोर्ट
Export: Download JSON सेटिंग्स को JSON फ़ाइल के रूप में सहेजता है। consumer key और consumer secret एक्सपोर्ट नहीं होते।
Import: पहले एक्सपोर्ट किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सहेजी गई consumer key और consumer secret बनी रहती हैं।
चेकआउट
Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Pesapal (M-Pesa, Airtel Money, cards))। Confirm Order चरण पर ग्राहक आपका विवरण देखता है। OpenCart इस चरण पर ऑर्डर बनाता है, तब भी बिना स्टेटस के। OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, Payment method options विंडो में भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर की मुद्रा में ऑर्डर कुल के लिए एक Pesapal भुगतान अनुरोध बनाता है, भुगतान पते का बिलिंग विवरण (OpenCart 4 पर, जब चेकआउट भुगतान पता नहीं माँगता, तो शिपिंग पते का) जोड़ता है, और ग्राहक को Pesapal के भुगतान पेज पर भेजता है। Pesapal को भेजा गया भुगतान विवरण Order, ऑर्डर नंबर और स्टोर का नाम होता है। वहाँ ग्राहक Pesapal द्वारा दिए गए किसी एक तरीके से भुगतान करता है, जैसे M-Pesa, Airtel Money, MTN, कार्ड या बैंक। ऑर्डर पर एक नोट भुगतान अनुरोध दर्ज करता है।
ऑर्डर को भुगतान किया हुआ तभी चिह्नित किया जाता है जब Pesapal पुष्टि करे। Pesapal की सूचनाओं और ग्राहक की वापसी में कोई भुगतान डेटा या हस्ताक्षर नहीं होता, इसलिए एक्सटेंशन उन पर भरोसा नहीं करता: हर एक के लिए वह भुगतान जिस मोड में शुरू हुआ था उसी में, प्रमाणित सर्वर-से-सर्वर अनुरोध द्वारा Pesapal से लेन-देन की स्थिति पूछता है। वह यह भी जाँचता है कि लेन-देन इसी ऑर्डर का है, और भुगतान की गई राशि व मुद्रा ऑर्डर से मेल खाती हैं। फिर ऑर्डर को OpenCart के सामान्य तरीके से स्टेटस मिलता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट होता है, और ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है।
मोबाइल मनी भुगतान में कुछ समय लग सकता है। यदि ग्राहक के लौटने तक Pesapal ने भुगतान की पुष्टि नहीं की है, तो एक Payment confirmation पेज दिखता है जिस पर Pesapal आपके भुगतान की पुष्टि कर रहा है। पुष्टि होते ही आपको एक ईमेल मिलेगा — दोबारा भुगतान करने की ज़रूरत नहीं है। संदेश और Check again तथा Back to checkout बटन दिखते हैं। Pesapal की सूचना भुगतान की पुष्टि होते ही ऑर्डर स्टेटस सेट कर देती है। यदि ऑर्डर होल्ड पर रखा गया था, तो सफलता पेज दिखाता है: आपका भुगतान प्राप्त हो गया है और स्टोर द्वारा जाँचा जा रहा है। ऑर्डर की पुष्टि होने पर आपको एक ईमेल मिलेगा। जब कोई बाद का भुगतान ऑर्डर को होल्ड स्टेटस से भुगतान किए गए स्टेटस में ले जाता है, तो ग्राहक को ईमेल से सूचित किया जाता है।
यदि ग्राहक Pesapal पेज पर रद्द करता है, तो वह Pesapal भुगतान रद्द कर दिया गया। आप दोबारा प्रयास कर सकते हैं या कोई दूसरी भुगतान विधि चुन सकते हैं। संदेश के साथ चेकआउट पर लौट आता है। यदि भुगतान विफल होता है, तो संदेश होता है Pesapal भुगतान सफल नहीं हुआ। कृपया दोबारा प्रयास करें या कोई दूसरी भुगतान विधि चुनें। और ऑर्डर पर एक नोट कारण बताता है। कार्ट बना रहता है और ग्राहक दोबारा भुगतान कर सकता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखते हैं। OpenCart 3 हर बार Confirm Order चरण दिखने पर नया ऑर्डर बनाता है, OpenCart 4 चेकआउट के ऑर्डर को अपडेट करता है, इसलिए नए भुगतान से पहले एक्सटेंशन Pesapal पर कार्ट के पिछले प्रयास जाँचता है: यदि उनमें से कोई इस बीच भुगतान हो चुका है, तो वह ऑर्डर स्टेटस पाता है और ग्राहक बिना दोबारा भुगतान किए सफलता पेज पर जाता है। कार्ट के किसी पुराने Pesapal पेज पर बाद में किया गया भुगतान तब भी स्वीकार किया जाता है। कार्ट में कोई भी बदलाव, जिसमें नई मात्रा भी शामिल है, एक नया कार्ट माना जाता है जिसके लिए अपना भुगतान ज़रूरी है।
OpenCart 4 में ऑर्डर सफलता पेज दिखाए जाने तक चेकआउट में रखा जाता है। यदि वह ऑर्डर इस बीच बंद हो गया (उदाहरण के लिए आपने उसे रद्द किया), या वह किसी पिछले कार्ट के लिए भुगतान किया हुआ था और तब से कार्ट बदल गया है, तो ग्राहक संदेश Your previous order is already closed. Please confirm the order again: the cart will be paid with a new order. के साथ चेकआउट पर लौट जाता है। अगला Confirm Order एक नए ऑर्डर का भुगतान करता है। बंद किया गया ऑर्डर कभी भुगतान किया हुआ नहीं दिखाया जाता।
यदि Pesapal भुगतान शुरू नहीं कर पाता, तो ग्राहक Confirm Order चरण पर रहता है और बटन के ऊपर एक छोटा संदेश देखता है, जैसे Pesapal अस्थायी रूप से उपलब्ध नहीं है। कुछ मिनट बाद दोबारा प्रयास करें या कोई दूसरी भुगतान विधि चुनें।, Pesapal अभी उपलब्ध नहीं है। कृपया कोई दूसरी भुगतान विधि चुनें। (गलत कुंजियाँ), या Pesapal भुगतान शुरू नहीं कर सका: के बाद Pesapal द्वारा बताया गया कारण। तकनीकी कारण लॉग और ऑर्डर नोट में लिखा जाता है। ऑर्डर कुल शून्य से अधिक होना चाहिए।
इस एक्सटेंशन में आपकी अपनी साइट पर भुगतान फ़ॉर्म नहीं है (ग्राहक हमेशा Pesapal पेज पर भुगतान करता है), सेव किए गए कार्ड नहीं हैं, सब्सक्रिप्शन या आवर्ती भुगतान नहीं हैं, और मुद्रा रूपांतरण नहीं है।
ऑर्डर और रिफ़ंड
ऑर्डर स्टेटस
कोई स्टेटस नहीं (लापता ऑर्डर): ग्राहक Pesapal पर भेजा गया और उसने भुगतान नहीं किया, भुगतान विफल हुआ, या Pesapal ने अभी भुगतान की पुष्टि नहीं की है। Sales > Orders में ऐसे ऑर्डर केवल तब दिखते हैं जब Order Status फ़िल्टर Missing Orders पर सेट हो।
Order Status After Payment (डिफ़ॉल्ट Processing): Pesapal भुगतान को Completed बताता है, और राशि व मुद्रा मेल खाती हैं। एक नोट राशि, भुगतान विधि, Pesapal पुष्टि कोड और ट्रैकिंग ID दिखाता है। हर भुगतान केवल एक बार लागू होता है।
Pesapal Payment On Hold Status (डिफ़ॉल्ट Pending): भुगतान की गई राशि या मुद्रा ऑर्डर से अलग है (नोट Pesapal amount/currency mismatch — held for review), या रद्द या रिफ़ंड स्टेटस वाले ऑर्डर के लिए पैसा आया है। Pesapal डैशबोर्ड में भुगतान जाँचें, फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।
Refunded Status (डिफ़ॉल्ट Refunded): Pesapal बताता है कि जिस भुगतान से ऑर्डर चुकाया गया था, वह उलट दिया गया है। किसी दूसरे प्रयास का उलटाव केवल ऑर्डर पर नोट किया जाता है।
यदि पहले से भुगतान किए गए ऑर्डर या कार्ट के लिए दूसरा भुगतान भी पूरा हो जाता है, तो ऑर्डर नहीं बदलता। भुगतान किए गए ऑर्डर पर एक नोट आपसे Pesapal डैशबोर्ड में दूसरा भुगतान रिफ़ंड करने के लिए कहता है। रद्द और रिफ़ंड किए गए ऑर्डर कभी अपने-आप दोबारा नहीं खुलते।
नोट ऑर्डर के History की वे प्रविष्टियाँ हैं जो ग्राहक को दिखाई नहीं देतीं।
VibeFox Pesapal Pay Gateway tab
Sales > Orders में Pesapal से भुगतान किया हुआ ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Pesapal Pay Gateway टैब में Sandbox या Live लेबल वाला ट्रैकिंग ID, मर्चेंट रेफ़रेंस, Pesapal स्टेटस, भुगतान विधि, पुष्टि कोड, माँगी गई और भुगतान की गई राशि, समीक्षा का कारण, ऑर्डर के सभी Payment attempts (जब एक से अधिक हों) और Payment notes दिखते हैं। यह टैब केवल-पढ़ने योग्य है और उन उपयोगकर्ताओं को दिखता है जिनके पास एक्सटेंशन की पहुँच है।
रिफ़ंड
एक्सटेंशन Pesapal को रिफ़ंड नहीं भेजता। Pesapal डैशबोर्ड में भुगतान रिफ़ंड करें, फिर OpenCart में रिफ़ंड को मैन्युअल रूप से दर्ज करें। Sales > Returns में उत्पाद की वापसी Pesapal के माध्यम से पैसे वापस नहीं भेजती।
लाइसेंस कुंजी
यह एक्सटेंशन vibefox.net की VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Pesapal Pay Gateway, Extensions > Extensions > Payments > VibeFox Pesapal Pay Gateway > Edit का पहला ब्लॉक है, सेटिंग्स के ऊपर। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक में मास्क की गई कुंजी, स्टेटस (जैसे वह तारीख जब तक लाइसेंस सक्रिय है और आपका डोमेन), और ये बटन दिखते हैं: स्टेटस दोबारा जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: opencart-payment-pesapal वाली पंक्ति और वह लिंक है जो आपका 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 खाते में स्लॉट मुक्त करें।
सक्रिय कुंजी के बिना चेकआउट पर ग्राहकों को Pesapal नहीं दिखता। फिर भी यदि भुगतान शुरू हो जाए, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। उसी ब्राउज़र में एडमिन में लॉग इन एक एडमिन उपयोगकर्ता को स्टोर में भुगतान विधि अब भी दिखती है, जिस पर (unlicensed — visible to admins only) का चिह्न होता है, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट अप और परीक्षण कर सकें। OpenCart 4 पर यह पूर्वावलोकन उपलब्ध नहीं है: स्टोर को एडमिन लॉगिन दिखाई नहीं देता, इसलिए सक्रिय कुंजी के बिना भुगतान विधि सभी के लिए छिपी रहती है। Edit पेज एक बार खोलने के बाद, एडमिन Dashboard पर एक अनुस्मारक दिखता है। उसे × से बंद करने पर वह 7 दिनों के लिए छिप जाता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले शुरू हो चुके हैं वे अब भी पुष्ट होते हैं, और मौजूदा भुगतानों से जुड़ी Pesapal सूचनाएँ, जिनमें उलटाव भी शामिल हैं, अब भी लागू होती हैं।
जब लाइसेंस की समय-सीमा समाप्त होती है, तो एक्सटेंशन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। एडमिन Dashboard या Edit पेज खोलने पर स्टेटस अपने-आप दोबारा जाँचा जाता है: कुंजी दर्ज होने के बाद पहले 14 दिनों तक रोज़ एक बार, फिर हर हफ़्ते एक बार। cron जॉब की ज़रूरत नहीं है। एक्सटेंशन अनइंस्टॉल करने पर लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हट जाते हैं।
समस्या निवारण
चेकआउट पर Pesapal दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, वर्तमान मोड की consumer key और secret दर्ज हैं (sandbox मोड में Sandbox consumer key और Sandbox consumer secret, लाइव मोड में Live consumer key और Live consumer secret) और ऑर्डर की मुद्रा KES, UGX, TZS, ZMW, RWF या USD है। सेटिंग्स के ऊपर की चेतावनियाँ समस्या बताती हैं। यह भी जाँचें कि भुगतान पता चुने हुए Geo Zone में है और ऑर्डर सेटिंग्स में तय Total तक पहुँचता है।
भुगतान हो गया, पर ऑर्डर बिना स्टेटस के रह गया: Pesapal की सूचना आपके स्टोर तक नहीं पहुँची और ग्राहक वापस नहीं आया। जाँचें कि IPN URL में दिखाया गया URL इंटरनेट से पहुँच योग्य है (उसके सामने कोई फ़ायरवॉल या पासवर्ड सुरक्षा न हो)। Debug log चालू करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें।
स्टोर सूचनाओं का उत्तर कैसे देता है: संसाधित सूचना का उत्तर HTTP 200 से दिया जाता है। यदि एक्सटेंशन उसे संसाधित नहीं कर सकता, तो वह त्रुटि से उत्तर देता है, और Pesapal बाद में सूचना दोबारा भेजता है: 400 (ट्रैकिंग ID गायब या गलत बना है), 404 (इस स्टोर के किसी ऑर्डर में यह ट्रैकिंग ID नहीं है), 409 (लेन-देन किसी दूसरे मर्चेंट रेफ़रेंस का है; कुछ नहीं बदला जाता), 502 (उस समय Pesapal API तक पहुँच नहीं हो पाई, या जिस मोड में भुगतान शुरू हुआ था उसकी कुंजियाँ गायब हैं) और 503 (ग्राहक की वापसी से उसी समय ऑर्डर संसाधित हो रहा था, या ऑर्डर स्टेटस सेट नहीं हो सका)।
ग्राहक को «Pesapal is not available at the moment» दिखता है: Pesapal ने वर्तमान मोड की consumer key या secret अस्वीकार कर दी। जाँचें कि कुंजियाँ मोड से मेल खाती हैं: sandbox कुंजियाँ केवल sandbox में, और लाइव कुंजियाँ केवल लाइव मोड में काम करती हैं। लॉग में Pesapal की त्रुटि दिखती है।
ग्राहक को «Pesapal is temporarily unavailable» दिखता है: Pesapal तक पहुँच नहीं हो पाई, या नोटिफ़िकेशन URL पंजीकृत नहीं हो सका। लॉग पढ़ें और दोबारा प्रयास करें।
ग्राहक को «This payment method is not available. Please reload the checkout page.» दिखता है: चेकआउट सत्र अब ऑर्डर से मेल नहीं खाता, या भुगतान विधि इस बीच बंद कर दी गई। ग्राहक चेकआउट पेज दोबारा लोड करता है।
ग्राहक को «We could not verify the Pesapal payment» दिखता है: Pesapal से आया वापसी लिंक स्टोर के किसी ऑर्डर से मेल नहीं खाया। यदि पैसे काटे गए हैं, तो Pesapal डैशबोर्ड में भुगतान ढूँढें और ग्राहक दोबारा भुगतान करे उससे पहले ऑर्डर जाँचें।
मोड बदलने के बाद पुराने मोड के भुगतान पुष्ट नहीं होते: भुगतान उन्हीं कुंजियों से जाँचा जाता है जिस मोड में वह शुरू हुआ था। उस मोड की कुंजियाँ तब तक दर्ज रहने दें जब तक उसके भुगतान पुष्ट न हो जाएँ।
भुगतान के बाद ऑर्डर होल्ड स्टेटस में है: VibeFox Pesapal Pay Gateway टैब के नोट पढ़ें। भुगतान की गई राशि या मुद्रा ऑर्डर से अलग थी, या ऑर्डर रद्द होने के बाद भुगतान आया। Pesapal डैशबोर्ड में भुगतान जाँचें, फिर ऑर्डर संसाधित करें या भुगतान रिफ़ंड करें।
डेवलपर्स के लिए: एक्सटेंशन OpenCart इवेंट pesapal_p_supported_currencies (मुद्राओं की सूची) और pesapal_p_submit_order_payload (Pesapal को भेजे जाने से पहले का भुगतान अनुरोध) ट्रिगर करता है।
अनइंस्टॉल
Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox Pesapal Pay Gateway के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटाए जाते हैं। OpenCart एक्सटेंशन की अपनी सेटिंग्स हमेशा हटाता है: Enable/Disable, Sort Order, Geo Zone, Total, और ऑर्डर स्टेटस सेक्शन के ऑर्डर स्टेटस, जो दोबारा इंस्टॉल करने पर डिफ़ॉल्ट पर लौट आते हैं। एक्सटेंशन का OpenCart इवेंट, कैश किए गए Pesapal एक्सेस टोकन और पंजीकृत नोटिफ़िकेशन ID भी हमेशा हटते हैं (OpenCart 4 पर उसके इवेंट और स्टार्टअप ऐक्शन भी, जो मेंटेनेंस मोड में सूचनाओं और ग्राहक की वापसी को जाने देती है, हटते हैं)। यदि Delete data चालू है, तो बाकी सेटिंग्स (शीर्षक, विवरण, sandbox मोड, कुंजियाँ, डीबग लॉग स्विच) और लॉग भी हट जाते हैं। यदि बंद है, तो वे बाद में दोबारा इंस्टॉल करने के लिए रखे जाते हैं। Pesapal भुगतान प्रयास हमेशा रखे जाते हैं। मौजूदा ऑर्डर अपने भुगतान नोट और Pesapal ट्रैकिंग ID रखते हैं।
OpenCart 4 पर एक्सटेंशन की फ़ाइलें भी हटाने के लिए अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल किए गए एक्सटेंशनों की सूची में VibeFox Pesapal Pay Gateway के बगल में Uninstall (नारंगी − बटन) पर क्लिक करें, और फिर अपलोड किया गया पैकेज हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।
Pesapal अपने-अपने स्वामी का ट्रेडमार्क है। यह एक्सटेंशन Pesapal से संबद्ध नहीं है और Pesapal द्वारा समर्थित नहीं है।