VibeFox TrustPay for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

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

पहुँच योग्य सूचना URL: finby को इंटरनेट से आपकी साइट तक पहुँच मिलनी चाहिए। फ़ायरवॉल, मेंटेनेंस मोड या साइट की पासवर्ड सुरक्षा भुगतान सूचनाओं को रोक देती है।

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

इंस्टॉलेशन

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

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

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

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

5. अपने लाइव प्रोजेक्ट का Project ID और Secret key डालें, और परीक्षण के लिए अपने टेस्ट प्रोजेक्ट के (देखें कॉन्फ़िगरेशन)।

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

संस्करण 1.0 से अपडेट करने पर आपका Project ID और Secret key लाइव क्रेडेंशियल के रूप में बने रहते हैं और टेस्ट मोड बंद हो जाता है। अपडेट के बाद सेटिंग्स की जाँच करें।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > TrustPay / finby। फ़ील्ड्स के ऊपर पेज चेतावनी देता है जब गेटवे चालू हो पर वर्तमान मोड का Project ID या Secret key खाली हो, और जब स्टोर की मुद्रा समर्थित न हो। दोनों स्थितियों में चेकआउट पर भुगतान विधि छिप जाती है। भुगतान विधियों की सूची में, जब तक वर्तमान मोड में Project ID और Secret key न हों, गेटवे को सेटअप की ज़रूरत वाला दिखाया जाता है।

General

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

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

Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला टेक्स्ट। डिफ़ॉल्ट: Pay securely by card on the TrustPay / finby payment page.

API credentials

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

Test mode: Use the test project (no real payments)। नए भुगतान और रिफ़ंड टेस्ट क्रेडेंशियल का उपयोग करते हैं। किसी ऑर्डर के रिफ़ंड हमेशा उसी प्रोजेक्ट पर जाते हैं जिससे ऑर्डर का भुगतान हुआ था। डिफ़ॉल्ट: चालू।

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

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

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

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

Project ID में केवल अंक होने चाहिए। अगर आप कोई दूसरा मान सेव करते हैं, तो पेज एक त्रुटि दिखाता है और पिछला मान बना रहता है। Secret key वैसे ही सेव होते हैं जैसे आपने डाले हैं; केवल शुरू और आखिर के खाली स्थान हटाए जाते हैं।

Payment notifications

ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब finby हस्ताक्षरित सूचना से भुगतान की पुष्टि करे। प्लगइन हर भुगतान के साथ सूचना URL अपने-आप भेजता है, इसलिए आपको इसे अलग से सेट करने की ज़रूरत नहीं है। यह सेक्शन URL दिखाता है, जैसे https://your-site/wc-api/trustpay_payment_callback/। आप इसे Merchant Portal में अपने प्रोजेक्ट्स के सूचना URL के रूप में भी डाल सकते हैं। वैध हस्ताक्षर के बिना आई सूचनाएँ अस्वीकार कर दी जाती हैं।

प्लगइन खुद finby से भुगतान की स्थिति नहीं पूछता। अगर कोई सूचना आपकी साइट तक नहीं पहुँचती, तो finby उसे भेजने तक ऑर्डर Pending payment पर ही रहता है।

Advanced

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

Debug logging: Log API requests and notifications लॉग में विवरण जोड़ता है। एरर हमेशा लॉग होते हैं, भले ही यह विकल्प बंद हो। लॉग WooCommerce > Status > Logs में, स्रोत wcp_trustpay_gateway, मिलते हैं और उनमें कोई कुंजी, टोकन, कार्ड डेटा या ग्राहक का विवरण नहीं होता। डिफ़ॉल्ट: बंद।

Delete data on uninstall: Remove the plugin settings and logs when the plugin is deleted (order data is kept)। डिफ़ॉल्ट: बंद।

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Card payment (TrustPay)) और ऑर्डर देता है। टेस्ट मोड में चेकआउट पर विवरण के नीचे Test mode: no real payment will be taken. दिखता है।

कार्ड भुगतान के लिए बिलिंग पता चाहिए। अगर स्ट्रीट, शहर, पिन कोड या देश में से कुछ भी नहीं है, तो ग्राहक को Please enter your billing address (street, city, postcode and country) — it is required for card payments. दिखता है।

