VibeFox Adyen for OpenCart — सहायता

आवश्यकताएँ

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

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

Adyen खाता: आपको अपने Adyen मर्चेंट खाते का नाम, हर उस वातावरण (टेस्ट और लाइव) के लिए एक API कुंजी और एक HMAC कुंजी, और लाइव भुगतानों के लिए लाइव URL प्रीफ़िक्स चाहिए। API कुंजी उस API क्रेडेंशियल की है जिसमें Checkout webservice और Merchant PAL webservice भूमिकाएँ हों। HMAC कुंजी Standard वेबहुक के लिए बनाई जाती है (देखें Configuration)। टेस्ट Customer Area ca-test.adyen.com है, और लाइव Customer Area ca-live.adyen.com है। टेस्ट और लाइव कुंजियाँ अलग हैं। क्लाइंट कुंजी की ज़रूरत नहीं है, क्योंकि भुगतान पेज Adyen द्वारा होस्ट किया जाता है।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. अपना मर्चेंट खाता, टेस्ट API कुंजी और टेस्ट HMAC कुंजी दर्ज करें, और बाद में लाइव API कुंजी, लाइव HMAC कुंजी और लाइव URL प्रीफ़िक्स दर्ज करें।

5. Adyen Customer Area (टेस्ट और लाइव) में सेटिंग्स के Webhook सेक्शन में दिखाए गए URL के साथ एक Standard वेबहुक जोड़ें (देखें Configuration)।

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

OpenCart 4

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

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

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

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

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Adyen Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। जब तक वर्तमान मोड की सेटिंग्स अधूरी हैं, पेज Adyen is hidden at checkout until the test settings are complete (या लाइव सेटिंग्स) दिखाता है और जो गायब है उसकी सूची देता है: Merchant account, API कुंजी, HMAC कुंजी और लाइव मोड में Live URL prefix। टेस्ट मोड चालू होने पर पेज Test mode is on: payment links and refunds go to the Adyen test environment, no real money. दिखाता है। एक्सटेंशन बदलने के अधिकार के बिना पेज सेटिंग्स दिखाता है, लेकिन उन्हें सेव नहीं कर सकता।

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

Adyen

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

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

Description: वह पाठ जो ग्राहक को Confirm Order चरण में, कन्फ़र्म बटन के ऊपर दिखाया जाता है। डिफ़ॉल्ट: Pay securely via Adyen।

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

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

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

Adyen खाता

API कुंजियाँ Adyen Customer Area में Developers > API credentials के अंतर्गत बनाई जाती हैं (इस सेक्शन में टेस्ट और लाइव Customer Area के लिंक हैं)। दोनों सेट की कुंजियाँ भरें; Test mode स्विच चुनता है कि कौन-सा उपयोग होगा।

Test mode: Adyen टेस्ट वातावरण का उपयोग करता है (कोई असली पैसा नहीं)। चालू होने पर भुगतान लिंक और रिफ़ंड टेस्ट API कुंजी के साथ checkout-test.adyen.com पर भेजे जाते हैं। डिफ़ॉल्ट: चालू। असली भुगतान लेने के लिए इसे बंद करें। चालू रहते हुए ग्राहक Confirm Order चरण पर Test mode: no real payment is taken. देखते हैं।

Merchant account: आपके Adyen मर्चेंट खाते का नाम (कंपनी खाता नहीं), उदाहरण के लिए MyShopECOM। यह आमतौर पर टेस्ट और लाइव Customer Area में एक ही होता है।

टेस्ट क्रेडेंशियल

Test mode चालू रहने के दौरान उपयोग होते हैं।

Test API key: टेस्ट Customer Area से: Developers > API credentials > आपका क्रेडेंशियल > API key।

Test HMAC key: टेस्ट Customer Area से: Developers > Webhooks > आपका Standard webhook > HMAC key (हेक्साडेसिमल)। अनिवार्य: मान्य हस्ताक्षर के बिना वेबहुक अस्वीकार किए जाते हैं।

