VibeFox PayMongo for OpenCart — सहायता

आवश्यकताएँ

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

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

मुद्रा: फ़िलीपींस पेसो (PHP)। PayMongo चेकआउट पर तभी दिखता है जब ग्राहक PHP में भुगतान करे और कुल कम से कम ₱100.00 हो। यदि आपके स्टोर में यह मुद्रा नहीं है, तो उसे System > Localisation > Currencies में जोड़ें। यदि आपके स्टोर की डिफ़ॉल्ट मुद्रा PHP नहीं है, तो सेटिंग्स पेज चेतावनी देता है, और PayMongo देखने के लिए ग्राहकों को PHP पर स्विच करना होगा।

PayMongo खाता: आपको अपने PayMongo खाते की secret API कुंजियाँ और हर मोड के लिए एक वेबहुक चाहिए (देखें Configuration)। केवल secret कुंजियाँ (sk_test_..., sk_live_...) और वेबहुक साइनिंग सीक्रेट (whsk_...) इस्तेमाल होती हैं। सार्वजनिक (public) कुंजियों की ज़रूरत नहीं है, क्योंकि भुगतान पेज PayMongo होस्ट करता है। आप जो भुगतान तरीके देते हैं, वे आपके PayMongo खाते में सक्रिय होने चाहिए।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. अपनी PayMongo secret कुंजियाँ चिपकाएँ, PayMongo में वेबहुक बनाएँ और उनके साइनिंग सीक्रेट चिपकाएँ (देखें Configuration)।

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

OpenCart 4

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

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

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

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

नया इंस्टॉल भुगतान तरीका बंद और test mode चालू के साथ शुरू होता है।

Configuration

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox PayMongo Payment Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर पेज चेतावनी देता है जब स्टोर की डिफ़ॉल्ट मुद्रा PHP न हो, जब वर्तमान मोड में secret कुंजी न हो (तब चेकआउट पर PayMongo नहीं दिखता) या वेबहुक सीक्रेट न हो (तब भुगतान की पुष्टि तभी होती है जब ग्राहक आपके स्टोर पर लौटे), और test mode चालू होने पर Test mode is on: no real payments are made. दिखाता है।

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

PayMongo

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

Title: वह भुगतान तरीके का नाम जो ग्राहक चेकआउट पर देखता है। ऑर्डर में भी यही भुगतान तरीके का नाम सेव होता है। डिफ़ॉल्ट: PayMongo (Card, GCash, GrabPay, Maya)। अनिवार्य, 128 अक्षरों तक।

Description: Confirm Order चरण पर, पुष्टि बटन के ऊपर ग्राहक को दिखाया गया पाठ। डिफ़ॉल्ट: You will be redirected to PayMongo to pay securely with your card, GCash, GrabPay or Maya.

Payment methods: PayMongo भुगतान पेज पर दिए जाने वाले तरीके। केवल वही चुनें जो आपके PayMongo खाते में सक्रिय हैं, अन्यथा PayMongo चेकआउट को अस्वीकार कर देगा। यदि कोई भी न चुना जाए, तो डिफ़ॉल्ट इस्तेमाल होते हैं। डिफ़ॉल्ट: Cards, GCash, GrabPay और Maya।

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

Geo Zone: PayMongo केवल चुने गए geo zone के भुगतान पतों के लिए दें। डिफ़ॉल्ट: All zones। Geo zones System > Localisation > Geo Zones में सेट होते हैं।

Total: स्टोर की डिफ़ॉल्ट मुद्रा में चेकआउट कुल, जिस तक पहुँचने पर ही PayMongo दिया जाए, PayMongo की ₱100.00 न्यूनतम सीमा के अलावा। अतिरिक्त न्यूनतम न चाहिए तो खाली छोड़ें।

API keys

PayMongo Dashboard > Developers > API keys से secret कुंजियाँ कॉपी करें (वहाँ उस सेक्शन के लिंक हैं)। सार्वजनिक कुंजियों की ज़रूरत नहीं है। हर कुंजी अपेक्षित प्रीफ़िक्स से शुरू होनी चाहिए। गलत प्रीफ़िक्स वाला मान, जैसे टेस्ट फ़ील्ड में लाइव कुंजी, सेव नहीं होता: पेज दिखाता है कि फ़ील्ड को प्रीफ़िक्स से शुरू होना चाहिए, और The previous value was kept.

