VibeFox Braintree for OpenCart — सहायता

आवश्यकताएँ

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

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

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

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

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

5. Enable/Disable चालू करें और Save पर क्लिक करें। Sandbox mode चालू रखें और Braintree सैंडबॉक्स के टेस्ट कार्ड (जैसे 4111 1111 1111 1111) से एक टेस्ट ऑर्डर दें। फिर लाइव क्रेडेंशियल दर्ज करें और वास्तविक भुगतान लेने के लिए Sandbox mode बंद करें।

OpenCart 4

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

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

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

4. लाइसेंस कुंजी और Braintree क्रेडेंशियल दर्ज करें, और OpenCart 3 के चरण 3 से 5 की तरह भुगतान की जाँच करें। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं।

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Braintree Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरे पेज को सेव करता है। जब भुगतान विधि सक्षम हो लेकिन चुने हुए वातावरण का Merchant ID, Public Key या Private Key न हो, तब पेज चेतावनी देता है कि इन्हें भरे जाने तक भुगतान विधि चेकआउट पर छिपी रहेगी। सैंडबॉक्स मोड चालू रहने पर पेज Sandbox mode is on: test payments, no real money. दिखाता है। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, लेकिन उन्हें सेव नहीं कर सकता।

सेव करते समय Title में 1 से 128 अक्षर होने चाहिए, Sort Order पूर्ण संख्या होनी चाहिए और Total 0 या उससे बड़ी संख्या होनी चाहिए। किसी भी फ़ील्ड में त्रुटि होने पर कुछ भी सेव नहीं होता और पेज उस फ़ील्ड का नाम बताता है।

Braintree

Enable/Disable: Braintree कार्ड भुगतान चालू या बंद करता है। चुने हुए वातावरण का Merchant ID, Public Key और Private Key भरे जाने तक भुगतान विधि चेकआउट पर छिपी रहती है। डिफ़ॉल्ट: बंद।

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

Description: वह टेक्स्ट जो ग्राहक को Confirm Order चरण में, कार्ड फ़ॉर्म के ऊपर दिखता है। डिफ़ॉल्ट: Pay securely with your credit or debit card via Braintree.

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

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

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

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

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

Sandbox mode: Braintree सैंडबॉक्स का उपयोग करता है (टेस्ट भुगतान, कोई वास्तविक राशि नहीं)। डिफ़ॉल्ट: चालू। लाइव क्रेडेंशियल से वास्तविक भुगतान लेने के लिए इसे बंद करें। रिफ़ंड, कैप्चर और void हमेशा उसी वातावरण में होते हैं जिसमें ऑर्डर का भुगतान हुआ था। चालू रहने पर ग्राहक Confirm Order चरण पर SANDBOX / TEST MODE — no real money is charged. देखते हैं।

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

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

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

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

भुगतान

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

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

कार्ड से शुल्क लेने से पहले 3-D Secure का परिणाम केवल ब्राउज़र में नहीं, बल्कि सर्वर पर भी जाँचा जाता है।

ऑर्डर

OpenCart Confirm Order चरण पर ऑर्डर बिना स्थिति के बनाता है (एक लापता ऑर्डर)। Braintree द्वारा कार्ड भुगतान स्वीकार किए जाने के बाद ही उसे स्थिति मिलती है। अस्वीकृत कार्ड से ऑर्डर बिना स्थिति के रहता है और ग्राहक पुष्टि चरण पर बना रहता है। नीचे की हर फ़ील्ड आपके OpenCart ऑर्डर स्थितियों की सूची देती है।

Order Status After Payment: बिक्री का शुल्क लिया गया, या ऑर्डर टैब पर प्राधिकरण कैप्चर किया गया। डिफ़ॉल्ट: प्रोसेसिंग।

Authorized Status: केवल प्राधिकरण: राशि रोकी गई है, अभी भुगतान नहीं हुआ। डिफ़ॉल्ट: भुगतान लंबित, क्योंकि OpenCart में होल्ड पर स्थिति नहीं है; ऑर्डर नोट और ऑर्डर टैब इसे समझाते हैं। आप System > Localisation > Order Statuses में अपनी स्थिति बना सकते हैं और यहाँ चुन सकते हैं।

On Hold (Review) Status: Braintree ने कोई अप्रत्याशित लेन-देन स्थिति लौटाई, या चार्ज की गई राशि या मुद्रा मेल नहीं खाई और स्वचालित void विफल रहा। नोट बताता है कि क्या जाँचना है। डिफ़ॉल्ट: भुगतान लंबित।

