VibeFox Authorize.Net for WooCommerce — सहायता

आवश्यकताएँ

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

WooCommerce: 7.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। WooCommerce के बिना प्लगइन एडमिन क्षेत्र में एक सूचना दिखाता है, और भुगतान विधि लोड नहीं होती।

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

HTTPS: आपके चेकआउट को HTTPS का उपयोग करना होगा। Accept.js सादे HTTP पर नहीं चलता।

Authorize.Net खाता: आपको अपने Authorize.Net खाते की API Login ID, Transaction Key और Public Client Key चाहिए, और वेबहुक उपयोग करने पर Signature Key भी। प्रोडक्शन (account.authorize.net) और सैंडबॉक्स (sandbox.authorize.net) खातों के क्रेडेंशियल अलग होते हैं। Authorize.Net खाते अमेरिका, कनाडा, UK, यूरोप, ऑस्ट्रेलिया और न्यूज़ीलैंड के मर्चेंट के लिए उपलब्ध हैं।

मुद्रा: स्टोर मुद्रा USD, CAD, CHF, DKK, EUR, GBP, NOK, PLN, SEK, AUD या NZD होनी चाहिए, और आपका Authorize.Net खाता उसी में सेटल होना चाहिए। अन्य मुद्राओं के लिए चेकआउट पर भुगतान विधि छिपी रहती है।

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

इंस्टॉलेशन

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

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

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

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

5. सैंडबॉक्स और प्रोडक्शन खातों के क्रेडेंशियल दर्ज करें (देखें कॉन्फ़िगरेशन)। चाहें तो वेबहुक भी सेट करें।

6. Enable/Disable चालू करें, Transaction type चुनें और सहेजें। सैंडबॉक्स मोड में कार्ड 4111 1111 1111 1111, कोई भी भविष्य की समाप्ति तिथि और कोई भी CVV लेकर एक भुगतान का परीक्षण करें, फिर Sandbox mode का निशान हटाएँ।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Authorize.Net। फ़ील्ड के ऊपर पेज चेतावनी देता है कि साइट HTTPS का उपयोग नहीं करती (Accept.js केवल HTTPS पेजों पर काम करता है), और जब स्टोर मुद्रा समर्थित न हो (तब चेकआउट पर भुगतान विधि छिपी रहती है)। पेज केवल चुने गए मोड के क्रेडेंशियल फ़ील्ड दिखाता है।

सामान्य

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

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

Description: चेकआउट पर कार्ड फ़ॉर्म के ऊपर दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely with your credit card via Authorize.Net।

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

Authorize.Net Merchant Interface में Account > Settings > Security Settings खोलें। API Credentials & Keys के तहत API Login ID कॉपी करें और एक Transaction Key और एक Signature Key बनाएँ। Manage Public Client Key के तहत Public Client Key कॉपी करें। सैंडबॉक्स और प्रोडक्शन में अलग क्रेडेंशियल उपयोग होते हैं।

Sandbox mode: Use the Authorize.Net sandbox (test transactions, no real charges)। API एंडपॉइंट, Accept.js और नीचे दिए क्रेडेंशियल के सेट को बदलता है। डिफ़ॉल्ट: on। असली भुगतान लेने के लिए निशान हटाएँ।

Live API Login ID और Sandbox API Login ID: प्रोडक्शन या सैंडबॉक्स खाते का API Login ID।

Live Transaction Key और Sandbox Transaction Key: उस खाते की Transaction Key।

Live Public Client Key और Sandbox Public Client Key: ब्राउज़र में Accept.js द्वारा उपयोग की जाने वाली सार्वजनिक कुंजी।

Live Signature Key और Sandbox Signature Key: केवल वेबहुक के लिए आवश्यक। यह हर सूचना के X-ANET-Signature हेडर को सत्यापित करती है।

भुगतान

Transaction type: कार्ड से शुल्क कैसे लिया जाता है। प्राधिकरण 30 दिन बाद समाप्त हो जाता है।

वेबहुक (अनुशंसित)

वेबहुक के बिना, Fraud Detection Suite द्वारा रोके गए या Authorize.Net पैनल में कैप्चर या वॉइड किए गए ऑर्डर हाथ से अपडेट करने होते हैं। Merchant Interface में Account > Settings > Business Settings > Webhooks पर जाएँ और Add Endpoint पर क्लिक करें। सेटिंग्स के इस सेक्शन में दिखाया गया URL उपयोग करें। यह ऐसा दिखता है: https://your-site/wc-api/wc_authorizenet/। ये इवेंट चुनें:

