VibeFox dLocal for OpenCart — सहायता

आवश्यकताएँ

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

PHP: 8.0 या उसके बाद का संस्करण।

dLocal Go खाता: आपको अपने dLocal Go खाते का API key और API secret चाहिए, जो dLocal Go डैशबोर्ड के Payment integration पेज से मिलेंगे: सैंडबॉक्स के लिए dashboard-sbx.dlocalgo.com, प्रोडक्शन के लिए dashboard.dlocalgo.com। सैंडबॉक्स और प्रोडक्शन के क्रेडेंशियल अलग होते हैं। यह एक्सटेंशन केवल dLocal Go के साथ काम करता है, enterprise dLocal Payments API के साथ नहीं।

मुद्राएँ और देश: एक्सटेंशन इन्हें सीमित नहीं करता। dLocal Go आपके dLocal Go खाते के अनुसार तय करता है कि ग्राहक के देश और ऑर्डर की मुद्रा के लिए कौन-से भुगतान तरीके दिखाए जाएँ।

पहुँच योग्य स्टोर: dLocal Go भुगतान और रिफ़ंड की सूचनाएँ अपने सर्वर से भेजता है, इसलिए सूचना URL इंटरनेट से HTTPS पर पहुँच योग्य होने चाहिए।

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

इंस्टॉलेशन

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

OpenCart 3

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

2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox dLocal Payment खोजें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन यूज़र के पास भुगतान एक्सटेंशन की सूची बदलने का अधिकार होना चाहिए।

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

4. सैंडबॉक्स के लिए API key और API secret दर्ज करें और असली भुगतान के लिए प्रोडक्शन के। Environment चुनें (देखें कॉन्फ़िगरेशन)।

5. Enable/Disable चालू करें और Save पर क्लिक करें। सैंडबॉक्स में एक टेस्ट भुगतान करें, फिर Environment को Production पर बदलें।

OpenCart 4

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

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

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

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

dLocal Go डैशबोर्ड में कुछ भी सेट करने की ज़रूरत नहीं है: सूचना और लौटने (return) के URL हर भुगतान और रिफ़ंड के साथ भेजे जाते हैं। नई इंस्टॉलेशन भुगतान तरीका बंद और सैंडबॉक्स चुने हुए के साथ शुरू होती है।

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

सभी सेटिंग्स एक्सटेंशन के पेज पर हैं: Extensions > Extensions > Payments > VibeFox dLocal Payment > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। जब तक चुने गए environment की API key और secret दर्ज नहीं होती, पेज चेतावनी देता है कि चेकआउट पर भुगतान तरीका छिपा रहेगा, जैसे: Enter the sandbox API key and secret: until then the payment method is hidden at checkout. (सैंडबॉक्स की API key और secret दर्ज करें: तब तक चेकआउट पर भुगतान तरीका छिपा रहेगा।) जब सैंडबॉक्स चुना हो और भुगतान तरीका सक्षम हो, तो Sandbox mode is active: payments are simulated, no money is charged. (सैंडबॉक्स मोड सक्रिय है: भुगतान सिम्युलेट किए जाते हैं, कोई पैसा नहीं काटा जाता।) दिखता है। एक्सटेंशन बदलने का अधिकार न हो, तो पेज सेटिंग्स दिखाता है पर उन्हें सेव नहीं कर सकता।

सेव करते समय Title खाली नहीं हो सकता और 128 अक्षरों से लंबा नहीं हो सकता, Sort Order पूर्णांक होना चाहिए, Total 0 या उससे अधिक की संख्या होनी चाहिए, और geo zone तथा ऑर्डर स्टेटस मौजूद होने चाहिए। नहीं तो कुछ भी सेव नहीं होता और पेज त्रुटि दिखाता है। यदि चुने गए environment की कुंजी और secret के बिना भुगतान तरीका सक्षम है, तो सेटिंग्स ऊपर की चेतावनी के साथ सेव हो जाती हैं।

dLocal Go

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

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

Description: वह पाठ जो ग्राहक को Confirm Order चरण पर, पुष्टि बटन के ऊपर दिखता है। डिफ़ॉल्ट: dLocal Go के माध्यम से स्थानीय कार्ड, बैंक ट्रांसफ़र या नकद से भुगतान करें।

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

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

Total: स्टोर की डिफ़ॉल्ट मुद्रा में वह कार्ट राशि, जिस तक पहुँचने पर ही dLocal Go दिखाया जाएगा। किसी भी राशि पर dLocal Go दिखाने के लिए खाली छोड़ें।

API क्रेडेंशियल