Test mode: Enable test mode (no real payments)। नए भुगतान टेस्ट कुंजियों का इस्तेमाल करते हैं। पहले किए गए भुगतान उसी मोड को बनाए रखते हैं जिसमें वे हुए थे, इसलिए स्टेटस जाँच और रिफ़ंड मेल खाती कुंजी इस्तेमाल करते हैं। डिफ़ॉल्ट: चालू। असली भुगतान लेने के लिए इसे बंद करें। चालू रहने पर ग्राहक Confirm Order चरण पर Test mode: no real payment will be made. देखता है।

Test secret key: test mode की secret कुंजी। यह sk_test_ से शुरू होती है।

Test webhook secret: test mode वेबहुक का साइनिंग सीक्रेट। यह whsk_ से शुरू होता है।

Live secret key: live mode की secret कुंजी। यह sk_live_ से शुरू होती है।

Live webhook secret: live mode वेबहुक का साइनिंग सीक्रेट। यह whsk_ से शुरू होता है।

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

Webhook

वेबहुक आपके स्टोर को बताता है कि भुगतान हो गया है, भले ही ग्राहक भुगतान के बाद ब्राउज़र बंद कर दे। हर मोड, टेस्ट और लाइव, के लिए PayMongo Dashboard (या PayMongo API के ज़रिए) में एक वेबहुक बनाएँ, जिसका URL इस सेक्शन में Webhook URL के नीचे दिखाया गया है। OpenCart 3 में यह कुछ इस तरह दिखता है: https://your-store/index.php?route=extension/payment/wcp_paymongo_payment_gateway/webhook, OpenCart 4 में https://your-store/index.php?route=extension/wcp_paymongo_payment_gateway/payment/wcp_paymongo_payment_gateway.webhook, और यह आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। URL को ठीक वैसा ही कॉपी करें जैसा सेटिंग्स दिखाती हैं।

ये इवेंट चुनें (ये इस सेक्शन में भी सूचीबद्ध हैं):

हर वेबहुक का साइनिंग सीक्रेट (whsk_...) Test webhook secret या Live webhook secret में कॉपी करें। वैध हस्ताक्षर के बिना वेबहुक अस्वीकार हो जाते हैं। हस्ताक्षर उसी मोड के सीक्रेट से जाँचा जाता है, और इवेंट का मोड उससे मेल खाना चाहिए, इसलिए टेस्ट वेबहुक कभी लाइव भुगतान की पुष्टि नहीं करता। ऑर्डर बदलने से पहले हर इवेंट को भुगतान के मोड की secret कुंजी से PayMongo API के ज़रिए फिर से जाँचा जाता है। इस स्टोर में शुरू न किए गए भुगतानों के इवेंट अनदेखे किए जाते हैं। वेबहुक के बिना, ऑर्डर की पुष्टि तभी होती है जब ग्राहक भुगतान के बाद स्टोर पर लौटे।

Orders

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

Order status after payment: सफल भुगतान के बाद सेट होने वाला स्टेटस। डिफ़ॉल्ट: Processing। Complete उन वर्चुअल या डाउनलोड होने वाले उत्पादों के लिए उपयुक्त है जिन्हें शिपिंग की ज़रूरत नहीं होती।

Awaiting PayMongo payment: ग्राहक PayMongo पेज पर पूरा हुआ, पर भुगतान अभी प्रोसेस हो रहा है (जैसे ऑनलाइन बैंकिंग)। वेबहुक या अगली जाँच ऑर्डर पूरा करती है। डिफ़ॉल्ट: Pending।

PayMongo payment on hold: राशि या मुद्रा का मेल न खाना, लाइव स्टोर पर टेस्ट भुगतान, या ऑर्डर रद्द होने के बाद पहुँचा भुगतान। एक नोट कारण बताता है। डिफ़ॉल्ट: Pending।

Failed status: लंबित भुगतान बाद में विफल हुआ (payment.failed)। बिना स्टेटस वाले ऑर्डर का विफल प्रयास उसे बिना स्टेटस के छोड़ देता है, और ग्राहक फिर से भुगतान कर सकता है। डिफ़ॉल्ट: Failed।

Cancelled status: रद्द किए गए ऑर्डर को दिया जाने वाला स्टेटस। बाद में आने वाला भुगतान ऑर्डर को पूरा करने के बजाय on hold में डालता है। डिफ़ॉल्ट: Canceled।