लाइव क्रेडेंशियल

Test mode बंद होने पर उपयोग होते हैं।

Live API key: लाइव Customer Area से: Developers > API credentials > आपका क्रेडेंशियल > API key।

Live HMAC key: लाइव Customer Area से: Developers > Webhooks > आपका Standard webhook > HMAC key (हेक्साडेसिमल)।

Live URL prefix: लाइव Customer Area से: Developers > API URLs, उदाहरण के लिए https://1797a841fbb37ca7-AdyenDemo-checkout-live.adyenpayments.com से 1797a841fbb37ca7-AdyenDemo। आप पूरा URL चिपका सकते हैं; सेव करते समय उससे प्रीफ़िक्स निकाला जाता है।

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

Webhook

ऑर्डर केवल Adyen वेबहुक से ही भुगतान किए हुए चिह्नित होते हैं। Customer Area (टेस्ट और लाइव) में Developers > Webhooks पर जाएँ और इस सेक्शन में Webhook URL के अंतर्गत दिखाए गए URL के साथ एक Standard webhook जोड़ें। OpenCart 3 पर यह कुछ इस तरह दिखता है: https://your-store/index.php?route=extension/payment/wcp_adyen_gateway/webhook, OpenCart 4 पर इस तरह: https://your-store/index.php?route=extension/wcp_adyen_gateway/payment/wcp_adyen_gateway.webhook। यह आपकी OpenCart इंस्टॉलेशन के storefront पते से बनता है। URL को बिल्कुल वैसे ही कॉपी करें जैसा सेटिंग्स दिखाती हैं, क्योंकि Adyen रीडायरेक्ट का पालन नहीं करता। विधि के रूप में JSON चुनें, Generate HMAC key चालू करें और कुंजी को Test HMAC key या Live HMAC key में कॉपी करें।

हर सूचना का वातावरण HMAC कुंजी चुनता है, और कोई सूचना केवल उसी वातावरण और उसी मर्चेंट खाते में बनाए गए भुगतान लिंक पर लागू होती है। टेस्ट सूचना कभी भी लाइव भुगतान की पुष्टि नहीं करती। मान्य हस्ताक्षर के बिना वेबहुक HTTP 401 के साथ अस्वीकार किए जाते हैं, और Adyen उन्हें बाद में फिर से भेजता है। वेबहुक के बिना किसी भी ऑर्डर को स्टेटस नहीं मिलता।

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

अन्य इवेंट्स ऑर्डर नोट्स में जोड़े जाते हैं। बिना स्टेटस वाले ऑर्डर के लिए AUTHORISATION के अलावा अन्य सूचनाएँ अनदेखी की जाती हैं। जो सूचनाएँ इस स्टोर के किसी ऑर्डर के लिए नहीं हैं, उदाहरण के लिए Customer Area का टेस्ट बटन, उन्हें स्वीकार करके अनदेखा किया जाता है। OpenCart भुगतान एक्सटेंशन के अनुरोधों को आगे जाने देता है, इसलिए स्टोर मेंटेनेंस मोड में होने पर भी वेबहुक काम करता है। OpenCart 4 पर एक्सटेंशन इसके लिए एक startup action जोड़ता है।

ऑर्डर

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

Order status after payment: सफल, हस्ताक्षरित AUTHORISATION वेबहुक द्वारा सेट किया गया स्टेटस। डिफ़ॉल्ट: प्रक्रियाधीन।

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

Cancelled status: जब Adyen ऑर्डर का भुगतान रद्द करता है (CANCELLATION) तब सेट होता है। डिफ़ॉल्ट: रद्द।

Refunded status: ऑर्डर पेज से भुगतान पूरा रिफ़ंड होने के बाद सेट होता है। यदि Adyen बाद में बताता है कि यह रिफ़ंड विफल हो गया, तो ऑर्डर नोट के साथ समीक्षा स्टेटस में चला जाता है। डिफ़ॉल्ट: रिफ़ंड किया गया।