प्लगइन ऑर्डर की राशि के लिए ऑर्डर की मुद्रा में finby पर एक कार्ड भुगतान अनुरोध बनाता है। ग्राहक का नाम, पता और ईमेल 3-D Secure के लिए भेजे जाते हैं, और ऑर्डर ID संदर्भ के रूप में भेजा जाता है। ग्राहक finby के भुगतान पेज पर भेजा जाता है और वहाँ कार्ड से भुगतान करता है। finby द्वारा समर्थित होने पर पेज आपके स्टोर की भाषा में खुलता है, अन्यथा अंग्रेज़ी में। ऑर्डर पर एक नोट भुगतान अनुरोध, राशि और प्रोजेक्ट (टेस्ट या लाइव) दिखाता है।

भुगतान के बाद ग्राहक आपके स्टोर के ऑर्डर प्राप्ति पेज पर लौटता है और कार्ट खाली हो जाती है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब finby हस्ताक्षरित सूचना से पुष्टि करे। लौटना अपने-आप भुगतान की स्थिति कभी नहीं बदलता।

अगर ग्राहक भुगतान पेज पर रद्द करता है, या भुगतान पेज कोई त्रुटि लौटाता है, तो ग्राहक Pay for order पेज पर इस संदेश के साथ लौटता है: The card payment was cancelled. You can try again or choose another payment method. या The card payment was not completed. Please try again or choose another payment method. ऑर्डर में एक नोट जुड़ जाता है। ग्राहक उसी पेज से फिर से भुगतान कर सकता है।

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

मुद्राएँ: EUR, CZK, HUF, GBP, PLN, NOK, SEK, DKK, BGN, RON, CHF और USD। HUF राशियाँ बिना दशमलव के भेजी जाती हैं। Pay for order पेज पर ऑर्डर की मुद्रा जाँची जाती है।

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

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

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

ऑर्डर स्टेटस

Pending payment: ग्राहक को finby पर भेजा गया है और उसने अभी भुगतान नहीं किया है, या सूचना अभी नहीं आई है।

Processing or Completed: finby ने भुगतान की पुष्टि की है, और राशि व मुद्रा भुगतान अनुरोध और ऑर्डर के कुल योग से मेल खाती हैं। स्टेटस Order status after payment के अनुसार होता है। ऑर्डर नोट में राशि, भुगतान अनुरोध और प्रोजेक्ट दिखते हैं। ट्रांज़ैक्शन ID finby का भुगतान अनुरोध ID है।

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

Failed: finby ने ऑर्डर का आखिरी भुगतान अस्वीकार कर दिया है। finby कारण भेजे तो नोट में कारण दिखता है। ग्राहक Pay for order से फिर भुगतान कर सकता है।

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

Refunds

ऑर्डर खोलें, Refund पर क्लिक करें, राशि डालें और Refund via Card payment (TrustPay) पर क्लिक करें (बटन पर आपका Title दिखता है)। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। रिफ़ंड उसी प्रोजेक्ट (टेस्ट या लाइव) पर जाता है जिससे ऑर्डर का भुगतान हुआ था, भले ही उसके बाद आपने मोड बदल दिया हो। इसलिए उस मोड का Project ID और Secret key सेट होना चाहिए। HUF रिफ़ंड पूरी राशि के होने चाहिए।

रिफ़ंड तभी दर्ज होता है जब finby उसे स्वीकार करे। अन्यथा WooCommerce कारण के साथ TrustPay refused the refund: दिखाता है, और कोई रिफ़ंड नहीं बनता। सफल रिफ़ंड ऑर्डर नोट्स में जुड़ जाता है।

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

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

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

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

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

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

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

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

भुगतान हो गया, पर ऑर्डर Pending payment पर है: सूचना आपके स्टोर तक नहीं पहुँची। जाँचें कि https://your-site/wc-api/trustpay_payment_callback/ इंटरनेट से पहुँच योग्य है (कोई फ़ायरवॉल, मेंटेनेंस मोड या पासवर्ड सुरक्षा नहीं)। finby सूचना दोबारा भेजता है। WooCommerce > Status > Logs देखें, स्रोत wcp_trustpay_gateway।

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

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

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

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

कार्ड भुगतान अस्थायी रूप से उपलब्ध नहीं है: ग्राहक को यह संदेश तब दिखता है जब वर्तमान मोड में Project ID या Secret key नहीं है। उन्हें डालें और सेव करें।

ऑर्डर On hold है, राशि/मुद्रा के बेमेल के नोट के साथ: सूचना असली थी, पर भुगतान की गई राशि या मुद्रा भुगतान अनुरोध या ऑर्डर के कुल योग से अलग है। शिपिंग से पहले Merchant Portal में भुगतान जाँचें, फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

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

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

अनइंस्टॉल

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

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