dLocal Go डैशबोर्ड के Payment integration से API key और API secret कॉपी करें: dashboard-sbx.dlocalgo.com (सैंडबॉक्स) या dashboard.dlocalgo.com (प्रोडक्शन)। इस सेक्शन में दोनों डैशबोर्ड के लिंक हैं।

Environment: नए भुगतानों के लिए कौन-से क्रेडेंशियल और dLocal Go के कौन-से सर्वर उपयोग होंगे।

किसी भुगतान के रिफ़ंड और सूचनाएँ हमेशा उसी environment के क्रेडेंशियल का उपयोग करते हैं जिसमें भुगतान हुआ था, इसलिए दूसरे environment के क्रेडेंशियल तब तक रखें जब तक उसके भुगतान खुले हैं या उनका रिफ़ंड हो सकता है।

Sandbox API Key: आपकी dLocal Go सैंडबॉक्स API key।

Sandbox API Secret: आपका dLocal Go सैंडबॉक्स API secret।

Production API Key: आपकी dLocal Go प्रोडक्शन API key।

Production API Secret: आपका dLocal Go प्रोडक्शन API secret।

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

भुगतान

Default country: dLocal Go ग्राहक के देश के भुगतान तरीके दिखाता है; यह देश पहले भुगतान पते से, फिर शिपिंग पते से लिया जाता है। यदि ऑर्डर में दोनों न हों, तो यही देश इस्तेमाल होता है। सूची में आपके स्टोर के देश दिखते हैं। डिफ़ॉल्ट: Uruguay।

Auto-complete orders: भुगतान किए गए ऑर्डरों को Paid Order Status की जगह Complete Order Status देता है। डिफ़ॉल्ट: बंद।

Notifications (IPN): सूचनाएँ आपके स्टोर को बताती हैं कि कोई भुगतान या रिफ़ंड बदल गया है। एक्सटेंशन हर भुगतान और रिफ़ंड के साथ सूचना URL dLocal Go को भेजता है, इसलिए dLocal Go डैशबोर्ड में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है। यह फ़ील्ड आपकी OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बने दोनों URL दिखाता है:

सूचनाएँ आपके API secret (HMAC-SHA256) से सत्यापित होती हैं। मान्य हस्ताक्षर के बिना सूचनाएँ अस्वीकार की जाती हैं। सूचना पर उसी environment के क्रेडेंशियल से हस्ताक्षर होना चाहिए जिसमें भुगतान हुआ था। इसके बाद भुगतान की स्थिति, राशि और मुद्रा हमेशा dLocal Go API से दोबारा पढ़ी जाती हैं; सूचना की सामग्री पर भरोसा नहीं किया जाता। बिना सूचनाओं के, ऑर्डर को तभी स्टेटस मिलता है जब ग्राहक स्टोर पर वापस आता है।

ऑर्डर

OpenCart Confirm Order चरण पर ऑर्डर बिना स्टेटस के बनाता है (एक लापता ऑर्डर)। dLocal Go द्वारा भुगतान की पुष्टि के बाद ही ऑर्डर को स्टेटस मिलता है। नीचे का हर फ़ील्ड आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध करता है।

Paid Order Status: पुष्ट भुगतान के बाद ऑर्डर का स्टेटस। डिफ़ॉल्ट: प्रसंस्करण में।

Complete Order Status: Auto-complete orders चालू होने पर पुष्ट भुगतान के बाद ऑर्डर का स्टेटस। डिफ़ॉल्ट: पूर्ण।

On Hold (Review) Status: ऐसे भुगतान जिनकी राशि या मुद्रा ऑर्डर से मेल नहीं खाती, या जो ऑर्डर रद्द होने के बाद आएँ, उन्हें यह स्टेटस और कारण समझाने वाला नोट मिलता है। डिफ़ॉल्ट: लंबित, क्योंकि OpenCart में On hold स्टेटस नहीं है। आप System > Localisation > Order Statuses में अपना स्टेटस बना सकते हैं और यहाँ चुन सकते हैं।

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

उन्नत

Debug log: dLocal Go के अनुरोध और सूचनाएँ OpenCart के logs फ़ोल्डर (storage/logs) में dlocal_p_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खुल सकती, और 5 MB पर इसे एक बैकअप फ़ाइल में ले जाया जाता है। API क्रेडेंशियल और व्यक्तिगत डेटा लॉग नहीं होते। त्रुटियाँ और चेतावनियाँ हमेशा लिखी जाती हैं; बाकी प्रविष्टियाँ केवल तब, जब यह विकल्प चालू हो। डिफ़ॉल्ट: बंद।

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