उन्नत

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

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

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

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

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

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

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Adyen)। Confirm Order चरण पर ग्राहक आपका विवरण और नोट You will be redirected to Adyen to complete the payment securely. देखता है। OpenCart इस चरण पर ऑर्डर बनाता है, फिर भी बिना स्टेटस के। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर की मुद्रा में ऑर्डर की कुल राशि के लिए Adyen भुगतान लिंक बनाता है और ग्राहक को Adyen भुगतान पेज पर भेज देता है। वहाँ ग्राहक आपके Adyen खाते में सक्षम किसी भी विधि से भुगतान करता है। ग्राहक का ईमेल, नाम और बिलिंग देश (या स्टोर का देश) तथा स्टोर की भाषा Adyen को भेजी जाती है, और भुगतान Order # के रूप में ऑर्डर नंबर के साथ दिखता है।

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। लौटना अपने आप में ऑर्डर का भुगतान नहीं करता: ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Adyen हस्ताक्षरित AUTHORISATION वेबहुक से भुगतान की पुष्टि करे और राशि व मुद्रा ऑर्डर से मेल खाएँ। फिर ऑर्डर को OpenCart के मानक तरीके से स्टेटस मिलता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ। यदि वेबहुक पहले ही आ चुका है, तो ग्राहक को Your payment with Adyen has been received. के साथ OpenCart का ऑर्डर सफलता पेज दिखता है (समीक्षाधीन ऑर्डर के लिए Your payment with Adyen has been received and is being reviewed by the store.)। यदि उससे पहले Adyen ने भुगतान रद्द कर दिया था, तो पेज Your Adyen payment was not completed. Please contact us about this order. दिखाता है। यदि वेबहुक अभी नहीं आया है, तो भुगतान पूरा न करने वाले ग्राहक के लिए Payment confirmation पेज दिखता है, जिसमें Your payment is being confirmed by Adyen. Your order will be confirmed as soon as Adyen confirms the payment, and you will receive an e-mail. और Check again तथा Back to checkout बटन होते हैं।

यदि भुगतान अस्वीकृत होता है, तो ऑर्डर बिना स्टेटस के रहता है और ग्राहक उसी लिंक से फिर भुगतान कर सकता है या चेकआउट पर लौट सकता है। हर नया प्रयास (OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर एक नया ऑर्डर बनाता है, OpenCart 4 चेकआउट के ऑर्डर को अपडेट करता है) उस ऑर्डर और कार्ट के पिछले भुगतान लिंक को अमान्य कर देता है, इसलिए उनसे भी भुगतान नहीं किया जा सकता। यदि ऑर्डर का पहले से कोई स्टेटस है, तो ग्राहक नया भुगतान शुरू करने के बजाय सफलता पेज पर पहुँच जाता है।

OpenCart 4 पर ग्राहक Payment method options विंडो में, भुगतान विधि ब्लॉक के Choose बटन से भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। OpenCart 4 पर भुगतान पता वैकल्पिक है: उसके बिना ग्राहक का नाम भुगतानकर्ता के नाम के रूप में, और शिपिंग पते का देश (या स्टोर का देश) देश के रूप में Adyen को भेजा जाता है। OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसे अपडेट करता है: Back to checkout और नया Confirm Order उसी ऑर्डर के लिए नया भुगतान लिंक बनाते हैं और पिछले को अमान्य कर देते हैं। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद हो गया (उदाहरण के लिए Adyen ने भुगतान रद्द किया, या आपने ऑर्डर रद्द किया), तो ग्राहक को चेकआउट पर वापस भेजा जाता है, जिसके ऊपर Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. दिखता है, और अगला Confirm Order एक नए ऑर्डर का भुगतान करता है। यदि चेकआउट का ऑर्डर किसी दूसरी कार्ट के लिए पहले ही भुगतान किया हुआ था, तो ग्राहक चेकआउट पर वापस भेजा जाता है और एक नए ऑर्डर का भुगतान करता है। कार्ट में बदलाव, जिसमें नई मात्रा भी शामिल है, एक नई कार्ट माना जाता है जिसे अपने अलग भुगतान की ज़रूरत है।

