VibeFox Braintree for WooCommerce — सहायता

आवश्यकताएँ

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

WooCommerce: 8.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय।

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

HTTPS: आपकी साइट HTTPS पर होनी चाहिए।

Braintree खाता: आपको अपने Braintree खाते का Merchant ID, Public Key और Private Key चाहिए। ये Braintree Control Panel में मिलते हैं (सैंडबॉक्स: sandbox.braintreegateway.com, लाइव: www.braintreegateway.com), गियर आइकन के नीचे, API और API Keys में। सैंडबॉक्स और लाइव खातों की कुंजियाँ अलग होती हैं। 3-D Secure आपके Braintree मर्चेंट खाते के लिए सक्षम होना चाहिए, जब तक आप 3-D Secure को Disabled पर सेट न करें। वेबहुक की ज़रूरत नहीं है।

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

इंस्टॉलेशन

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

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

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

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

5. Braintree Control Panel से Merchant ID, Public Key और Private Key को सैंडबॉक्स या लाइव फ़ील्ड में कॉपी करें।

6. Enable/Disable चालू करें। Sandbox mode चालू रखें और Braintree के टेस्ट कार्ड से एक टेस्ट ऑर्डर दें, उदाहरण के लिए 4111 1111 1111 1111 और भविष्य की कोई भी एक्सपायरी तिथि। 3-D Secure के लिए Braintree के 3-D Secure टेस्ट कार्ड उपयोग करें।

7. लाइव क्रेडेंशियल से असली भुगतान लेने के लिए Sandbox mode का निशान हटाएँ।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Braintree। जब गेटवे चालू हो, पर चुने गए मोड के Merchant ID, Public Key या Private Key गायब हों, तो पेज चेतावनी देता है कि जब तक ये भरे नहीं जाते, चेकआउट पर भुगतान विधि छिपी रहती है। पेज केवल चुने गए मोड के क्रेडेंशियल फ़ील्ड दिखाता है; दोनों सेट सहेजे रहते हैं।

सामान्य

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

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

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

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

Braintree Control Panel में (सैंडबॉक्स या लाइव) लॉग इन करें, गियर आइकन पर क्लिक करें, फिर API और API Keys पर जाएँ। पब्लिक और प्राइवेट कुंजियाँ वहीं सूचीबद्ध हैं, और Merchant ID उसी पेज पर दिखता है।

Sandbox mode: Use the Braintree sandbox (test payments, no real money)। डिफ़ॉल्ट: on। असली भुगतान लेने के लिए इसका निशान हटाएँ, तब लाइव क्रेडेंशियल उपयोग होंगे। रिफ़ंड, कैप्चर और void हमेशा उसी वातावरण में होते हैं जिसमें ऑर्डर का भुगतान हुआ था।

Sandbox Merchant ID और Live Merchant ID: सैंडबॉक्स या लाइव खाते का Merchant ID।

Sandbox Public Key और Live Public Key: उस खाते की पब्लिक कुंजी।

Sandbox Private Key और Live Private Key: उस खाते की प्राइवेट कुंजी।

Sandbox merchant account ID(s) और Live merchant account ID(s): वैकल्पिक। Braintree मर्चेंट खाते की मुद्रा में चार्ज करता है। खाली छोड़ें तो आपका डिफ़ॉल्ट मर्चेंट खाता उपयोग होगा; एक ID दर्ज करें (उदाहरण के लिए mystore_EUR) या हर मुद्रा के लिए एक: EUR=mystore_EUR, USD=mystore_USD। यदि चार्ज की गई मुद्रा ऑर्डर की मुद्रा से मेल नहीं खाती, तो लेन-देन अपने-आप void हो जाता है और ग्राहक से शुल्क नहीं लिया जाता।

भुगतान

Transaction type: कार्ड से शुल्क कैसे लिया जाता है।

3-D Secure: 3-D Secure 2 (Strong Customer Authentication) EEA और UK में अधिकांश कार्ड भुगतानों के लिए अनिवार्य है। यह आपके Braintree खाते के लिए भी सक्षम होना चाहिए।

