VibeFox TrustPay for OpenCart — सहायता

आवश्यकताएँ

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

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

finby (TrustPay) खाता: आपको finby Merchant Portal में एक प्रोजेक्ट चाहिए, जिसका Project ID और Secret key हो। टेस्ट भुगतान के लिए आपको एक अलग टेस्ट (playground) प्रोजेक्ट चाहिए, जिसका अपना Project ID और Secret key हो। और किसी कुंजी की ज़रूरत नहीं है: Secret key का उपयोग API एक्सेस पाने और भुगतान सूचनाओं के हस्ताक्षर की जाँच, दोनों के लिए होता है।

पहुँच योग्य notification URL: finby को इंटरनेट से आपके स्टोर तक पहुँच सकना चाहिए। स्टोर के सामने फ़ायरवॉल, रखरखाव (maintenance) लॉगिन या HTTP authentication भुगतान सूचनाओं को रोक देते हैं।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. अपने टेस्ट प्रोजेक्ट का Project ID और Secret key, और असली भुगतान के लिए अपने लाइव प्रोजेक्ट का Project ID और Secret key दर्ज करें (देखें Configuration)। notification URL हर भुगतान के साथ भेजा जाता है, इसलिए Merchant Portal में कुछ भी सेट करने की ज़रूरत नहीं है।

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

OpenCart 4

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

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

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

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

नया इंस्टॉल भुगतान तरीका बंद और test mode चालू के साथ शुरू होता है।

Configuration

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox TrustPay Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरे पेज को सेव करता है। सेटिंग्स के ऊपर पेज आपको चेतावनी देता है, जब भुगतान तरीका चालू हो लेकिन वर्तमान मोड का Project ID या Secret key खाली हो, और जब स्टोर की डिफ़ॉल्ट मुद्रा सपोर्टेड न हो। दोनों स्थितियों में भुगतान तरीका चेकआउट पर छिपा रहता है। एक्सटेंशन को बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

सेव करते समय Title खाली नहीं हो सकता और 128 अक्षरों से ज़्यादा नहीं होना चाहिए, Sort order पूर्णांक (integer) होना चाहिए (ऋणात्मक मान स्वीकार्य हैं), Minimum total 0 या उससे अधिक संख्या होनी चाहिए, और चुने गए geo zone और ऑर्डर स्थितियाँ मौजूद होनी चाहिए। अन्यथा कुछ भी सेव नहीं होता और पेज संदेश दिखाता है। Project ID में केवल अंक हो सकते हैं: यदि आप कोई और मान सेव करते हैं, तो पेज must contain digits only — the previous value was kept. दिखाता है और बाकी फ़ील्ड सेव हो जाते हैं।

TrustPay / finby

Enable / Disable: Enable TrustPay / finby card payments. भुगतान तरीके को चालू या बंद करता है। डिफ़ॉल्ट: बंद।

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

Description: वह टेक्स्ट जो ग्राहक को Confirm Order चरण पर पुष्टि बटन के ऊपर दिखता है। डिफ़ॉल्ट: Pay securely by card on the TrustPay / finby payment page।

Sort order: चेकआउट पर भुगतान तरीके की स्थिति। खाली छोड़ें या एक पूर्णांक दर्ज करें (ऋणात्मक मान स्वीकार्य हैं)।

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

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

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

finby (TrustPay) Merchant Portal से अपने प्रोजेक्ट का Project ID और Secret key कॉपी करें। इस सेक्शन में Merchant Portal का लिंक है। टेस्ट भुगतान के लिए एक अलग टेस्ट (playground) प्रोजेक्ट का उपयोग होता है, जिसका अपना Project ID और Secret key होता है। वहाँ कोई असली पैसा नहीं लिया जाता।

Test mode: टेस्ट प्रोजेक्ट का उपयोग करता है (कोई असली भुगतान नहीं)। नए भुगतान और रिफ़ंड टेस्ट क्रेडेंशियल का उपयोग करते हैं। किसी ऑर्डर के रिफ़ंड हमेशा उसी प्रोजेक्ट पर जाते हैं जिससे उसका भुगतान हुआ था। डिफ़ॉल्ट: चालू। चालू रहने पर ग्राहक Confirm Order चरण पर Test mode: no real payment will be taken. देखते हैं।

Live Project ID: आपके लाइव प्रोजेक्ट का संख्यात्मक Project ID।

Live Secret key: लाइव प्रोजेक्ट की Secret key। इसका उपयोग API access tokens पाने और भुगतान सूचनाओं की जाँच के लिए होता है।