खाते की Signature Key Live Signature Key या Sandbox Signature Key में दर्ज करें। बिना वैध हस्ताक्षर वाले वेबहुक अस्वीकार होते हैं। हर सूचना के लिए प्लगइन ऑर्डर बदलने से पहले Authorize.Net से लेन-देन की वर्तमान स्थिति और राशि भी पूछता है, इसलिए दोहराई गई सूचनाएँ कुछ नहीं बदलतीं।

उन्नत

Debug log: Log API requests and responses को WooCommerce > Status > Logs में, source wcp_authorizenet_gateway के साथ लिखें। कुंजियाँ, कार्ड टोकन और निजी डेटा छिपाए जाते हैं। डिफ़ॉल्ट: off।

Delete data on uninstall: Remove the settings and the Authorize.Net order meta when the plugin is deleted। डिफ़ॉल्ट: off।

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit Card) और चेकआउट पेज पर कार्ड नंबर, समाप्ति तिथि (MM/YY) और कार्ड कोड (CVV) दर्ज करता है। सैंडबॉक्स मोड में फ़ॉर्म टेस्ट कार्ड 4111 1111 1111 1111 का संकेत दिखाता है। ऑर्डर देते समय Accept.js ब्राउज़र में कार्ड डेटा को एक बार उपयोग होने वाले टोकन से बदलता है। कार्ड फ़ील्ड में फ़ॉर्म नाम नहीं होते, इसलिए कार्ड नंबर और CVV कभी आपके सर्वर तक नहीं पहुँचते।

प्लगइन ऑर्डर की कुल राशि ऑर्डर की मुद्रा में Authorize.Net API के माध्यम से टोकन से शुल्क लेता है। पते की पुष्टि और फ़्रॉड फ़िल्टर के लिए बिलिंग पता, ईमेल और IP पता लेन-देन के साथ भेजे जाते हैं। यदि भुगतान स्वीकृत होता है, तो ग्राहक ऑर्डर प्राप्त पेज पर जाता है और कार्ट खाली हो जाता है।

यदि कार्ड अस्वीकार होता है, तो ग्राहक चेकआउट पर ही रहता है और Payment failed: के बाद कारण देखता है, उदाहरण के लिए कार्ड अस्वीकृत, गलत कार्ड कोड या समाप्त कार्ड। कॉन्फ़िगरेशन और API त्रुटियाँ ग्राहकों को नहीं दिखाई जातीं: उन्हें एक सामान्य संदेश दिखता है, और विवरण ऑर्डर नोट और लॉग में जाते हैं। यदि स्टोर Authorize.Net तक नहीं पहुँच पाता, तो ग्राहक को Payment error: unable to connect to the payment gateway. Please try again. दिखता है।

बार-बार सबमिट करने या एक ही ऑर्डर का दोबारा भुगतान करने से उसका दूसरी बार शुल्क नहीं लिया जाता। भुगतान विधि क्लासिक चेकआउट, Checkout ब्लॉक और Pay for order पेज पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।

प्लगइन में सेव किए गए कार्ड या ग्राहक प्रोफ़ाइल नहीं हैं, WooCommerce Subscriptions या Pre-Orders नहीं हैं, eCheck/ACH, Apple Pay, Google Pay, PayPal या 3-D Secure नहीं हैं, प्राधिकरण का आंशिक कैप्चर नहीं है और स्वचालित मुद्रा रूपांतरण नहीं है।

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

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

Processing or Completed: कार्ड से शुल्क लिया गया (Authorize and capture), या कोई प्राधिकरण कैप्चर हुआ। WooCommerce प्रोसेसिंग सेट करता है, या केवल वर्चुअल डाउनलोड योग्य उत्पादों वाले ऑर्डर के लिए पूर्ण। ऑर्डर नोट में राशि, लेन-देन ID, auth code, कार्ड का प्रकार और अंतिम चार अंक दिखते हैं। लेन-देन ID Authorize.Net Trans ID है।

On hold: राशि केवल प्राधिकृत है (Authorize only), या Fraud Detection Suite ने लेन-देन को समीक्षा के लिए रोका है। रुके लेन-देन को Authorize.Net पैनल में स्वीकृत या अस्वीकृत करें; वेबहुक के साथ ऑर्डर अपने-आप अपडेट होता है। ऑर्डर तब भी होल्ड पर जाता है जब वेबहुक से बताया गया कैप्चर ऑर्डर की राशि से मेल न खाए।