Refunded status: ऑर्डर टैब से भुगतान पूरी तरह रिफ़ंड होने के बाद सेट होता है। डिफ़ॉल्ट: Refunded।

Advanced

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

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

Delete data on uninstall: चालू होने पर एक्सटेंशन हटाने से गेटवे सेटिंग्स और लॉग मिट जाते हैं। ऑर्डर और रिफ़ंड के लिए सेव किए गए PayMongo ID हमेशा रहते हैं, क्योंकि रिफ़ंड और अकाउंटिंग के लिए उनकी ज़रूरत होती है। डिफ़ॉल्ट: बंद।

Import / Export

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

Import: पहले एक्सपोर्ट किया गया JSON चिपकाएँ और सेटिंग्स वापस लाने के लिए Import पर क्लिक करें। सेव की गई secret कुंजियाँ बनी रहती हैं।

चेकआउट

Payment Method चरण पर ग्राहक भुगतान तरीका चुनता है (डिफ़ॉल्ट रूप से PayMongo (Card, GCash, GrabPay, Maya))। Confirm Order चरण पर ग्राहक को आपका विवरण और यह नोट दिखता है: After you confirm the order you will be redirected to PayMongo to complete the payment. OpenCart इसी चरण पर ऑर्डर बनाता है, अभी भी बिना स्टेटस के। OpenCart 4 पर ग्राहक भुगतान तरीके के ब्लॉक के Choose बटन से, Payment method options विंडो में भुगतान तरीका चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है।

जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर कुल के लिए PHP में एक PayMongo चेकआउट सेशन (Checkout Session) बनाता है, जिसमें एक पंक्ति Order # और ऑर्डर नंबर होता है, और ग्राहक को PayMongo चेकआउट पेज पर भेजता है। ग्राहक का नाम, ई-मेल, फ़ोन और बिलिंग पता PayMongo को भेजे जाते हैं। वहाँ ग्राहक चुने गए तरीकों में से एक चुनता है और भुगतान करता है। ऑर्डर पर एक नोट PayMongo चेकआउट को दर्ज करता है।

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर को भुगतान किया हुआ तभी चिह्नित किया जाता है जब PayMongo पुष्टि कर दे: एक्सटेंशन ग्राहक के लौटने पर और वेबहुक आने पर PayMongo API से भुगतान की जानकारी माँगता है। इसके बाद ऑर्डर को OpenCart के सामान्य तरीके से स्टेटस मिलता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक को Your PayMongo payment has been received. के साथ OpenCart का ऑर्डर सफलता पेज दिखता है। यदि ग्राहक के लौटने पर PayMongo अभी भी भुगतान प्रोसेस कर रहा हो, तो ऑर्डर को awaiting स्टेटस मिलता है और पेज PayMongo is still processing your payment. Your order will be updated as soon as PayMongo confirms it — please do not pay again. दिखाता है। on-hold ऑर्डर के लिए यह Your payment was received and is being reviewed. We will update your order shortly. दिखाता है। यदि ग्राहक के लौटने पर PayMongo तक पहुँच न हो, तो एक Payment confirmation पेज कहता है: Your payment is being confirmed by PayMongo. You will receive an e-mail as soon as it is confirmed — please do not pay again. और उसमें Check again बटन होता है; वेबहुक आते ही ऑर्डर स्टेटस सेट कर देता है। जब कोई ऑर्डर awaiting स्टेटस से paid या भुगतान-विफलता स्टेटस पर जाता है, तो ग्राहक को सामान्य OpenCart ऑर्डर स्टेटस ईमेल मिलता है।