Test Project ID: आपके टेस्ट (playground) प्रोजेक्ट का संख्यात्मक Project ID।

Test Secret key: टेस्ट प्रोजेक्ट की Secret key।

Secret key ठीक वैसे ही सेव होती हैं जैसी दर्ज की जाती हैं; केवल शुरू और अंत के खाली स्थान हटाए जाते हैं। सेव की गई Secret key फिर कभी नहीं दिखाई जाती। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें। सेटिंग्स सेव करने पर कैश्ड API access tokens भी हट जाते हैं, इसलिए नए क्रेडेंशियल तुरंत इस्तेमाल होते हैं।

Clear saved secrets: किसी Secret key पर टिक करें और उसे हटाने के लिए Save पर क्लिक करें। खाली फ़ील्ड सेव किए गए मान को बनाए रखता है।

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

OpenCart Confirm Order चरण पर ऑर्डर बिना स्थिति के बनाता है (एक लापता ऑर्डर)। ऑर्डर को स्थिति तभी मिलती है जब finby उसकी हस्ताक्षरित सूचना से पुष्टि करता है। नीचे का हर फ़ील्ड आपकी OpenCart ऑर्डर स्थितियों की सूची देता है। OpenCart में लंबित या रोके गए TrustPay भुगतान के लिए अपनी कोई स्थिति नहीं है, इसलिए दोनों डिफ़ॉल्ट रूप से Pending का उपयोग करते हैं; ऑर्डर नोट्स और ऑर्डर टैब उन्हें अलग दिखाते हैं। अपनी स्थितियाँ System > Localisation > Order Statuses में बना सकते हैं और यहाँ चुन सकते हैं।

Order status after payment: भुगतान किए गए ऑर्डर की स्थिति। डिफ़ॉल्ट: Processing। यदि भुगतान किए गए ऑर्डर तुरंत पूरे (Complete) होने चाहिए, तो Complete चुनें। स्थिति एक ही चरण में सेट होती है, इसलिए ग्राहक को एक ही ईमेल मिलता है।

Awaiting TrustPay payment: finby ने नवीनतम भुगतान को लंबित बताया है; finby की पुष्टि पर ऑर्डर भुगतान हुई स्थिति में चला जाता है। डिफ़ॉल्ट: Pending।

TrustPay payment on hold: भुगतान केवल authorize हुआ है (उसे Merchant Portal में capture करना होगा), या भुगतान की गई राशि या मुद्रा भुगतान अनुरोध या ऑर्डर की कुल राशि से अलग है। डिफ़ॉल्ट: Pending।

Payment error: finby ने प्रतीक्षारत ऑर्डर के नवीनतम भुगतान को अस्वीकार कर दिया। बाद में पुष्ट हुआ भुगतान फिर भी ऑर्डर को भुगतान हुई स्थिति में ले जाता है। डिफ़ॉल्ट: Failed।

Cancelled order status: एक्सटेंशन इसे सेट नहीं करता। इस स्थिति वाला ऑर्डर किसी देर से आए भुगतान से फिर नहीं खुलता; एक नोट जोड़ दिया जाता है। डिफ़ॉल्ट: Canceled।

Refunded order status: ऑर्डर पेज से पूर्ण रिफ़ंड के बाद सेट होती है। डिफ़ॉल्ट: Refunded।

भुगतान सूचनाएँ

ऑर्डर को भुगतान हुआ तभी चिह्नित किया जाता है जब finby उसे हस्ताक्षरित सूचना से पुष्ट करता है। एक्सटेंशन हर भुगतान के साथ notification URL अपने-आप भेजता है, इसलिए आपको इसे सेट करने की ज़रूरत नहीं है। सेक्शन Notification URL के नीचे URL दिखाता है। OpenCart 3 में यह कुछ इस तरह दिखता है: https://your-store/index.php?route=extension/payment/wcp_trustpay_gateway/callback, और OpenCart 4 में https://your-store/index.php?route=extension/wcp_trustpay_gateway/payment/wcp_trustpay_gateway.callback जैसा, और यह आपकी OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। आप इसे Merchant Portal में अपने प्रोजेक्ट्स के notification URL के रूप में भी दर्ज कर सकते हैं। मान्य हस्ताक्षर के बिना आने वाली सूचनाएँ अस्वीकार कर दी जाती हैं। स्टोर maintenance mode में हो तब भी यह URL काम करता है (OpenCart 4 में एक्सटेंशन की एक startup action सूचना और ग्राहक की वापसी को गुज़रने देती है)।