Delete data on uninstall: चालू होने पर एक्सटेंशन हटाने से गेटवे सेटिंग्स और लॉग हट जाते हैं। ऑर्डरों का भुगतान डेटा (dLocal भुगतान और रिफ़ंड) हमेशा बना रहता है, ताकि मौजूदा ऑर्डर काम करते रहें। डिफ़ॉल्ट: बंद।

इम्पोर्ट / एक्सपोर्ट

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

Import: पहले एक्सपोर्ट किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सेव किए गए API क्रेडेंशियल बने रहते हैं।

चेकआउट

Payment Method चरण पर ग्राहक भुगतान तरीका चुनता है (डिफ़ॉल्ट रूप से dLocal Go)। Confirm Order चरण पर ग्राहक आपका विवरण और नोट You will be redirected to the dLocal Go checkout page. (आपको dLocal Go चेकआउट पेज पर भेजा जाएगा।) देखता है। सैंडबॉक्स मोड में यह Sandbox mode: no real payment is made. (सैंडबॉक्स मोड: कोई असली भुगतान नहीं किया जाता।) भी दिखाता है। OpenCart इसी चरण पर ऑर्डर बनाता है, अभी भी बिना स्टेटस के। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर की मुद्रा में ऑर्डर कुल के लिए एक dLocal Go भुगतान बनाता है, ग्राहक का देश, नाम, ईमेल और फ़ोन साथ भेजता है, और ग्राहक को dLocal Go भुगतान पेज पर भेजता है। वहाँ ग्राहक अपने देश के किसी तरीके से भुगतान करता है। dLocal Go पेज पर भुगतान Order # और ऑर्डर नंबर के रूप में दिखता है। OpenCart 4 पर ग्राहक Payment method options विंडो में, भुगतान तरीका ब्लॉक के Choose बटन से भुगतान तरीका चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। यदि स्टोर भुगतान पता नहीं माँगता (OpenCart 4 का डिफ़ॉल्ट), तो शिपिंग पते का देश और ग्राहक का नाम उपयोग होते हैं।

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब dLocal Go पुष्टि करता है: हस्ताक्षरित सूचना से, या ग्राहक के लौटने पर सर्वर-साइड से dLocal Go API के अनुरोध से। वापसी के पते में भुगतान प्रयास का एक यादृच्छिक टोकन होता है। इसके बाद ऑर्डर OpenCart के सामान्य तरीके से स्टेटस पाता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक OpenCart का ऑर्डर सफलता पेज देखता है जिस पर Your payment with dLocal Go has been received. (आपका dLocal Go भुगतान प्राप्त हो गया है।) लिखा होता है। यदि ऑर्डर समीक्षा स्टेटस में डाला गया है, तो पेज पर Your dLocal Go payment has been received and is being reviewed by the store. You will be informed when your order is confirmed. (आपका dLocal Go भुगतान प्राप्त हो गया है और स्टोर द्वारा समीक्षा की जा रही है। ऑर्डर की पुष्टि होने पर आपको सूचित किया जाएगा।) दिखता है। यदि dLocal Go ने अभी तक भुगतान की पुष्टि नहीं की है (उदाहरण के लिए नकद वाउचर अभी भुगतान नहीं हुआ है, या dLocal Go तक पहुँचा नहीं जा सका), तो एक Payment confirmation पेज ग्राहक से दोबारा भुगतान न करने को कहता है और Check again तथा Back to checkout देता है। dLocal Go द्वारा भुगतान की पुष्टि होते ही ऑर्डर को स्टेटस मिल जाता है। OpenCart 4 पर, जब dLocal Go ग्राहक को वापस भेजता है तो ब्राउज़र स्टोर सेशन नहीं भेजता, इसलिए एक्सटेंशन पहले एक छोटा पेज दिखाता है जो स्टोर से उसी वापसी पते को दोबारा खोलता है: ग्राहक का कार्ट और लॉगिन बना रहता है।