यदि ग्राहक PayMongo पेज पर रद्द करता है या भुगतान पूरा नहीं करता, तो वह You cancelled the PayMongo payment. You can try again or choose another payment method. या Your PayMongo payment was not completed. You can try again or choose another payment method. के साथ चेकआउट पर लौट आता है। कार्ट सुरक्षित रहता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखते हैं। नया प्रयास (OpenCart 3 हर बार Confirm Order चरण दिखने पर नया ऑर्डर बनाता है; OpenCart 4 चेकआउट का ऑर्डर अपडेट करता है) पहले पिछले प्रयास की जाँच करता है: यदि इस बीच उसका भुगतान हो चुका है, तो बिना नया भुगतान लिए पुष्टि कर दी जाती है; अन्यथा पिछला PayMongo भुगतान लिंक समाप्त हो जाता है, इसलिए एक ही कार्ट दो बार नहीं चुकाया जा सकता। जब तक पिछला भुगतान प्रोसेस हो रहा है, ग्राहक को Your previous PayMongo payment for this order is still being processed. Please wait a few minutes before trying again. दिखता है। यदि उसी कार्ट का कोई और ऑर्डर पहले ही भुगतान हो चुका है या भुगतान की प्रतीक्षा में है, तो ग्राहक सफलता पेज पर पहुँच जाता है। कार्ट में बदलाव, जिसमें नई मात्रा भी शामिल है, एक नई कार्ट माना जाता है जिसे अपना अलग भुगतान चाहिए।

OpenCart 4 सफलता पेज दिखने तक ऑर्डर को चेकआउट में रखता है। यदि वह ऑर्डर इस बीच बंद हो गया (उदाहरण के लिए आपने उसे रद्द किया), या किसी दूसरी कार्ट के लिए भुगतान हो गया, तो ग्राहक Your previous order is already closed. Please confirm the order again: the cart will be paid with a new order. संदेश के साथ चेकआउट पर वापस भेजा जाता है। अगला Confirm Order एक नया ऑर्डर भुगतान करता है। भुगतान किया गया ऑर्डर कभी किसी दूसरी कार्ट के लिए भुगतान किया हुआ नहीं दिखता।

यदि PayMongo भुगतान शुरू नहीं कर पाता, तो ग्राहक Confirm Order चरण पर रहता है और बटन के ऊपर एक छोटा संदेश दिखता है, उदाहरण के लिए The payment could not be started. Please try again or choose another payment method. या PayMongo could not be reached. Please try again in a moment. तकनीकी कारण लॉग में लिखा जाता है।

स्टोर के maintenance mode में होने पर भी वेबहुक काम करता है, क्योंकि OpenCart भुगतान एक्सटेंशन के अनुरोधों को आने देता है (OpenCart 4 पर एक्सटेंशन इसके लिए अपना startup action जोड़ता है, जो ग्राहक की PayMongo से वापसी को भी आने देता है)।

एक्सटेंशन PayMongo पेज पर एकमुश्त भुगतान स्वीकार करता है। आपके अपने चेकआउट पेज पर कार्ड फ़ील्ड नहीं हैं, सेव किए गए कार्ड नहीं हैं, सब्सक्रिप्शन या आवर्ती भुगतान नहीं हैं, किस्तें नहीं हैं, और अलग से authorize और capture की सुविधा नहीं है।

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

ऑर्डर स्टेटस

कोई स्टेटस नहीं (लापता ऑर्डर): ग्राहक को PayMongo पर भेजा गया और उसने भुगतान नहीं किया, या PayMongo ने अभी भुगतान की पुष्टि नहीं की है। Sales > Orders में ऐसे ऑर्डर केवल तब दिखते हैं जब Order Status फ़िल्टर Missing Orders पर सेट हो।

भुगतान के बाद का ऑर्डर स्टेटस (डिफ़ॉल्ट Processing): भुगतान की पुष्टि हो गई। एक नोट PayMongo भुगतान, राशि, तरीका, मोड और पुष्टि का तरीका (वेबहुक, वापसी या भुगतान पुनः प्रयास) दिखाता है।

PayMongo भुगतान का इंतज़ार (डिफ़ॉल्ट Pending): ग्राहक तब लौटा जब PayMongo अभी भी भुगतान प्रोसेस कर रहा था। PayMongo पुष्टि करने पर ऑर्डर paid स्टेटस में चला जाता है।

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

Failed स्टेटस (डिफ़ॉल्ट Failed): एक हस्ताक्षरित payment.failed वेबहुक ने बताया कि awaiting ऑर्डर का नवीनतम भुगतान प्रयास विफल रहा। नोट PayMongo का विफलता कोड और संदेश दिखाता है। यदि वही भुगतान बाद में सफल होता है, तो ऑर्डर paid स्टेटस में चला जाता है।

Refunded स्टेटस (डिफ़ॉल्ट Refunded): एक्सटेंशन के ज़रिए भुगतान पूरी तरह रिफ़ंड किया गया।