उन्नत

Debug log: Also log API calls and payment steps (errors are always logged)। लॉग WooCommerce > Status > Logs में, source wcp_braintree_gateway के साथ लिखे जाते हैं। इनमें कभी API कुंजियाँ, कार्ड या ग्राहक का डेटा नहीं होता। डिफ़ॉल्ट: off।

Delete data on uninstall: Remove the gateway settings and logs when the plugin is deleted। डिफ़ॉल्ट: off।

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit / debit card) और चेकआउट पेज पर Braintree फ़ॉर्म में कार्ड डालता है। सैंडबॉक्स मोड में फ़ॉर्म पर यह संदेश दिखता है: SANDBOX / TEST MODE — no real money is charged. 3-D Secure चालू होने पर ग्राहक ऑर्डर देते समय बैंक की पुष्टि पूरी करता है।

प्लगइन ऑर्डर की कुल राशि के लिए ऑर्डर की मुद्रा में, Braintree API के माध्यम से एक बार के टोकन पर शुल्क लेता है, और ऑर्डर नंबर को ऑर्डर ID के रूप में भेजता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Braintree का प्रमाणित उत्तर आए और चार्ज की गई राशि व मुद्रा ऑर्डर से मेल खाएँ। भुगतान स्वीकृत होने पर ग्राहक ऑर्डर प्राप्त पेज पर जाता है। कार्ड भुगतानों को वेबहुक की ज़रूरत नहीं होती: परिणाम तुरंत पता चल जाता है।

यदि भुगतान विफल होता है, तो ऑर्डर Pending payment पर रहता है, कारण ऑर्डर नोट में जुड़ता है, और ग्राहक को स्पष्ट संदेश दिखता है, जैसे Your card was declined. Please use another card or contact your bank., 3-D Secure authentication failed. Please try again or use another card. या The card security code or billing address could not be verified. Please check your details and try again. ग्राहक तुरंत दोबारा कोशिश कर सकता है। यदि चार्ज की गई मुद्रा ऑर्डर से मेल नहीं खाती, तो लेन-देन void हो जाता है और ग्राहक को This payment could not be processed in the currency of your order. Your card has not been charged. Please choose another payment method or contact us. दिखता है।

ऑर्डर कभी दो बार चार्ज नहीं होता: भुगतान चलते समय दोबारा सबमिट करने पर This order is already being paid. Please wait a moment and check your e-mail before trying again. दिखता है।

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

प्लगइन केवल कार्ड से भुगतान लेता है। इसमें सेव किए गए कार्ड (vaulting) नहीं हैं, WooCommerce Subscriptions या प्री-ऑर्डर नहीं हैं, PayPal, Venmo, Apple Pay, Google Pay, ACH या स्थानीय भुगतान विधियाँ नहीं हैं, Braintree वेबहुक नहीं हैं, और Level 2/3 डेटा, लाइन आइटम या Fastlane नहीं हैं।

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

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

Pending payment: भुगतान अभी नहीं हुआ है या अस्वीकार हुआ है।

Processing या Completed: कार्ड पर शुल्क लिया गया (Sale), या प्राधिकरण कैप्चर हुआ। WooCommerce Processing सेट करता है, या केवल वर्चुअल डाउनलोड योग्य उत्पादों वाले ऑर्डरों के लिए Completed। ऑर्डर नोट में राशि, 3-D Secure का परिणाम और लेन-देन ID दिखते हैं। लेन-देन ID Braintree का लेन-देन ID है, और ऑर्डर स्क्रीन पर यह Braintree Control Panel में उस लेन-देन से लिंक होता है।

On hold: राशि केवल प्राधिकृत हुई है (Authorize only)। ऑर्डर तब भी On hold होता है जब Braintree कोई अप्रत्याशित लेन-देन स्थिति लौटाए, या गलत मुद्रा का चार्ज अपने-आप void न हो सके। ऑर्डर नोट बताता है कि Braintree Control Panel में क्या जाँचना है।

Cancelled: Void Braintree authorization से प्राधिकरण void किया गया।