एक्सटेंशन खुद finby से भुगतान की स्थिति नहीं माँगता। यदि कोई सूचना आपके स्टोर तक नहीं पहुँचती, तो finby के उसे भेजने तक ऑर्डर बिना स्थिति के रहता है। finby सूचनाओं को दोबारा भेजता है।

Advanced

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

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

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

Import / Export

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

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

Checkout

Payment Method चरण पर ग्राहक भुगतान तरीका चुनता है (डिफ़ॉल्ट रूप से Card payment (TrustPay))। यह केवल तब दिखाया जाता है जब ग्राहक की मुद्रा समर्थित मुद्राओं में से एक हो: EUR, CZK, HUF, GBP, PLN, NOK, SEK, DKK, BGN, RON, CHF और USD। Confirm Order चरण पर ग्राहक आपका विवरण और यह नोट देखता है: You will be redirected to the secure TrustPay / finby payment page to pay by card. OpenCart इसी चरण पर ऑर्डर बनाता है, अभी भी बिना स्थिति के। OpenCart 4 में ग्राहक Payment method options विंडो में भुगतान तरीके वाले ब्लॉक के Choose बटन से भुगतान तरीका चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है।

जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन finby पर ऑर्डर की मुद्रा में ऑर्डर की कुल राशि के लिए कार्ड भुगतान अनुरोध बनाता है। HUF राशियाँ बिना दशमलव के भेजी जाती हैं। ग्राहक का नाम, पता और ईमेल 3-D Secure के लिए भेजे जाते हैं, और OpenCart ऑर्डर नंबर संदर्भ (reference) के रूप में भेजा जाता है। कार्ड भुगतान के लिए पता ज़रूरी है: यदि street, city, postcode या country में से कुछ नहीं है, तो ग्राहक को Please enter your billing address (street, city, postcode and country) — it is required for card payments. दिखता है। OpenCart 4 डिफ़ॉल्ट रूप से भुगतान पता नहीं माँगता, इसलिए छूटे हुए फ़ील्ड शिपिंग पते से लिए जाते हैं। ग्राहक finby भुगतान पेज पर भेजा जाता है और वहीं कार्ड से भुगतान करता है। पेज स्टोरफ़्रंट की भाषा में खुलता है यदि finby उसे सपोर्ट करता है, अन्यथा अंग्रेज़ी में।

भुगतान के बाद ग्राहक आपके स्टोर पर लौट आता है। ऑर्डर को भुगतान हुआ तभी चिह्नित किया जाता है जब finby उसकी हस्ताक्षरित सूचना से पुष्टि करता है। लौटने की क्रिया स्वयं कभी भुगतान की स्थिति नहीं बदलती। यदि सूचना पहले ही आ चुकी है, तो ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है। यदि नहीं आई, तो एक Payment confirmation पेज कहता है: TrustPay / finby is confirming your card payment. Your order is confirmed as soon as the payment is confirmed, and you will receive an e-mail — there is no need to pay again. इस पेज पर Check again बटन और Back to checkout बटन होते हैं। जब तक ऑर्डर लंबित (awaiting) या रोकी गई (on hold) स्थिति में है, सफलता पेज दिखाता है: Your card payment is being confirmed by TrustPay / finby. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. जब लंबित या रोका गया ऑर्डर बाद में भुगतान होता है, या finby भुगतान अस्वीकार करता है, तो ग्राहक को नई ऑर्डर स्थिति के बारे में ईमेल मिलता है। यदि finby ने भुगतान अस्वीकार किया या बिना भुगतान वाला ऑर्डर रद्द हुआ, तो सफलता पेज दिखाता है: Your card payment was not completed. Please contact us about this order. OpenCart 4 में, जब ग्राहक finby भुगतान पेज से लौटता है, तो एक छोटा मध्यवर्ती पेज आपके स्टोर का वापसी पता फिर से खोलता है, ताकि कार्ट और ग्राहक का लॉगिन बना रहे।

यदि ग्राहक भुगतान पेज पर रद्द करता है, तो वह The card payment was cancelled. You can try again or choose another payment method. संदेश के साथ चेकआउट पर लौट आता है। यदि भुगतान पेज कोई त्रुटि लौटाता है, या finby ने भुगतान पहले ही अस्वीकार कर दिया है, तो संदेश है: The card payment was not completed. Please try again or choose another payment method. कार्ट सुरक्षित रहता है और ग्राहक फिर से भुगतान कर सकता है। OpenCart 4 में ये संदेश चेकआउट पेज के ऊपर दिखते हैं।

OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर एक नया ऑर्डर बनाता है; OpenCart 4 चेकआउट के ऑर्डर को अपडेट करता है। एक कार्ट का भुगतान केवल एक ऑर्डर से होता है: कार्ट के किसी ऑर्डर पर TrustPay स्थिति आते ही कार्ट को दोबारा पुष्ट करने पर दूसरे भुगतान के बजाय सफलता पेज दिखता है। कार्ट में कोई भी बदलाव, जिसमें नई मात्रा भी शामिल है, एक नए कार्ट के रूप में गिना जाता है, जिसे अपने भुगतान की ज़रूरत होती है।

OpenCart 4 में ऑर्डर तब तक चेकआउट में रहता है जब तक सफलता पेज नहीं दिखता। रद्द या विफल भुगतान के बाद ग्राहक नए finby भुगतान अनुरोध से वही ऑर्डर चुकाता है। यदि इस बीच वह ऑर्डर बंद हो गया हो, तो ग्राहक चेकआउट पर लौट जाता है, और अगला Confirm Order एक नया ऑर्डर चुकाता है: अस्वीकृत भुगतान या रद्द किए गए बिना भुगतान वाले ऑर्डर के बाद The card payment was not completed. Please try again or choose another payment method. के साथ; अन्यथा (उदाहरण के लिए जब ऑर्डर आपने रद्द या रिफ़ंड किया हो) Your previous order was cancelled or refunded by the store. Please confirm the order again to pay with a new order. के साथ।

यदि finby भुगतान शुरू नहीं कर पाता, तो ग्राहक Confirm Order चरण पर रहता है और बटन के ऊपर We could not start the card payment. Please try again in a moment or choose another payment method. दिखता है। तकनीकी कारण लॉग में लिखा जाता है।

यह एक्सटेंशन finby पेज पर एक-चरणीय खरीद के रूप में केवल कार्ड भुगतान लेता है। इसमें बैंक ट्रांसफ़र या finby के अन्य भुगतान तरीके नहीं हैं, आपकी साइट पर Apple Pay या Google Pay बटन नहीं हैं, सेव किए गए कार्ड नहीं हैं, सब्सक्रिप्शन या आवर्ती भुगतान नहीं हैं, अलग से authorize और capture नहीं है, और स्थिति की पोलिंग नहीं है।

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

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

कोई स्थिति नहीं (लापता ऑर्डर): ग्राहक को finby पर भेजा गया और उसने भुगतान नहीं किया, या सूचना अभी तक नहीं आई। Sales > Orders में ऐसे ऑर्डर केवल तब दिखते हैं जब Order Status फ़िल्टर को Missing Orders पर सेट किया गया हो। OpenCart 4.1 में ऐसे ऑर्डर की स्थिति Voided भी हो सकती है; यह OpenCart सेट करता है जब confirm चरण दोबारा दिखाया जाता है, और एक्सटेंशन इसे बिना स्थिति वाला ऑर्डर मानता है।

भुगतान के बाद ऑर्डर स्थिति (डिफ़ॉल्ट Processing): finby ने भुगतान की पुष्टि की है, और राशि तथा मुद्रा भुगतान अनुरोध और ऑर्डर की कुल राशि से मेल खाती हैं। एक नोट में राशि, भुगतान अनुरोध और प्रोजेक्ट (टेस्ट या लाइव) दिखता है।

TrustPay भुगतान लंबित (डिफ़ॉल्ट Pending): finby ने नवीनतम भुगतान को लंबित बताया है। finby की पुष्टि पर ऑर्डर भुगतान हुई स्थिति में चला जाता है।

TrustPay भुगतान रोका गया (डिफ़ॉल्ट Pending): दो स्थितियों में सेट होता है। भुगतान केवल authorize हुआ है, capture नहीं: finby Merchant Portal में उसे capture या cancel करें, फिर ऑर्डर अपडेट करें। या भुगतान की गई राशि या मुद्रा, भुगतान अनुरोध या ऑर्डर की कुल राशि से अलग है: शिपिंग से पहले भुगतान जाँचें। नोट मामला समझाता है। पैसा प्राप्त हो चुका है, इसलिए रिफ़ंड उपलब्ध है।