Voided Status: ऑर्डर टैब पर प्राधिकरण void हुआ और रोकी गई राशि जारी हो गई। डिफ़ॉल्ट: रद्द।

Refunded Status: भुगतान की पूरी राशि रिफ़ंड हो गई, या सेटलमेंट से पहले पूर्ण रिफ़ंड के रूप में void की गई। आंशिक रिफ़ंड केवल एक नोट जोड़ते हैं। डिफ़ॉल्ट: रिफ़ंड किया गया।

एडवांस्ड

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

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

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

इम्पोर्ट / एक्सपोर्ट

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

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

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit / debit card)। Confirm Order चरण पर ग्राहक को आपका विवरण और स्टोर की भाषा में Braintree से लोड किया गया Braintree कार्ड फ़ॉर्म दिखता है। OpenCart इसी चरण पर ऑर्डर बनाता है, अब भी बिना स्थिति के। जब ग्राहक Confirm Order पर क्लिक करता है, तो फ़ॉर्म कार्ड की जाँच करता है; 3-D Secure चालू होने पर ग्राहक बैंक का सत्यापन पूरा करता है। ऑर्डर का कुल, ईमेल और बिलिंग पता फ़ॉर्म को दिए जाते हैं। आपके स्टोर तक केवल एक बार उपयोग होने वाला टोकन पहुँचता है। OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से भुगतान विधि चुनता है, जो Payment method options विंडो में खुलती है। फिर कार्ड फ़ॉर्म चेकआउट पेज के नीचे, पुष्टि ब्लॉक में, Confirm Order बटन के ऊपर दिखता है। यदि स्टोर भुगतान पता नहीं माँगता (OpenCart 4 का डिफ़ॉल्ट), तो 3-D Secure जाँच उसके बदले शिपिंग पता लेती है।

इसके बाद एक्सटेंशन Braintree API के माध्यम से ऑर्डर की मुद्रा में ऑर्डर के कुल के लिए टोकन पर शुल्क लेता है; Braintree में ऑर्डर ID के रूप में OpenCart ऑर्डर नंबर इस्तेमाल होता है। चार्ज की गई राशि और मुद्रा की ऑर्डर से तुलना होती है। ऑर्डर को स्थिति तभी मिलती है जब Braintree भुगतान स्वीकार कर ले, OpenCart के सामान्य तरीके से, साथ में सामान्य ऑर्डर ईमेल और स्टॉक अपडेट। कार्ट खाली कर दिया जाता है और ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है।

भुगतान विफल होने पर ऑर्डर बिना स्थिति के रहता है, ऑर्डर में कारण बताने वाला एक नोट जुड़ जाता है, और ग्राहक Confirm Order चरण पर एक संदेश के साथ बना रहता है, जैसे 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. दिखता है। पहले से भुगतान किए गए ऑर्डर की दोबारा पुष्टि सीधे सफलता पेज पर ले जाती है; अधिकृत भुगतान के लिए A payment for this order has already been received and is awaiting review. दिखता है। यदि कार्ड से शुल्क लिया गया, लेकिन OpenCart ऑर्डर की स्थिति सेट नहीं कर पाया, तो ग्राहक को Your payment was received, but the order could not be completed automatically. Please contact us — do not pay again. दिखता है। उसी कार्ट के साथ अगला प्रयास, सहेजे गए लेन-देन से उस ऑर्डर की स्थिति दोबारा शुल्क लिए बिना सेट करता है। OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर एक नया ऑर्डर बनाता है, इसलिए एक ही कार्ट के कई ऑर्डर हो सकते हैं (OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसे अपडेट करता है, इसलिए कार्ड अस्वीकृत होने के बाद ग्राहक वही ऑर्डर भुगतान करता है): उनमें से एक का भुगतान होते ही उसी कार्ट के किसी दूसरे ऑर्डर का शुल्क नहीं लिया जाता, और ग्राहक को This cart has already been paid with order #…. Please check your order history — do not pay again. दिखता है।

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

यह एक्सटेंशन केवल कार्ड भुगतान लेता है। इसमें सेव किए गए कार्ड, सब्सक्रिप्शन या आवर्ती भुगतान, PayPal, Venmo, Apple Pay, Google Pay या स्थानीय भुगतान विधियाँ नहीं हैं, और Braintree वेबहुक भी नहीं हैं।

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

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

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

Order Status After Payment (डिफ़ॉल्ट Processing): कार्ड से शुल्क लिया गया (Sale), या प्राधिकरण कैप्चर किया गया। एक नोट राशि, Braintree लेन-देन ID और 3-D Secure परिणाम दिखाता है।