कैप्चर और void

प्राधिकरण वाले ऑर्डर के लिए ऑर्डर खोलें, ऑर्डर एक्शन में Capture Braintree payment या Void Braintree authorization चुनें, फिर अपडेट बटन पर क्लिक करें। कैप्चर ऑर्डर को भुगतान किया हुआ चिह्नित करता है; void ऑर्डर रद्द करता है और रोकी गई राशि ग्राहक के लिए जारी कर देता है। यदि कार्रवाई विफल हो, तो त्रुटि ऑर्डर स्क्रीन पर दिखती है और ऑर्डर नोट में जुड़ती है।

रिफ़ंड

ऑर्डर खोलें, Refund पर क्लिक करें, राशि दर्ज करें और Refund via Credit / debit card पर क्लिक करें (बटन पर आपकी भुगतान विधि का शीर्षक आता है)। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। Braintree केवल सेटल हुए लेन-देनों का रिफ़ंड कर सकता है, जो आमतौर पर 24 घंटे के भीतर सेटल होते हैं। सेटलमेंट से पहले पूर्ण रिफ़ंड void के रूप में होता है; उसके बाद आंशिक रिफ़ंड विफल होता है और सेटलमेंट की प्रतीक्षा करने का संदेश दिखता है। रिफ़ंड उसी वातावरण (सैंडबॉक्स या लाइव) में भेजा जाता है जिसमें ऑर्डर का भुगतान हुआ था। यदि Braintree रिफ़ंड स्वीकार नहीं करता, तो WooCommerce त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड या void ऑर्डर नोट में जुड़ता है।

विवाद (चार्जबैक) और सेटलमेंट में अस्वीकृत भुगतान WooCommerce के साथ सिंक नहीं होते। इन्हें Braintree Control Panel में जाँचें।

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

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

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

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

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

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

Braintree चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और चुने गए मोड में Merchant ID, Public Key और Private Key भरे हैं। कोई कुंजी गायब होने पर सेटिंग्स पेज चेतावनी दिखाता है।

भुगतान हो गया, पर ऑर्डर Pending payment पर रहता है: कार्ड भुगतान वेबहुक के बिना, तुरंत पुष्ट होते हैं। यदि ऑर्डर नोट कहता है कि Braintree का उत्तर खो गया, तो कोई और भुगतान स्वीकार करने से पहले Braintree Control Panel में इस ऑर्डर नंबर वाला लेन-देन जाँचें। Debug log चालू करें और WooCommerce > Status > Logs में source wcp_braintree_gateway देखें।

कार्ड फ़ॉर्म में Could not initialize payment form दिखता है: चुने गए मोड की कुंजियाँ गलत हैं, या मर्चेंट खाता ID उस खाते में मौजूद नहीं है। कुंजियाँ और merchant account ID(s) जाँचें, फिर पेज दोबारा लोड करें।

हर भुगतान पर 3-D Secure विफल होता है: 3-D Secure आपके Braintree मर्चेंट खाते के लिए सक्षम होना चाहिए। Braintree सहायता से संपर्क करें, या 3-D Secure को Disabled पर सेट करें (EEA और UK में इसकी सलाह नहीं दी जाती, जहाँ SCA अनिवार्य है)।

ग्राहक को बताया जाता है कि भुगतान ऑर्डर की मुद्रा में संसाधित नहीं हो सका: Braintree ने मर्चेंट खाते की मुद्रा में चार्ज किया। वर्तमान मोड के मर्चेंट खाता फ़ील्ड में ऑर्डर की मुद्रा के लिए मर्चेंट खाता ID दर्ज करें।

भुगतान के तुरंत बाद आंशिक रिफ़ंड विफल होता है: Braintree केवल सेटल हुए लेन-देनों का रिफ़ंड कर सकता है, आमतौर पर 24 घंटे के भीतर। लेन-देन अभी void करने के लिए पूरी राशि रिफ़ंड करें, या सेटलमेंट के बाद आंशिक रिफ़ंड करें।

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

अनइंस्टॉल

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

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