भुगतान त्रुटि (डिफ़ॉल्ट Failed): finby ने प्रतीक्षारत ऑर्डर के नवीनतम भुगतान को अस्वीकार कर दिया। जब finby कारण भेजता है, तो नोट उसे दिखाता है। बाद में पुष्ट हुआ भुगतान फिर भी ऑर्डर को भुगतान हुई स्थिति में ले जाता है।

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

रद्द (cancelled) या रिफ़ंड किए गए ऑर्डर देर से आए भुगतान से कभी फिर नहीं खुलते। एक नोट आपसे कहता है कि ऑर्डर बहाल करें या Merchant Portal में भुगतान रिफ़ंड करें। यदि जो ऑर्डर पहले से भुगतान हुआ है उसके लिए दूसरा भुगतान आता है, या ऐसे कार्ट के किसी दूसरे ऑर्डर के लिए जिसका ऑर्डर पहले से भुगतान हुआ है, तो ऑर्डर नहीं बदला जाता और एक नोट आपसे कहता है कि Merchant Portal में डुप्लिकेट रिफ़ंड करें। finby द्वारा बताए गए chargebacks और विवाद नोट्स के रूप में जोड़े जाते हैं।

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

VibeFox TrustPay Gateway tab

Sales > Orders में TrustPay से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox TrustPay Gateway टैब Payment request ID, Payment ID, टेस्ट भुगतानों के लिए Test project बैज वाला Project, Status, Requested / paid और Paid / refunded राशियाँ, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास, Payment requests of this order और TrustPay notes दिखाता है। यह टैब उन उपयोगकर्ताओं को दिखता है जिनकी एक्सटेंशन तक पहुँच है।

रिफ़ंड

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

रिफ़ंड उस प्रोजेक्ट (टेस्ट या लाइव) पर जाता है जिससे ऑर्डर का भुगतान हुआ था, भले ही उसके बाद आपने मोड बदल दिया हो। उस प्रोजेक्ट का Project ID और Secret key सेट होना चाहिए, और उसका Project ID बदला नहीं होना चाहिए। रिफ़ंड तभी दर्ज होता है जब finby उसे स्वीकार करता है। अन्यथा टैब कारण के साथ TrustPay refused the refund: दिखाता है, और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड रिफ़ंड इतिहास और नोट्स में जुड़ जाता है। पूर्ण रिफ़ंड ऑर्डर को ग्राहक को सूचित किए बिना और उत्पादों को स्टॉक में वापस किए बिना Refunded order status पर सेट करता है, जैसे मैनुअल स्थिति परिवर्तन। आंशिक रिफ़ंड स्थिति नहीं बदलता।

Sales > Returns में उत्पाद वापसी finby के ज़रिए पैसे नहीं लौटाती। finby Merchant Portal में किए गए रिफ़ंड रिफ़ंड के रूप में दर्ज नहीं होते। यदि finby उनके बारे में सूचना भेजता है, तो वह एक नोट के रूप में जुड़ जाती है और ऑर्डर की स्थिति नहीं बदलती।

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

यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox TrustPay Gateway, Extensions > Extensions > Payments > VibeFox TrustPay Gateway > Edit पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी License key में डालें और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को मास्क करके, स्थिति (जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन) और बटन दिखाता है: स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी डालने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। उनके नीचे Product: opencart-payment-trustpay की पंक्ति और Manage licenses and domains in your account लिंक है, जो आपका vibefox.net खाता खोलता है। कुंजी केवल वे एडमिन उपयोगकर्ता बदल सकते हैं जिनके पास इस एक्सटेंशन के लिए Modify अधिकार है। ब्लॉक के टेक्स्ट एडमिन की भाषा का पालन करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

यदि कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, जैसे Key not found, This key belongs to another product, Domain limit reached या तारीख के साथ License expired on। स्टोर का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक नहीं पहुँचा जा सकता, तो एक्सटेंशन अंतिम ज्ञात स्थिति पर काम करता रहता है।

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

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

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

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

Card payment (TrustPay) चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable / Disable चालू है, और वर्तमान मोड में उसका Project ID और Secret key है: टेस्ट मोड में Test Project ID और Test Secret key, लाइव मोड में Live Project ID और Live Secret key। ग्राहक की मुद्रा समर्थित मुद्राओं में से एक होनी चाहिए। जब क्रेडेंशियल गायब हों या डिफ़ॉल्ट मुद्रा समर्थित न हो, तो सेटिंग्स पेज चेतावनी दिखाता है। यह भी जाँचें कि भुगतान का पता चुने गए Geo zone में है और ऑर्डर Minimum total तक पहुँचता है।