Authorized Status (डिफ़ॉल्ट Pending): राशि केवल अधिकृत है (Authorize only)। एक नोट आपसे शिपिंग से पहले ऑर्डर पेज पर भुगतान कैप्चर करने को कहता है।

On Hold (Review) Status (डिफ़ॉल्ट Pending): Braintree ने कोई अप्रत्याशित लेन-देन स्थिति लौटाई, या गलत मुद्रा या राशि के शुल्क को स्वचालित रूप से void नहीं किया जा सका। नोट बताता है कि Braintree Control Panel में क्या जाँचना है।

Voided Status (डिफ़ॉल्ट Canceled): एक प्राधिकरण void किया गया।

Refunded Status (डिफ़ॉल्ट Refunded): भुगतान एक्सटेंशन के माध्यम से पूरी तरह रिफ़ंड किया गया।

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

VibeFox Braintree Gateway टैब

Sales > Orders में Braintree से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Braintree Gateway टैब सैंडबॉक्स भुगतानों के लिए Sandbox लेबल के साथ Transaction ID (उसके वातावरण के Braintree Control Panel में लेन-देन से लिंक), लेन-देन की Status, Amount और मर्चेंट खाता, 3-D Secure परिणाम, Charged / refunded राशियाँ, कैप्चर, void और रिफ़ंड बटन, रिफ़ंड इतिहास और ऑर्डर के Braintree notes दिखाता है। यह टैब उन उपयोगकर्ताओं को दिखता है जिनकी एक्सटेंशन तक पहुँच है; बटन इस्तेमाल करने के लिए एक्सटेंशन बदलने का अधिकार चाहिए (System > Users > User Groups में सेट)।

कैप्चर और void

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

रिफ़ंड

VibeFox Braintree Gateway टैब में Amount दर्ज करें (जो राशि अभी रिफ़ंड नहीं हुई है वह अपने-आप भर जाती है), वैकल्पिक रूप से Reason (optional) लिखें, और Refund via Braintree पर क्लिक करें। प्रश्न Refund this amount through Braintree? This cannot be undone. की पुष्टि करें। पूर्ण और आंशिक दोनों रिफ़ंड समर्थित हैं, कैप्चर किए गए भुगतान और समीक्षा में चल रहे भुगतान, दोनों के लिए। रिफ़ंड उसी राशि और मुद्रा में होते हैं जो Braintree ने चार्ज की थी। Braintree केवल सेटल हो चुके लेन-देन रिफ़ंड करता है, आमतौर पर 24 घंटों के भीतर। सेटलमेंट से पहले पूर्ण रिफ़ंड void के रूप में होता है; तब आंशिक रिफ़ंड इस संदेश के साथ विफल होता है कि सेटलमेंट की प्रतीक्षा करें। रिफ़ंड भुगतान के वातावरण (सैंडबॉक्स या लाइव) को भेजा जाता है, इसलिए उस वातावरण के क्रेडेंशियल सेट होने चाहिए। यदि Braintree रिफ़ंड स्वीकार नहीं करता, तो टैब त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड रिफ़ंड इतिहास और नोट्स में जुड़ जाता है। पूर्ण रिफ़ंड ऑर्डर को Refunded Status पर सेट करता है; आंशिक रिफ़ंड स्थिति नहीं बदलता। टैब से की गई स्थिति बदलाव ग्राहक को सूचित नहीं करते और उत्पादों को स्टॉक में वापस नहीं करते, जैसे मैन्युअल स्थिति बदलाव।

Sales > Returns में उत्पाद वापसी Braintree के माध्यम से पैसे वापस नहीं भेजती। चार्जबैक, सेटलमेंट अस्वीकृतियाँ और Braintree Control Panel में किए गए रिफ़ंड OpenCart के साथ सिंक नहीं होते।

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

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

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

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

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

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

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

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

ग्राहक को Your session has expired. Please refresh the page and try again. दिखता है: फ़ॉर्म खुला होने के दौरान चेकआउट सत्र बदल गया। ग्राहक को चेकआउट पेज रीलोड करना होगा।

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

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

ग्राहक को The order total must be greater than zero to pay by card. दिखता है: ऑर्डर का कुल शून्य है, उदाहरण के लिए किसी वाउचर के बाद। ऐसे ऑर्डर कार्ड से भुगतान नहीं किए जा सकते।

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

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

अनइंस्टॉल

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

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

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