यदि पहले से भुगतान किए गए ऑर्डर, या पहले से भुगतान किए गए कार्ट के किसी दूसरे ऑर्डर के लिए दूसरा भुगतान आता है, तो भुगतान किया गया ऑर्डर नहीं बदलता। एक नोट आपसे PayMongo Dashboard में डुप्लीकेट भुगतान रिफ़ंड करने को कहता है। जो ऑर्डर भुगतान के बाद रद्द या रिफ़ंड हो गया, उसे कभी दोबारा नहीं खोला जाता।

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

VibeFox PayMongo Payment Gateway टैब

Sales > Orders में PayMongo से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox PayMongo Payment Gateway टैब PayMongo payment, PayMongo payment intent, PayMongo checkout, टेस्ट भुगतानों के लिए Test mode लेबल के साथ PayMongo mode, Status, Paid / refunded राशियाँ, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के Notes दिखाता है। यह टैब उन उपयोगकर्ताओं को दिखता है जिनके पास एक्सटेंशन की पहुँच है।

Refunds

VibeFox PayMongo Payment Gateway टैब में Amount दर्ज करें (जो राशि अभी तक रिफ़ंड नहीं हुई है, वह भर दी जाती है), वैकल्पिक रूप से Reason (optional), और Refund via PayMongo पर क्लिक करें। प्रश्न Refund this amount through PayMongo? This cannot be undone. की पुष्टि करें। पूर्ण और आंशिक रिफ़ंड समर्थित हैं, अधिकतम दो दशमलव तक। आपको एक्सटेंशन बदलने का अधिकार चाहिए (System > Users > User Groups में सेट)। रिफ़ंड उस राशि तक सीमित हैं जो PayMongo ने वास्तव में चार्ज की, इसलिए राशि मेल न खाने के बाद आप ऑर्डर कुल के बजाय उतना ही रिफ़ंड कर सकते हैं जितना ग्राहक ने चुकाया। रिफ़ंड उसी मोड (टेस्ट या लाइव) की secret कुंजी से भेजा जाता है जिसमें भुगतान हुआ था, इसलिए वह कुंजी सेट होनी चाहिए। यदि PayMongo रिफ़ंड स्वीकार नहीं करता, तो टैब त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड PayMongo रिफ़ंड ID और स्टेटस के साथ रिफ़ंड इतिहास और नोट्स में जुड़ता है। पूर्ण रिफ़ंड ऑर्डर को Refunded status पर सेट करता है, बिना ग्राहक को सूचित किए और बिना उत्पादों को स्टॉक में वापस लाए, जैसे मैनुअल स्टेटस बदलना। आंशिक रिफ़ंड स्टेटस नहीं बदलता।

Sales > Returns में उत्पाद वापसी PayMongo के ज़रिए पैसे वापस नहीं भेजती। PayMongo Dashboard में किए गए रिफ़ंड OpenCart को रिपोर्ट नहीं होते। इसके बजाय ऑर्डर टैब से रिफ़ंड करें या ऑर्डर मैनुअली अपडेट करें।

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

यह एक्सटेंशन vibefox.net की VibeFox लाइसेंस कुंजी के साथ काम करता है। License — VibeFox PayMongo Payment Gateway लाइसेंस ब्लॉक, Extensions > Extensions > Payments > VibeFox PayMongo Payment Gateway > Edit पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी License key में दर्ज करें और Activate पर क्लिक करें। उसके बाद ब्लॉक कुंजी को मास्क करके दिखाता है, स्थिति (जैसे वह तारीख जब तक लाइसेंस सक्रिय है और आपका डोमेन) दिखाता है, और ये बटन: Check now स्थिति फिर से जाँचने के लिए, Change key दूसरी कुंजी दर्ज करने के लिए और Remove key इस स्टोर से कुंजी हटाने के लिए। इनके नीचे Product: opencart-payment-paymongo की पंक्ति और आपके 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 खाते में स्लॉट खाली करें।

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

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

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

चेकआउट पर PayMongo नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, वर्तमान मोड में secret कुंजी है (टेस्ट मोड में Test secret key, लाइव मोड में Live secret key), ग्राहक PHP में भुगतान करता है और कुल कम से कम ₱100.00 है। यह भी जाँचें कि भुगतान पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स में दिए गए Total तक पहुँचता है।