भुगतान हो गया, पर ऑर्डर बिना स्थिति के रहा: सूचना आपके स्टोर तक नहीं पहुँची। जाँचें कि Notification URL के नीचे दिखाया गया URL इंटरनेट से पहुँच योग्य है (कोई फ़ायरवॉल, maintenance लॉगिन या HTTP authentication नहीं)। finby सूचना को दोबारा भेजता है, और सूचना पहुँचने पर ऑर्डर को स्थिति मिल जाती है। त्रुटियाँ हमेशा लॉग में लिखी जाती हैं; एक्सटेंशन पेज पर Log फ़ील्ड देखें।

लॉग में Notification rejected: invalid signature or unknown project दिखता है: सूचना ऐसे प्रोजेक्ट से आई जिसका Project ID सेटिंग्स में नहीं है, या उस प्रोजेक्ट की Secret key गलत है। स्टोर Invalid signature का जवाब देता है और कुछ नहीं बदलता। जिस मोड में भुगतान हुआ था, उसका Project ID और Secret key जाँचें।

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

सूचना को Busy, retry later या Temporary error का जवाब मिलता है: उसी समय कार्ट किसी दूसरी सूचना से अपडेट हो रहा था, या ऑर्डर की स्थिति सेट नहीं हो सकी। finby उसे दोबारा भेजेगा। लॉग में कारण दिखता है।

ग्राहक को We could not start the card payment दिखता है: लॉग खोलें। गलत Project ID या Secret key से यह संदेश आता है कि finby ने प्रोजेक्ट के क्रेडेंशियल अस्वीकार किए। जाँचें कि टेस्ट क्रेडेंशियल टेस्ट फ़ील्ड में और लाइव क्रेडेंशियल लाइव फ़ील्ड में हैं।

Card payment is temporarily unavailable: यह ग्राहक को तब दिखता है जब वर्तमान मोड में Project ID या Secret key नहीं है। उन्हें दर्ज करें और सेव करें।

ऑर्डर रोकी गई (on hold) स्थिति में है: VibeFox TrustPay Gateway टैब के नोट्स पढ़ें (देखें ऑर्डर स्थितियाँ)। शिपिंग से पहले Merchant Portal में भुगतान जाँचें, फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

रिफ़ंड प्रोजेक्ट से जुड़े संदेश के साथ विफल होता है: ऑर्डर टेस्ट या लाइव प्रोजेक्ट से भुगतान हुआ था, और उस मोड का Project ID या Secret key सेट नहीं है, या वहाँ अब कोई और Project ID सेव है। उस प्रोजेक्ट के क्रेडेंशियल दर्ज करें, या finby Merchant Portal में भुगतान रिफ़ंड करें।

Invalid refund amount: at most … can be refunded: राशि भुगतान की गई राशि से उन रिफ़ंड को घटाकर जो एक्सटेंशन से पहले ही हो चुके हैं, उससे ज़्यादा है।

अनइंस्टॉल

Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox TrustPay Gateway के आगे Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती हैं। OpenCart हमेशा एक्सटेंशन की अपनी सेटिंग्स हटा देता है: Enable / Disable, Sort order, Geo zone, Minimum total और ऑर्डर स्थितियाँ, जो दोबारा इंस्टॉल करने पर डिफ़ॉल्ट पर लौट आती हैं। एक्सटेंशन का OpenCart event और कैश्ड API access tokens भी हटा दिए जाते हैं (OpenCart 4 में उसके events और startup action भी, जो maintenance mode में सूचना और ग्राहक की वापसी को गुज़रने देता है)। यदि Delete data on uninstall चालू है, तो बाकी सेटिंग्स (title, description, test mode, Project ID, Secret key, logging) और लॉग हट जाते हैं। यदि बंद है, तो वे बाद में दोबारा इंस्टॉल करने के लिए रखे जाते हैं। TrustPay भुगतान रिकॉर्ड और रिफ़ंड हमेशा रखे जाते हैं, इसलिए पहले भुगतान किए गए ऑर्डर दोबारा इंस्टॉल करने के बाद भी रिफ़ंड किए जा सकते हैं। मौजूदा ऑर्डर अपने भुगतान नोट्स रखते हैं।

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

TrustPay और finby अपने-अपने मालिकों के ट्रेडमार्क हैं। यह एक्सटेंशन TrustPay या finby से संबद्ध नहीं है और उनके द्वारा समर्थित भी नहीं है।