VibeFox dLocal for WooCommerce — सहायता
आवश्यकताएँ
WordPress: 5.8 या उसके बाद का संस्करण।
WooCommerce: 7.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय।
PHP: 8.0 या उसके बाद का संस्करण। पुराने PHP या WordPress संस्करण पर प्लगइन सक्रिय होने से मना कर देता है।
साइट तक पहुँच: आपकी साइट इंटरनेट से पहुँच योग्य होनी चाहिए और लाइव वातावरण में HTTPS का उपयोग करना चाहिए, ताकि dLocal Go भुगतान सूचनाएँ पहुँचा सके। फ़ायरवॉल, मेंटेनेंस मोड या बेसिक ऑथेंटिकेशन उन्हें रोक सकते हैं।
dLocal Go खाता: आपको dLocal Go डैशबोर्ड के Payment integration सेक्शन से API कुंजी और API सीक्रेट चाहिए: सैंडबॉक्स के लिए dashboard-sbx.dlocalgo.com, लाइव के लिए dashboard.dlocalgo.com। सैंडबॉक्स और लाइव अलग-अलग क्रेडेंशियल का उपयोग करते हैं। एंटरप्राइज़ dLocal Payments API (X-Login / X-Trans-Key क्रेडेंशियल) एक अलग प्रोडक्ट है और समर्थित नहीं है।
देश और मुद्राएँ: प्लगइन इन्हें सीमित नहीं करता। ग्राहक के देश और स्टोर की मुद्रा के लिए कौन-सी भुगतान विधियाँ दी जाएँ, यह dLocal Go तय करता है।
VibeFox लाइसेंस कुंजी: vibefox.net पर खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप wcp_dlocal_payment फ़ोल्डर को FTP से /wp-content/plugins/ में भी अपलोड कर सकते हैं।
2. Activate पर क्लिक करें। WooCommerce सक्रिय होना चाहिए।
3. सेटिंग्स खोलें: WooCommerce > Settings > Payments > dLocal Go > Manage, या प्लगइन पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।
4. पेज के ऊपर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें।
5. Environment चुनें और उस वातावरण की API कुंजी और API सीक्रेट पेस्ट करें (कॉन्फ़िगरेशन देखें)।
6. Enable/Disable चालू करें और सेव करें। सैंडबॉक्स में एक भुगतान का परीक्षण करें, फिर Environment को Production पर बदलें।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > dLocal Go। पेज के शीर्षक में SANDBOX या PRODUCTION दिखता है। जब तक चुने गए वातावरण की API कुंजी और सीक्रेट दर्ज नहीं किए जाते, पेज आपको चेतावनी देता है कि भुगतान विधि चेकआउट पर छिपी है। जब सैंडबॉक्स चुना हो और गेटवे सक्षम हो, तो पेज पर Sandbox mode is active: payments are simulated, no money is charged. दिखता है। भुगतान विधियों की सूची में, क्रेडेंशियल सेट होने तक dLocal Go को सेटअप की आवश्यकता वाला चिह्नित किया जाता है, और सैंडबॉक्स में यह Test mode दिखाता है।
सामान्य
Enable/Disable: Enable dLocal Go भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: भुगतान विधि का वह नाम जो ग्राहक चेकआउट पर देखते हैं। डिफ़ॉल्ट: dLocal Go।
Description: चेकआउट पर भुगतान विधि के नीचे दिखाया जाने वाला टेक्स्ट। डिफ़ॉल्ट: Pay with local cards, bank transfer or cash via dLocal Go.
API क्रेडेंशियल
dLocal Go डैशबोर्ड के Payment integration से API कुंजी और API सीक्रेट कॉपी करें: dashboard-sbx.dlocalgo.com (सैंडबॉक्स) या dashboard.dlocalgo.com (लाइव)। सभी क्रेडेंशियल फ़ील्ड पासवर्ड फ़ील्ड हैं।
Environment: कौन-से क्रेडेंशियल और कौन-से dLocal Go सर्वर उपयोग होंगे।
Sandbox API Key: आपकी dLocal Go सैंडबॉक्स API कुंजी।
Sandbox API Secret: आपका dLocal Go सैंडबॉक्स API सीक्रेट।
Production API Key: आपकी dLocal Go लाइव API कुंजी।
Production API Secret: आपका dLocal Go लाइव API सीक्रेट।
भुगतान
Default country: dLocal Go ग्राहक के देश की भुगतान विधियाँ दिखाता है, जो बिलिंग पते से, फिर शिपिंग पते से ली जाती है। जब ऑर्डर में दोनों में से कोई नहीं होता, तब यह देश उपयोग होता है। डिफ़ॉल्ट: Uruguay।
Auto-complete orders: Set paid orders to "Completed" instead of "Processing". स्थिति एक ही बार में सेट होती है, ई-मेल के एक ही सेट के साथ। डिफ़ॉल्ट: बंद।
सूचनाएँ (IPN)
सूचनाएँ आपके स्टोर को बताती हैं कि किसी भुगतान या रिफ़ंड में बदलाव हुआ है। प्लगइन हर भुगतान और रिफ़ंड के साथ सूचना URL dLocal Go को भेजता है, इसलिए dLocal Go डैशबोर्ड में कुछ भी कॉन्फ़िगर नहीं करना पड़ता। सेटिंग्स का यह सेक्शन दोनों URL दिखाता है:
सूचनाओं का सत्यापन आपके API सीक्रेट (HMAC-SHA256) से होता है। मान्य हस्ताक्षर के बिना सूचनाएँ अस्वीकार कर दी जाती हैं। उसके बाद भुगतान की स्थिति, राशि और मुद्रा हमेशा dLocal Go API से दोबारा पढ़ी जाती हैं; सूचना की सामग्री पर भरोसा नहीं किया जाता। सूचनाओं के बिना, ऑर्डर केवल तब अपडेट होता है जब ग्राहक स्टोर पर लौटता है।
उन्नत
Debug log: Log API requests and notifications विवरण को WooCommerce > Status > Logs में, स्रोत wcp_dlocal_payment के साथ, API क्रेडेंशियल या व्यक्तिगत डेटा के बिना लिखता है। त्रुटियाँ हमेशा लॉग होती हैं। डिफ़ॉल्ट: बंद।
Delete data on uninstall: Delete the gateway settings and logs when the plugin is deleted (order payment data is kept). डिफ़ॉल्ट: बंद।
चेकआउट
ग्राहक भुगतान विधि (डिफ़ॉल्ट रूप से dLocal Go) चुनता है और ऑर्डर देता है। प्लगइन ऑर्डर की कुल राशि के लिए, ऑर्डर की मुद्रा में, ग्राहक के देश, नाम, ई-मेल और फ़ोन के साथ एक dLocal Go भुगतान बनाता है और ग्राहक को dLocal Go भुगतान पेज पर भेजता है। वहाँ ग्राहक अपने देश की किसी विधि से भुगतान करता है। dLocal Go पेज पर भुगतान Order # और ऑर्डर नंबर के रूप में दिखता है। सैंडबॉक्स मोड में चेकआउट पर भुगतान विधि के नीचे Sandbox mode: no real payment is made. दिखता है।
भुगतान के बाद ग्राहक आपके स्टोर के ऑर्डर प्राप्त पेज पर लौटता है। ऑर्डर केवल तब भुगतान किया हुआ चिह्नित होता है जब dLocal Go पुष्टि करता है: हस्ताक्षरित सूचना से, या ग्राहक के उस पेज पर पहुँचने पर dLocal Go API को भेजे गए सर्वर-साइड अनुरोध से।
अगर ग्राहक भुगतान किए बिना dLocal Go पेज छोड़ देता है, तो वह चेकआउट (या Pay for order पेज) पर लौटता है और The payment at dLocal Go was not completed. You can try again or choose another payment method. देखता है। अगर भुगतान अस्वीकार हुआ या उसकी अवधि समाप्त हो गई, तो संदेश Your dLocal payment was not completed: it was declined or it expired. Please try again or choose another payment method. होता है। अगर पता चलता है कि भुगतान हो चुका है, तो ग्राहक को ऑर्डर प्राप्त पेज पर भेजा जाता है। दोबारा प्रयास के बाद भी उसी ऑर्डर के पुराने भुगतान लिंक से भुगतान किया जा सकता है।
अगर dLocal Go भुगतान शुरू नहीं कर पाता, तो ग्राहक को तकनीकी विवरण के बिना एक छोटा संदेश दिखता है, उदाहरण के लिए dLocal could not start the payment: और उसके बाद dLocal द्वारा बताया गया कारण, और वह कोई दूसरी विधि चुन सकता है। ऐसा तब भी होता है जब ग्राहक का देश और स्टोर की मुद्रा आपके dLocal Go खाते में सक्षम नहीं होते। तकनीकी कारण लॉग में लिखा जाता है।
भुगतान विधि क्लासिक चेकआउट, चेकआउट ब्लॉक और Pay for order पेज पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।
प्लगइन केवल dLocal Go पेज पर एक बार के भुगतान लेता है। इसमें आपकी साइट पर कार्ड फ़ॉर्म, सेव किए गए कार्ड, सब्सक्रिप्शन या अलग-अलग ऑथराइज़ेशन और कैप्चर नहीं हैं।
ऑर्डर और रिफ़ंड
ऑर्डर स्थितियाँ
Pending payment: ग्राहक को dLocal Go पर भेजा गया है और उसने अभी भुगतान नहीं किया है, या dLocal Go पर भुगतान लंबित है (उदाहरण के लिए नकद भुगतान वाउचर जिसका अभी भुगतान नहीं हुआ)। हर नया भुगतान प्रयास उसकी dLocal भुगतान ID, राशि और वातावरण के साथ ऑर्डर पर नोट किया जाता है।
Processing or Completed: भुगतान की पुष्टि हो गई। ऑर्डर प्रोसेसिंग (WooCommerce का डिफ़ॉल्ट) में होता है, या Auto-complete orders चालू होने पर पूर्ण में। ट्रांज़ैक्शन ID, dLocal भुगतान ID होती है।
On hold: dLocal Go ने ऑर्डर की कुल राशि से अलग राशि या मुद्रा बताई, या भुगतान ऑर्डर रद्द होने के बाद आया। ऑर्डर नोट इसका कारण बताता है। dLocal Go डैशबोर्ड से मिलान करें और ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।
Failed: नवीनतम भुगतान प्रयास अस्वीकार हुआ या उसकी अवधि समाप्त हो गई। ग्राहक दोबारा प्रयास कर सकता है।
Cancelled: dLocal Go ने नवीनतम भुगतान प्रयास को रद्द बताया।
केवल नवीनतम भुगतान प्रयास ही किसी बिना भुगतान वाले ऑर्डर को विफल या रद्द कर सकता है। भुगतान किया गया ऑर्डर किसी पुरानी सूचना से कभी दोबारा नहीं खुलता। अगर पहले से भुगतान किए गए ऑर्डर के लिए दूसरा भुगतान आता है, तो ऑर्डर नहीं बदला जाता। एक नोट आपसे dLocal Go डैशबोर्ड में डुप्लिकेट भुगतान रिफ़ंड करने के लिए कहता है।
रिफ़ंड
ऑर्डर खोलें, Refund पर क्लिक करें, राशि दर्ज करें और Refund via dLocal Go पर क्लिक करें। dLocal Go से भुगतान किए गए ऑर्डर के लिए पूर्ण और आंशिक रिफ़ंड समर्थित हैं। रिफ़ंड उसी वातावरण में भेजा जाता है जिसमें भुगतान हुआ था, उस वातावरण के क्रेडेंशियल के साथ। अगर dLocal Go रिफ़ंड स्वीकार नहीं करता, तो WooCommerce त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। स्वीकार किया गया रिफ़ंड, रिफ़ंड ID और स्थिति के साथ ऑर्डर नोट में जोड़ा जाता है।
इसके बाद dLocal Go रिफ़ंड सूचना से अंतिम रिफ़ंड स्थिति बताता है, और वह ऑर्डर नोट में जोड़ी जाती है। अगर dLocal Go बाद में किसी स्वीकार किए गए रिफ़ंड को अस्वीकार या रद्द कर देता है, तो नोट चेतावनी देता है कि पैसा ग्राहक को वापस नहीं गया। उसके लिए दर्ज WooCommerce रिफ़ंड की समीक्षा करें: उसे हटाकर दोबारा रिफ़ंड करें, या ग्राहक को किसी और तरीके से रिफ़ंड करें।
dLocal Go डैशबोर्ड में किए गए रिफ़ंड WooCommerce रिफ़ंड के रूप में दर्ज नहीं होते और आमतौर पर कोई ऑर्डर नोट नहीं जोड़ते। ज़रूरत हो, तो Refund via dLocal Go के बिना WooCommerce में मैन्युअल रिफ़ंड बनाएँ।
लाइसेंस कुंजी
प्लगइन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Payments > dLocal Go के ऊपर है। कुंजी को License key में पेस्ट करें और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, उदाहरण के लिए वह तारीख जब तक लाइसेंस सक्रिय है और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key और इस साइट से कुंजी हटाने के लिए Remove key का उपयोग करें। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।
एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने से उसके डोमेन का स्लॉट खाली नहीं होता। स्लॉट को अपने vibefox.net खाते में खाली करें।
सक्रिय कुंजी के बिना, dLocal Go चेकआउट पर ग्राहकों को नहीं दिखाया जाता। अगर फिर भी कोई भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। लॉग-इन किए हुए स्टोर मैनेजर अब भी भुगतान विधि देखते हैं, जिस पर (unlicensed — visible to admins only) चिह्न होता है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट अप और टेस्ट कर सकें। प्लगइन पेज और WooCommerce पेजों पर एक रिमाइंडर दिखता है। मौजूदा ऑर्डर पर कोई असर नहीं पड़ता: पहले से शुरू हुए भुगतानों की पुष्टि होती रहती है, और रिफ़ंड काम करते हैं।
लाइसेंस की अवधि समाप्त होने पर प्लगइन काम करता रहता है, लेकिन अपडेट और सपोर्ट के लिए नवीनीकरण ज़रूरी है। स्थिति बैकग्राउंड में अपने-आप दोबारा जाँची जाती है।
समस्या निवारण
dLocal Go चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है और चुने गए Environment की API कुंजी और API सीक्रेट सेट हैं। इनके न होने पर सेटिंग्स पेज एक चेतावनी दिखाता है।
भुगतान हो गया, लेकिन ऑर्डर भुगतान लंबित में ही रहता है: dLocal Go सूचना URL तक नहीं पहुँच सका (फ़ायरवॉल, मेंटेनेंस मोड, बेसिक ऑथेंटिकेशन) और ग्राहक ऑर्डर प्राप्त पेज पर नहीं लौटा। WooCommerce > Status > Logs, स्रोत wcp_dlocal_payment, और dLocal Go डैशबोर्ड में भुगतान जाँचें। जैसे ही कोई सूचना आती है या ग्राहक ऑर्डर प्राप्त पेज खोलता है, ऑर्डर अपडेट हो जाता है।
सूचना को Missing signature या Invalid signature जवाब मिलता है: सेटिंग्स में मौजूद API कुंजी और सीक्रेट उस खाते के नहीं हैं जिसने सूचना भेजी। सूचनाओं की जाँच दोनों वातावरणों के क्रेडेंशियल से होती है, इसलिए Environment बदलने से पहले शुरू हुए भुगतानों की पुष्टि तब तक होती रहती है, जब तक उनके वातावरण के क्रेडेंशियल सेटिंग्स में रहते हैं।
सूचना को Gateway not configured जवाब मिलता है: चुने गए वातावरण के क्रेडेंशियल नहीं हैं। dLocal Go सूचना दोबारा भेजता है।
सूचना को API verification failed जवाब मिलता है: भुगतान पढ़ने के लिए dLocal Go API तक नहीं पहुँचा जा सका। dLocal Go सूचना दोबारा भेजता है।
सूचना को Order not found जवाब मिलता है: भुगतान इस स्टोर के किसी ऑर्डर का नहीं है, उदाहरण के लिए इसे उसी dLocal Go खाते वाली किसी दूसरी साइट ने बनाया था।
ग्राहक को This payment method is temporarily unavailable दिखता है: dLocal Go ने API कुंजी या सीक्रेट अस्वीकार कर दिया। चुने गए वातावरण के क्रेडेंशियल जाँचें।
भुगतान के बाद ऑर्डर होल्ड पर है: ऑर्डर नोट पढ़ें। भुगतान की गई राशि या मुद्रा ऑर्डर से अलग थी, या भुगतान ऑर्डर रद्द होने के बाद आया। ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।
रिफ़ंड, क्रेडेंशियल न होने के संदेश के साथ विफल होता है: भुगतान दूसरे वातावरण में हुआ था, और उसके क्रेडेंशियल सेट नहीं हैं। उन्हें दर्ज करें और दोबारा प्रयास करें।
लाइसेंस ब्लॉक त्रुटि दिखाता है: ब्लॉक में दिए संदेश का पालन करें। उदाहरण के लिए, अगर कुंजी पहले से किसी दूसरे डोमेन पर उपयोग हो रही है, तो अपने vibefox.net खाते में एक स्लॉट खाली करें और Check now पर क्लिक करें। अगर साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। अगर लाइसेंस सर्वर तक नहीं पहुँचा जा सकता, तो प्लगइन अंतिम ज्ञात स्थिति पर काम करता रहता है।
डेवलपर्स के लिए, प्लगइन दस्तावेज़ में dlocal_p_payment_data, dlocal_p_currency_decimals और dlocal_p_icon फ़िल्टर सूचीबद्ध हैं।
अनइंस्टॉल
प्लगइन निष्क्रिय करने पर सारा डेटा बना रहता है। इसे हटाने के लिए Plugins पेज पर इसे निष्क्रिय करें और हटाएँ। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटाई जाती हैं। गेटवे सेटिंग्स और लॉग केवल तभी हटाए जाते हैं जब Delete data on uninstall चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए बने रहते हैं। मौजूदा ऑर्डर अपने भुगतान नोट और ट्रांज़ैक्शन ID बनाए रखते हैं।
dLocal अपने संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन dLocal से संबद्ध नहीं है और न ही dLocal द्वारा समर्थित है।