भुगतान हो गया, पर ऑर्डर बिना स्टेटस के है: वेबहुक काम नहीं कर रहा और ग्राहक स्टोर पर वापस नहीं आया। PayMongo Dashboard में जाँचें कि जिस मोड का आप उपयोग करते हैं, उसमें एक वेबहुक है, उसका URL बिल्कुल वही है जो Webhook URL में दिखता है, और तीनों इवेंट चुने गए हैं। जाँचें कि उसका साइनिंग सीक्रेट सही फ़ील्ड (Test webhook secret या Live webhook secret) में है।

वेबहुक Invalid signature जवाब देता है: उस मोड का साइनिंग सीक्रेट गायब है या किसी दूसरे वेबहुक का है। वेबहुक का साइनिंग सीक्रेट उसके मोड के फ़ील्ड में चिपकाएँ।

वेबहुक Mode mismatch जवाब देता है: टेस्ट इवेंट को लाइव के रूप में साइन किया गया, या उल्टा। जाँचें कि हर वेबहुक सही मोड का है।

वेबहुक Temporary error जवाब देता है: भुगतान PayMongo API से जाँचा नहीं जा सका, उदाहरण के लिए भुगतान मोड की secret कुंजी गायब होने के कारण। PayMongo वेबहुक को अपने-आप दोबारा भेजता है।

वेबहुक Busy, retry जवाब देता है: उसी समय कोई दूसरा अनुरोध ऑर्डर की पुष्टि कर रहा था, या ऑर्डर स्टेटस सेट नहीं हो सका। PayMongo वेबहुक को अपने-आप दोबारा भेजता है। कारण Log में है।

वेबहुक Ignored जवाब देता है: इवेंट इस स्टोर में शुरू न किए गए भुगतान का है, या किसी दूसरे मोड का। कुछ नहीं बदलता।

ब्राउज़र में वेबहुक URL Method not allowed दिखाता है: यह सामान्य है। यह URL केवल PayMongo के अनुरोध स्वीकार करता है।

मान सेव नहीं हुआ: कुंजी गलत फ़ील्ड में चिपकाई गई। Secret कुंजियाँ sk_test_ या sk_live_ से शुरू होती हैं, वेबहुक सीक्रेट whsk_ से।

Confirm Order के बाद ग्राहक को त्रुटि दिखती है: एक्सटेंशन पेज पर Log फ़ील्ड देखें। गलत secret कुंजी का संदेश बताता है कि भुगतान तरीका अस्थायी रूप से उपलब्ध नहीं है। जो भुगतान तरीका आपके PayMongo खाते में सक्रिय नहीं है, उसके कारण PayMongo चेकआउट अस्वीकार करता है; उसे Payment methods से हटा दें। This payment method is not available. Please reload the checkout page. का अर्थ है कि चेकआउट सेशन अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान तरीका बंद किया गया था।

लाइव स्टोर पर टेस्ट भुगतान: स्टोर के लाइव मोड में होने पर आया टेस्ट भुगतान ऑर्डर को on-hold स्टेटस में डालता है, इस नोट के साथ कि कोई पैसा नहीं मिला। असली भुगतान टेस्ट मोड पर वापस जाने के बाद भी हमेशा पहचाने जाते हैं, और लाइव कुंजी से रिफ़ंड होते हैं।

भुगतान के बाद ऑर्डर on-hold स्टेटस में है: VibeFox PayMongo Payment Gateway टैब के नोट पढ़ें (देखें Order statuses), फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

टैब में रिफ़ंड फ़ॉर्म नहीं है: भुगतान अभी तक पुष्ट नहीं हुआ है, वह पूरी तरह रिफ़ंड हो चुका है, या आपके उपयोगकर्ता समूह को एक्सटेंशन बदलने का अधिकार नहीं है।

रिफ़ंड मोड से संबंधित संदेश के साथ विफल होता है: भुगतान टेस्ट या लाइव मोड में हुआ था, और उस मोड की secret कुंजी सेट नहीं है। उसे दर्ज करें और फिर से कोशिश करें।

डेवलपर्स के लिए: चेकआउट सेशन बनने से पहले एक्सटेंशन सेशन डेटा और ऑर्डर के साथ OpenCart इवेंट paymongo_p_checkout_session_data ट्रिगर करता है।

अनइंस्टॉल

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

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

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