यदि ग्राहक बिना भुगतान किए dLocal Go पेज छोड़ देता है, तो वह चेकआउट पर लौटता है और The payment at dLocal Go was not completed. You can try again or choose another payment method. (dLocal Go पर भुगतान पूरा नहीं हुआ। आप दोबारा कोशिश कर सकते हैं या कोई दूसरा भुगतान तरीका चुन सकते हैं।) देखता है। यदि भुगतान अस्वीकृत हुआ या उसकी समय-सीमा समाप्त हो गई, तो संदेश है Your dLocal payment was not completed: it was declined or it expired. Please try again or choose another payment method. (आपका dLocal भुगतान पूरा नहीं हुआ: यह अस्वीकृत हुआ या इसकी समय-सीमा समाप्त हो गई। कृपया दोबारा कोशिश करें या कोई दूसरा भुगतान तरीका चुनें।) OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखाए जाते हैं। कार्ट सुरक्षित रहता है। Confirm Order पर हर क्लिक एक नया dLocal Go भुगतान बनाता है। OpenCart 3 हर बार Confirm Order चरण दिखने पर एक नया ऑर्डर बनाता है, OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसे अपडेट करता है, इसलिए नया भुगतान उसी ऑर्डर का होता है। पुराना भुगतान लिंक अब भी चुकाया जा सकता है और अपने ऑर्डर की पुष्टि करता है। नया भुगतान शुरू होने से पहले, उसी ऑर्डर और उसी ग्राहक सत्र (पिछले 24 घंटे) के खुले भुगतान dLocal Go से पढ़े जाते हैं: यदि उनमें से कोई भुगतान हो चुका है, तो उसका ऑर्डर पुष्ट होता है और ग्राहक दूसरा भुगतान किए बिना सफलता पेज पर जाता है।

OpenCart 4 ऑर्डर को तब तक चेकआउट में रखता है जब तक सफलता पेज नहीं दिखता। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद हो गया (उदाहरण के लिए रद्द या रिफ़ंड), तो Confirm Order या dLocal Go से वापसी ग्राहक को Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. संदेश के साथ चेकआउट पर वापस भेजती है, और अगला Confirm Order कार्ट का एक नया ऑर्डर भुगतान करता है।

यदि dLocal Go भुगतान शुरू नहीं कर पाता, तो ग्राहक Confirm Order चरण पर एक छोटे संदेश के साथ रहता है, जैसे dLocal could not start the payment: और फिर dLocal द्वारा बताया गया कारण। ऐसा तब भी होता है जब ग्राहक का देश और ऑर्डर की मुद्रा आपके dLocal Go खाते में सक्षम न हों। यदि dLocal Go आपके क्रेडेंशियल अस्वीकार करता है, तो ग्राहक This payment method is temporarily unavailable. Please choose another payment method or contact us. (यह भुगतान तरीका अस्थायी रूप से उपलब्ध नहीं है। कृपया कोई दूसरा भुगतान तरीका चुनें या हमसे संपर्क करें।) देखता है। तकनीकी कारण लॉग में लिखा जाता है।

स्टोर मेंटेनेंस मोड में होने पर भी सूचनाएँ काम करती हैं: OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को आने देता है, और OpenCart 4 पर एक्सटेंशन सूचनाओं और ग्राहक की वापसी के लिए एक स्टार्टअप ऐक्शन जोड़ता है।

एक्सटेंशन केवल dLocal Go पेज पर एकल भुगतान लेता है। आपकी साइट पर कार्ड फ़ॉर्म नहीं है, सेव किए गए कार्ड नहीं हैं, सब्सक्रिप्शन नहीं हैं, और अलग से authorize और capture नहीं होते।

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

ऑर्डर स्टेटस

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

Paid Order Status (डिफ़ॉल्ट प्रसंस्करण में) या Complete Order Status (डिफ़ॉल्ट पूर्ण): भुगतान की पुष्टि हो गई है। Auto-complete orders चालू होने पर ऑर्डर को Complete Order Status मिलता है। एक नोट environment और dLocal भुगतान ID दिखाता है।

On Hold (Review) Status (डिफ़ॉल्ट लंबित): dLocal Go ने ऑर्डर कुल से अलग राशि या मुद्रा बताई, या भुगतान ऑर्डर रद्द होने के बाद आया। नोट इसका कारण बताता है। dLocal Go डैशबोर्ड से मिलान करें, फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

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

अस्वीकृत, समय-सीमा समाप्त या रद्द हुआ भुगतान ऐसे ऑर्डर को कभी नहीं बदलता जिसका पहले से स्टेटस हो। यदि पहले से भुगतान किए गए ऑर्डर के लिए दूसरा भुगतान आता है, तो ऑर्डर नहीं बदलता, और एक नोट आपसे dLocal Go डैशबोर्ड में डुप्लिकेट भुगतान रिफ़ंड करने को कहता है। वही प्रकार का नोट भुगतान किए गए ऑर्डर में तब जुड़ता है जब वही कार्ट (वही ग्राहक सत्र और कार्ट की सामग्री) किसी दूसरे ऑर्डर के साथ एक बार और भुगतान किया गया हो, उदाहरण के लिए दूसरे ब्राउज़र टैब में; वह दूसरा ऑर्डर कोई स्टेटस नहीं रखता।

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

