VibeFox Adyen for WooCommerce — सहायता

आवश्यकताएँ

WordPress: 6.0 या उसके बाद का संस्करण।

WooCommerce: 7.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। इसके बिना प्लगइन सक्रिय नहीं होता।

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

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

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

इंस्टॉलेशन

1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP द्वारा wcp_adyen_gateway फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।

2. Activate पर क्लिक करें।

3. सेटिंग्स खोलें: WooCommerce > Settings > Payments > Adyen > Manage, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।

4. पेज के शीर्ष पर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें।

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

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

7. Enable/Disable चालू करें। Test mode चालू रखकर एक भुगतान का परीक्षण करें, फिर उसका निशान हटाएँ।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Adyen। जब तक मौजूदा मोड की सेटिंग्स अधूरी हैं, पेज Adyen is hidden at checkout until the test settings are complete (या लाइव सेटिंग्स) दिखाता है और बताता है कि क्या गायब है: Merchant account, API कुंजी, HMAC कुंजी और, लाइव मोड में, Live URL prefix। सहेजते समय ऐसी HMAC कुंजी जो हेक्साडेसिमल न हो, और ऐसा लाइव URL प्रीफ़िक्स जिसमें अक्षर, अंक और डैश के अलावा कुछ और हो, त्रुटि के साथ अस्वीकार होते हैं, और पिछला मान रहता है।

सामान्य

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

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

Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely via Adyen।

Adyen खाता

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

Test mode: Use the Adyen test environment (no real money)। चालू होने पर भुगतान लिंक और रिफ़ंड टेस्ट API कुंजी के साथ checkout-test.adyen.com पर जाते हैं। डिफ़ॉल्ट: on। असली भुगतान लेने के लिए निशान हटाएँ।

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 वेबहुक > HMAC key (हेक्साडेसिमल)। आवश्यक: बिना वैध हस्ताक्षर वाले वेबहुक अस्वीकार होते हैं।

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

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

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

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

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

वेबहुक

ऑर्डर केवल Adyen वेबहुक से भुगतान किए हुए चिह्नित होते हैं। Customer Area में (टेस्ट और लाइव, दोनों) Developers > Webhooks पर जाएँ और सेटिंग्स के इस सेक्शन में दिखाए URL के साथ एक Standard webhook जोड़ें। यह ऐसा दिखता है: https://your-site/wc-api/adyg_adyen_webhook/। विधि JSON चुनें, Generate HMAC key चालू करें और कुंजी को Test HMAC key या Live HMAC key में कॉपी करें। हर सूचना का वातावरण यह तय करता है कि कौन सी HMAC कुंजी उपयोग होगी। बिना वैध हस्ताक्षर वाले वेबहुक अस्वीकार होते हैं, और Adyen उन्हें बाद में फिर भेजता है। वेबहुक के बिना ऑर्डर Pending payment पर रहते हैं।

प्लगइन ये इवेंट संभालता है:

अन्य इवेंट ऑर्डर नोट में जोड़े जाते हैं। इस स्टोर के ऑर्डर से संबंधित न होने वाली सूचनाएँ, जैसे Customer Area में टेस्ट बटन की सूचनाएँ, स्वीकार होती हैं और अनदेखी की जाती हैं।

उन्नत

Order status after payment: सफल भुगतान के बाद सेट होने वाली ऑर्डर स्थिति, एक ही स्थिति-बदलाव में।

Debug log: Log API calls and webhook events को WooCommerce > Status > Logs में, source wcp_adyen_gateway के साथ लिखें। त्रुटियाँ हमेशा लॉग होती हैं। लॉग में कभी API या HMAC कुंजियाँ या ग्राहक का निजी डेटा नहीं होता। डिफ़ॉल्ट: off।

Delete data on uninstall: Delete the plugin settings and Adyen order meta (PSP references) when the plugin is deleted। डिफ़ॉल्ट: off।

चेकआउट

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

भुगतान के बाद ग्राहक आपके स्टोर के ऑर्डर प्राप्त पेज पर लौटता है। लौटने से ऑर्डर भुगतान किया हुआ नहीं बनता: ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Adyen हस्ताक्षरित AUTHORISATION वेबहुक से पुष्टि करे और राशि तथा मुद्रा ऑर्डर से मेल खाएँ।

यदि भुगतान अस्वीकार होता है, तो ऑर्डर Failed बन जाता है और ग्राहक दोबारा कोशिश कर सकता है। जब ग्राहक उसी ऑर्डर के लिए नया भुगतान शुरू करता है, उदाहरण के लिए Pay for 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. दिखता है।