Cancelled: एक वेबहुक ने बताया कि ऑर्डर का भुगतान होने से पहले लेन-देन अस्वीकृत, वॉइड या समाप्त हो गया। यदि यह भुगतान किए गए ऑर्डर के साथ हो, तो उसकी स्थिति नहीं बदलती और एक चेतावनी नोट जुड़ता है।

कैप्चर

प्राधिकरण वाले ऑर्डर के लिए ऑर्डर खोलें, ऑर्डर एक्शन में Capture payment (Authorize.Net) चुनें और अपडेट बटन पर क्लिक करें। रिफ़ंड घटाकर पूरी ऑर्डर राशि कैप्चर होती है, और ऑर्डर भुगतान किया हुआ चिह्नित होता है। यदि कैप्चर विफल होता है, तो त्रुटि दिखती है और ऑर्डर नोट में जुड़ती है। आप Authorize.Net पैनल में भी कैप्चर कर सकते हैं; वेबहुक के साथ ऑर्डर अपने-आप अपडेट होता है।

रिफ़ंड

ऑर्डर खोलें, Refund पर क्लिक करें, राशि दर्ज करें और Refund via Credit Card पर क्लिक करें (बटन आपकी भुगतान विधि का शीर्षक उपयोग करता है)। पूरी ऑर्डर राशि का रिफ़ंड पहले लेन-देन को वॉइड करता है, यदि वह अभी सेटल नहीं हुआ हो, या कोई प्राधिकरण जो कैप्चर नहीं हुआ। सेटल हो चुके लेन-देन, आमतौर पर 24 घंटे बाद, का पूरा या आंशिक रिफ़ंड हो सकता है। सेटलमेंट से पहले आंशिक रिफ़ंड संभव नहीं है: लेन-देन वॉइड करने के लिए पूरी राशि का रिफ़ंड करें, या सेटलमेंट के बाद फिर कोशिश करें। यदि Authorize.Net रिफ़ंड स्वीकार नहीं करता, तो WooCommerce त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड या वॉइड ऑर्डर नोट में जुड़ता है।

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

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

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

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

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

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

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

Authorize.Net चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और मौजूदा मोड में API Login ID, Transaction Key और Public Client Key हैं। जाँचें कि स्टोर मुद्रा समर्थित है; मुद्रा समर्थित न होने पर सेटिंग्स पेज चेतावनी दिखाता है।

भुगतान हो गया, पर ऑर्डर On hold पर रहता है: लेन-देन प्रकार Authorize only है (उसे ऑर्डर एक्शन से कैप्चर करें), या Authorize.Net ने लेन-देन को समीक्षा के लिए रोका है। उसे Authorize.Net पैनल में स्वीकृत या अस्वीकृत करें। ऐसे ऑर्डर अपने-आप अपडेट हों, इसके लिए वेबहुक सेट करें: जाँचें कि endpoint URL सेटिंग्स में दिखाए URL से बिल्कुल मेल खाता है, चारों इवेंट चुने गए हैं, और मौजूदा मोड की Signature Key दर्ज है।

Webhook answers webhooks are not configured: किसी भी मोड के लिए Signature Key दर्ज नहीं है।

Webhook answers invalid signature: Signature Key किसी दूसरे खाते या मोड की है। Signature Key दोबारा बनाएँ या कॉपी करें, और उसे उसके मोड के फ़ील्ड में चिपकाएँ।

Webhook answers verification failed, retry later: स्टोर Authorize.Net API से लेन-देन नहीं पढ़ पाया। Authorize.Net सूचना फिर भेजता है।

The card form does not load or shows The secure card form (Accept.js) could not be loaded: चेकआउट HTTPS पर होना चाहिए, और मौजूदा मोड की Public Client Key और API Login ID सही होनी चाहिए।

Payment error: the card could not be tokenized: Accept.js ने टोकन नहीं लौटाया। ग्राहक को कार्ड का विवरण दोबारा दर्ज करके फिर कोशिश करनी चाहिए।

The customer sees a general error: ऑर्डर नोट खोलें या Debug log चालू करें और WooCommerce > Status > Logs में source wcp_authorizenet_gateway देखें। जो मुद्रा खाता समर्थित नहीं करता, उसे Authorize.Net अस्वीकार करता है।

A partial refund fails because the transaction is not settled yet: लेन-देन वॉइड करने के लिए पूरी ऑर्डर राशि का रिफ़ंड करें, या सेटलमेंट के बाद, आमतौर पर 24 घंटे के भीतर, फिर कोशिश करें।

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

अनइंस्टॉल

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

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