यदि भुगतान लिंक नहीं बनाया जा सकता, तो ग्राहक Confirm Order चरण पर Payment could not be initiated. Please try again or choose another payment method. के साथ रहता है। कारण लॉग में लिखा जाता है। यदि सेटिंग्स अधूरी हैं, तो संदेश Payment gateway is not configured properly. Please contact the store administrator. होता है।

इस एक्सटेंशन में सदस्यताएँ या आवर्ती भुगतान, सहेजे गए कार्ड, आपकी साइट पर कार्ड फ़ील्ड (Drop-in या Components), OpenCart में कैप्चर या रद्द करने के बटन, और वेबहुक के लिए बेसिक प्रमाणीकरण नहीं है।

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

ऑर्डर स्टेटस

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

Order status after payment (default Processing): भुगतान प्राधिकृत हुआ। नोट में राशि, PSP संदर्भ और भुगतान विधि दिखती है।

On hold (review) status (default Pending): Adyen ने ऑर्डर की कुल राशि से अलग राशि या मुद्रा की पुष्टि की, कैप्चर विफल हुआ, पूर्ण रिफ़ंड विफल हुआ, या ऑर्डर का स्टेटस बदल दिए जाने के बाद (उदाहरण के लिए रद्द होने के बाद) भुगतान आया। नोट इसे समझाता है। Customer Area में भुगतान जाँचें, फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें। बेमेल के बाद समीक्षा में रखे ऑर्डर के लिए सही भुगतान आने पर ऑर्डर भुगतान किया हुआ चिह्नित हो जाता है।

Cancelled status (default Canceled): इस ऑर्डर का भुगतान Adyen में रद्द हुआ।

Refunded status (default Refunded): एक्सटेंशन के माध्यम से भुगतान पूरा रिफ़ंड किया गया। यह रिफ़ंड भेजे जाने पर सेट होता है; यदि Adyen बाद में बताता है कि यह रिफ़ंड विफल हुआ, तो ऑर्डर समीक्षा स्टेटस में चला जाता है।

यदि पहले से भुगतान किए गए ऑर्डर के लिए दूसरा सफल भुगतान आता है, उदाहरण के लिए किसी पुराने भुगतान लिंक से, तो ऑर्डर नहीं बदलता। एक नोट आपसे Customer Area में डुप्लिकेट चार्ज की जाँच करने और ज़रूरत हो तो वहीं उसे रिफ़ंड करने के लिए कहता है। यही नियम कार्ट पर भी लागू होता है: कार्ट के किसी एक ऑर्डर के भुगतान हो जाने पर, उसी कार्ट के किसी दूसरे ऑर्डर के लिए नया भुगतान लिंक नहीं बनता, और ऐसे ऑर्डर के लिए अभी भी आने वाला भुगतान उसे स्टेटस नहीं देता; भुगतान किए गए ऑर्डर को नोट मिलता है।

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

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

VibeFox Adyen Gateway टैब

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

रिफ़ंड

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

Adyen रिफ़ंड को असिंक्रोनस रूप से संसाधित करता है: अनुरोध received स्टेटस के साथ रिफ़ंड इतिहास और नोट्स में जुड़ता है, और अंतिम परिणाम REFUND या REFUND_FAILED वेबहुक से आता है। विफल रिफ़ंड को अब रिफ़ंड किया हुआ नहीं गिना जाता। जब भेजे गए रिफ़ंड भुगतान की गई राशि तक पहुँच जाते हैं, तो ऑर्डर ग्राहक को सूचित किए बिना और उत्पादों को स्टॉक में वापस रखे बिना Refunded status पर सेट हो जाता है, जैसे मैन्युअल स्टेटस बदलने पर। आंशिक रिफ़ंड स्टेटस नहीं बदलता। Adyen में मैन्युअल कैप्चर होने पर केवल कैप्चर किए गए भुगतान ही रिफ़ंड किए जा सकते हैं।