VibeFox dLocal Payment टैब

Sales > Orders में dLocal Go से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox dLocal Payment टैब Payment ID, Environment (sandbox या production), भुगतान का Status, Paid / refunded राशियाँ, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के dLocal Go notes दिखाता है। यह टैब उन उपयोगकर्ताओं को दिखता है जिनके पास एक्सटेंशन की पहुँच है।

रिफ़ंड

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

इसके बाद dLocal Go रिफ़ंड सूचना के माध्यम से अंतिम रिफ़ंड स्टेटस भेजता है, और वह नोट्स में जुड़ता है। यदि dLocal Go बाद में ऐसा रिफ़ंड अस्वीकार या रद्द करता है जिसे उसने पहले स्वीकार किया था, तो नोट चेतावनी देता है कि पैसा ग्राहक को वापस नहीं हुआ। ग्राहक को दोबारा या किसी और तरीके से रिफ़ंड करें।

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

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

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

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

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

सक्रिय कुंजी के बिना चेकआउट पर ग्राहकों को dLocal Go नहीं दिखता। यदि फिर भी भुगतान शुरू होता है, तो ग्राहक को 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 की ज़रूरत नहीं है। एक्सटेंशन हटाने पर लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हट जाते हैं।

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

dLocal Go चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और चुने गए Environment की API key और API secret सेट हैं। ये न हों तो सेटिंग्स पेज चेतावनी दिखाता है। यह भी जाँचें कि भुगतान पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स के Total तक पहुँचता है।

भुगतान हो गया, पर ऑर्डर बिना स्टेटस के है: dLocal Go सूचना URL तक नहीं पहुँच सका (फ़ायरवॉल, बेसिक ऑथेंटिकेशन, या सार्वजनिक HTTPS पता न होना), और ग्राहक स्टोर पर वापस नहीं आया। Debug log चालू करें, Log फ़ील्ड देखें और dLocal Go डैशबोर्ड में भुगतान जाँचें। सूचना आते ही, या ग्राहक के Check again पर क्लिक करते ही, ऑर्डर को स्टेटस मिल जाता है।

सूचना का उत्तर Missing signature या Invalid signature है: सेटिंग्स की API key और secret उस खाते के नहीं हैं जिसने सूचना भेजी। सूचनाएँ भुगतान के environment के क्रेडेंशियल से जाँची जाती हैं, इसलिए Environment बदलने से पहले शुरू हुए भुगतानों की पुष्टि तब तक होती रहेगी, जब तक उनके environment के क्रेडेंशियल सेटिंग्स में रहें।

सूचना का उत्तर Gateway not configured है: भुगतान के environment के क्रेडेंशियल नहीं हैं। उन्हें दर्ज करें; dLocal Go सूचना दोबारा भेजेगा।

सूचना का उत्तर API verification failed है: भुगतान पढ़ने के लिए dLocal Go API तक नहीं पहुँचा जा सका। dLocal Go सूचना दोबारा भेजेगा।

सूचना का उत्तर Temporarily unavailable है: उसी समय ऑर्डर किसी दूसरे अनुरोध से पुष्ट हो रहा था, या ऑर्डर स्टेटस सेट नहीं हो सका। dLocal Go सूचना दोबारा भेजेगा। कारण लॉग में है।

सूचना का उत्तर Order not found है: भुगतान इस स्टोर के किसी ऑर्डर का नहीं है, उदाहरण के लिए वह उसी dLocal Go खाते वाली किसी दूसरी साइट ने बनाया था।

ग्राहक को This payment method is temporarily unavailable दिखता है: dLocal Go ने API key या API secret अस्वीकार किया। चुने गए environment के क्रेडेंशियल जाँचें।

ग्राहक को Payment gateway is not properly configured दिखता है: चुने गए environment के क्रेडेंशियल नहीं हैं।

भुगतान के बाद ऑर्डर समीक्षा स्टेटस में है: VibeFox dLocal Payment टैब के नोट पढ़ें। चुकाई गई राशि या मुद्रा ऑर्डर से मेल नहीं खाती थी, या भुगतान ऑर्डर रद्द होने के बाद आया। ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

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

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

डेवलपर्स के लिए: एक्सटेंशन OpenCart इवेंट dlocal_p_payment_data (भुगतान अनुरोध और ऑर्डर, भुगतान बनने से पहले) और dlocal_p_currency_decimals (किसी मुद्रा के दशमलव अंक) ट्रिगर करता है।

अनइंस्टॉल

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

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

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