बिना दशमलव वाली मुद्राओं, जैसे JPY, KRW, IDR या VND, के लिए WooCommerce > Settings > General > Number of decimals को 0 पर सेट करें। अन्यथा कुल राशि पूर्ण इकाई पर गोल हो जाती है।

यह भुगतान विधि क्लासिक चेकआउट और Checkout ब्लॉक पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।

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

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

ऑर्डर की स्थितियाँ

Pending payment: भुगतान लिंक बन गया है और Adyen ने अभी भुगतान की पुष्टि नहीं की। ऑर्डर नोट में भुगतान लिंक, राशि और वातावरण दिखता है।

Processing, Completed or On Hold: भुगतान प्राधिकृत हुआ। स्थिति Order status after payment का अनुसरण करती है। ऑर्डर नोट में राशि, PSP reference और भुगतान विधि दिखती है। लेन-देन ID Adyen PSP reference है।

On hold after payment: Adyen ने ऑर्डर की कुल राशि से अलग राशि या मुद्रा की पुष्टि की। ऑर्डर नोट में दोनों दिखते हैं, और ऑर्डर भुगतान किया हुआ चिह्नित नहीं होता। भुगतान किया हुआ ऑर्डर तब भी होल्ड पर रखा जाता है जब कैप्चर विफल हो, क्योंकि पैसा वसूल नहीं हुआ। Customer Area में भुगतान जाँचें।

Failed: भुगतान अस्वीकार हुआ। भुगतान किए गए, होल्ड पर या रद्द ऑर्डर अस्वीकृत भुगतान से नहीं बदलते।

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

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

रिफ़ंड

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

Adyen Customer Area में किए गए रिफ़ंड वेबहुक से आते हैं और ऑर्डर नोट में जुड़ते हैं। वे अपने-आप WooCommerce रिफ़ंड के रूप में दर्ज नहीं होते।

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

प्लगइन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Payments > Adyen के शीर्ष पर है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, उदाहरण के लिए लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस साइट से उसे हटाने के लिए Remove key का उपयोग करें। लिंक Manage licenses and domains in your account आपका vibefox.net खाता खोलता है।

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

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

जब लाइसेंस समाप्त हो जाता है, तो प्लगइन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। स्थिति पृष्ठभूमि में स्वचालित रूप से फिर से जाँची जाती है।

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

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

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

Webhook answers busy, retry later: उसी समय कोई दूसरा वेबहुक इस ऑर्डर को प्रोसेस कर रहा था। Adyen वेबहुक को अपने-आप फिर भेजता है।

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

ग्राहक को Payment could not be initiated दिखता है: ऑर्डर नोट खोलें या Debug log चालू करें और WooCommerce > Status > Logs में source wcp_adyen_gateway देखें। API कुंजी, मर्चेंट खाता और लाइव मोड में Live URL prefix जाँचें।

Order is On hold after payment: ऑर्डर नोट पढ़ें। Adyen द्वारा पुष्ट राशि या मुद्रा ऑर्डर से मेल नहीं खाई, या कैप्चर विफल हुआ। इसका कारण आपकी Order status after payment सेटिंग भी हो सकती है।

रिफ़ंड विफल होता है: ऑर्डर पर Adyen PSP reference होना चाहिए, जो AUTHORISATION वेबहुक से आता है। जिस वातावरण में भुगतान हुआ था, उसके क्रेडेंशियल सेट होने चाहिए। मैनुअल कैप्चर होने पर केवल कैप्चर किए गए भुगतानों का रिफ़ंड हो सकता है।

लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक में दिए संदेश का पालन करें। उदाहरण के लिए, यदि कुंजी पहले से किसी दूसरे डोमेन पर उपयोग हो रही है, तो अपने vibefox.net खाते में एक स्लॉट खाली करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं हो पाती, तो प्लगइन अंतिम ज्ञात स्थिति के आधार पर काम करता रहता है।

अनइंस्टॉल

प्लगइन निष्क्रिय करने पर सारा डेटा बना रहता है। इसे हटाने के लिए, Plugins पेज पर उसे निष्क्रिय करें और फिर हटाएँ। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती है। गेटवे सेटिंग्स और ऑर्डरों पर संग्रहीत Adyen डेटा (PSP references, भुगतान लिंक, संसाधित इवेंट) केवल तभी हटते हैं जब Delete data on uninstall चालू था। अन्यथा ये बाद में दोबारा इंस्टॉल करने के लिए बने रहते हैं। मौजूदा ऑर्डर अपने भुगतान नोट और लेन-देन ID बनाए रखते हैं।

Adyen उसके संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन Adyen से संबद्ध नहीं है और उसके द्वारा अनुमोदित नहीं है।