Sales > Returns में उत्पाद की वापसी Adyen के ज़रिए पैसा वापस नहीं भेजती। Adyen Customer Area में किए गए रिफ़ंड वेबहुक से आते हैं और नोट्स में जुड़ते हैं। ऑर्डर का स्टेटस अपने-आप नहीं बदलता।

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

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

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

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

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

चेकआउट पर Adyen दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और वर्तमान मोड की सेटिंग्स पूरी हैं: Merchant account, उस मोड की API कुंजी और HMAC कुंजी, और लाइव मोड में Live URL prefix। सेटिंग्स पेज बताता है कि क्या गायब है। यह भी जाँचें कि भुगतान का पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स में दिए गए Total तक पहुँचता है।

भुगतान हो गया, लेकिन ऑर्डर बिना स्टेटस के रह गया: वेबहुक काम नहीं कर रहा है। जिस वातावरण (टेस्ट या लाइव) का आप उपयोग करते हैं, उसके Customer Area में जाँचें कि Standard webhook मौजूद है, उसका URL बिल्कुल वही है जो Webhook URL में दिखाया गया है, और विधि JSON है। जाँचें कि उस वेबहुक की HMAC कुंजी सही फ़ील्ड (Test HMAC key या Live HMAC key) में है। अमान्य या गायब HMAC कुंजी होने पर एक्सटेंशन HTTP 401 का उत्तर देता है और Adyen बाद में डिलीवरी फिर से करता है, इसलिए कुंजी ठीक होते ही ऑर्डर को अपने-आप स्टेटस मिल जाता है। लॉग दिखाता है कि HMAC हस्ताक्षर अमान्य है या HMAC कुंजी कॉन्फ़िगर नहीं है।

वेबहुक [rejected] HMAC key not configured का उत्तर देता है: सूचना के वातावरण की HMAC कुंजी खाली है। उसे सेटिंग्स में चिपकाएँ।

वेबहुक [rejected] invalid HMAC signature का उत्तर देता है: HMAC कुंजी किसी दूसरे वेबहुक या दूसरे वातावरण की है। यदि किसी बैच के एक आइटम का हस्ताक्षर गलत है, तो पूरा बैच अस्वीकार हो जाता है।

वेबहुक [rejected] busy, retry later का उत्तर देता है: उसी समय ऑर्डर किसी दूसरी डिलीवरी द्वारा संसाधित हो रहा था, या प्रसंस्करण विफल हुआ। Adyen वेबहुक को अपने-आप फिर से भेजता है। कारण लॉग में है।

ब्राउज़र में वेबहुक URL [rejected] POST required दिखाता है: यह सामान्य है। यह URL केवल Adyen की सूचनाएँ स्वीकार करता है।

सेव करते समय HMAC कुंजी की चेतावनी: फ़ील्ड में Customer Area की हेक्साडेसिमल HMAC कुंजी होनी चाहिए। पिछला मान बना रहा।

ग्राहक को Payment could not be initiated दिखता है: एक्सटेंशन पेज पर Log फ़ील्ड देखें (त्रुटियाँ हमेशा लॉग होती हैं)। API कुंजी, मर्चेंट खाता और लाइव मोड में लाइव URL प्रीफ़िक्स जाँचें।

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

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

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

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

डेवलपर्स के लिए: भुगतान लिंक बनाए जाने से पहले एक्सटेंशन अनुरोध डेटा और ऑर्डर के साथ OpenCart इवेंट adyg_payment_link_request ट्रिगर करता है।

अनइंस्टॉल

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

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

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