VibeFox Pin Payments for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

HTTPS: कार्ड भुगतान स्वीकार करने के लिए आवश्यक होने के कारण (PCI DSS), आपके चेकआउट पर HTTPS होना चाहिए। कार्ड की जानकारी ग्राहक के ब्राउज़र से Pin.js द्वारा सीधे Pin Payments को भेजी जाती है और कभी आपके सर्वर तक नहीं पहुँचती, इसलिए स्टोर PCI SAQ A-EP के दायरे में आता है।

Pin Payments खाता: एक Pin Payments मर्चेंट खाता (ऑस्ट्रेलिया या न्यूज़ीलैंड के व्यवसायों के लिए; ग्राहक कहीं से भी भुगतान कर सकते हैं)। आपको इसकी publishable कुंजी और secret कुंजी चाहिए, लाइव के लिए, और परीक्षण के लिए टेस्ट एनवायरनमेंट की कुंजियाँ। वेबहुक सीक्रेट की ज़रूरत नहीं है: प्लगइन वेबहुक का उपयोग नहीं करता।

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

इंस्टॉलेशन

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

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

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

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

5. Pin Payments डैशबोर्ड में Account > API Keys खोलें और अपनी टेस्ट कुंजियाँ Test publishable key और Test secret key में कॉपी करें। Test mode चालू रखें, Enable/Disable चालू करें और सेव करें।

6. Pin Payments के टेस्ट कार्ड से एक टेस्ट ऑर्डर दें। जब सब कुछ काम करने लगे, तो लाइव कुंजियाँ डालें, Test mode बंद करें और सेव करें।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Pin Payments। फ़ील्ड्स के ऊपर यह पेज तब एक सूचना दिखाता है जब टेस्ट मोड चालू हो, तब एक त्रुटि दिखाता है जब मौजूदा मोड की publishable या secret कुंजी खाली हो, और तब एक त्रुटि दिखाता है जब Pin Payments स्टोर की मुद्रा का समर्थन न करे (समर्थित मुद्राओं की सूची के साथ)। आखिरी दो स्थितियों में चेकआउट पर गेटवे छिपा दिया जाता है। सेव करने के बाद सूचनाएँ तुरंत नया मोड और नई कुंजियाँ दिखाती हैं। भुगतान विधियों की सूची में गेटवे को तब तक सेटअप की ज़रूरत वाला चिह्नित किया जाता है जब तक मौजूदा मोड में दोनों कुंजियाँ न हों।

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

Title: चेकआउट पर दिखाया जाने वाला भुगतान विधि का शीर्षक। डिफ़ॉल्ट: Credit card (Pin Payments)।

Description: चेकआउट पर दिखाया जाने वाला भुगतान विधि का विवरण। डिफ़ॉल्ट: Pay with your credit card via Pin Payments।

API कुंजियाँ

अपनी कुंजियाँ Pin Payments डैशबोर्ड में Account > API Keys के अंतर्गत मिलेंगी। टेस्ट कुंजियाँ केवल टेस्ट API के साथ और लाइव कुंजियाँ केवल लाइव API के साथ काम करती हैं। publishable कुंजी ग्राहक के ब्राउज़र में Pin.js द्वारा उपयोग होती है। secret कुंजी कभी आपका सर्वर नहीं छोड़ती।

Test mode: Enable test mode। यह Pin Payments के टेस्ट एनवायरनमेंट (test-api.pinpayments.com) और टेस्ट कुंजियों का उपयोग करता है। कोई वास्तविक चार्ज नहीं होता, और ग्राहकों को कार्ड फ़ॉर्म में टेस्ट मोड — कोई वास्तविक चार्ज नहीं किया जाएगा। दिखता है। बंद होने पर लाइव API (api.pinpayments.com) और लाइव कुंजियाँ उपयोग होती हैं। डिफ़ॉल्ट: चालू।

Test publishable key: आपके Pin Payments टेस्ट खाते की publishable कुंजी।

Test secret key: आपके Pin Payments टेस्ट खाते की secret कुंजी। यह एक पासवर्ड फ़ील्ड है।

Live publishable key: आपके Pin Payments लाइव खाते की publishable कुंजी।

Live secret key: आपके Pin Payments लाइव खाते की secret कुंजी। यह एक पासवर्ड फ़ील्ड है।

कुंजियों के आसपास के स्पेस हटा दिए जाते हैं। मौजूदा मोड की दोनों कुंजियाँ भरी होनी चाहिए, अन्यथा चेकआउट पर गेटवे नहीं दिखेगा।

एडवांस्ड

Debug log: Log Pin Payments API calls — लॉग WooCommerce > Status > Logs में, स्रोत wcp_pinpayments_gateway के तहत सहेजे जाते हैं। त्रुटियाँ हमेशा लॉग होती हैं; हर API कॉल भी लॉग करने के लिए इसे चालू करें। कार्ड डेटा, API कुंजियाँ और ग्राहकों का व्यक्तिगत डेटा कभी लॉग नहीं होते। डिफ़ॉल्ट: बंद।

Delete data on uninstall: Delete the gateway settings and logs when the plugin is deleted। प्लगइन को निष्क्रिय करने से कुछ भी नहीं हटता। ऑर्डर पर सहेजा गया भुगतान डेटा हमेशा रहता है। डिफ़ॉल्ट: बंद।

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit card (Pin Payments), Visa, Mastercard और American Express के आइकन के साथ) और आपके चेकआउट पर Card number, Expiry (MM / YY), CVC और Name on card भरता है। भेजने से पहले, कार्ड फ़ॉर्म कार्ड नंबर की लंबाई, समाप्ति का महीना और वर्ष, 3 या 4 अंकों का CVC और नाम जाँचता है।

ऑर्डर देने पर, Pin.js ब्राउज़र से कार्ड की जानकारी और बिलिंग पता सीधे Pin Payments को भेजता है और एक बार उपयोग होने वाला कार्ड टोकन प्राप्त करता है। केवल यह टोकन आपके सर्वर को भेजा जाता है। फिर आपका सर्वर ऑर्डर की मुद्रा में, ऑर्डर कुल के लिए, <store name> - Order <number> विवरण के साथ एक कैप्चर्ड चार्ज बनाता है। Pin Payments उसी अनुरोध में उत्तर देता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Pin Payments सफल चार्ज की सूचना दे, और केवल ऑर्डर की राशि और मुद्रा के बिल्कुल मेल खाने पर। इसके बाद ग्राहक ऑर्डर प्राप्ति पेज पर पहुँचता है।

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

ग्राहक को दिखाई दे सकने वाले संदेश: आपका कार्ड अस्वीकार कर दिया गया। कृपया कोई दूसरा कार्ड इस्तेमाल करें या अपने बैंक से संपर्क करें।; आपके कार्ड में पर्याप्त राशि नहीं है। कृपया कोई दूसरा कार्ड इस्तेमाल करें।; आपके कार्ड की समाप्ति तिथि निकल चुकी है। कृपया कोई दूसरा कार्ड इस्तेमाल करें।; कार्ड सुरक्षा कोड (CVC) गलत है।; इस प्रकार का कार्ड स्वीकार नहीं किया जाता। कृपया Visa, Mastercard या American Express इस्तेमाल करें।; भुगतान विफल: अस्वीकृत विवरण के लिए Pin Payments के कारण के साथ; आपके कार्ड की जानकारी की समय-सीमा समाप्त हो गई है। कृपया इसे फिर से दर्ज करें और दोबारा प्रयास करें। जब टोकन इस्तेमाल नहीं हो सकता; सुरक्षित कार्ड फ़ॉर्म लोड नहीं हो सका। कृपया पेज रीलोड करें या कोई दूसरी भुगतान विधि चुनें। जब Pin.js लोड न हो; कार्ड भुगतान अभी उपलब्ध नहीं हैं। कृपया बाद में फिर प्रयास करें या कोई दूसरी भुगतान विधि चुनें। जब Pin Payments secret कुंजी अस्वीकार करे; हम Pin Payments के साथ आपके भुगतान की पुष्टि नहीं कर सके। दोबारा प्रयास करने से पहले कृपया अपना ई-मेल और कार्ड स्टेटमेंट देखें, या हमसे संपर्क करें। जब Pin Payments उत्तर न दे। तकनीकी विवरण ऑर्डर नोट्स और लॉग में जाते हैं।

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

प्लगइन में 3-D Secure फ़्लो नहीं है। यदि आपका Pin Payments खाता 3-D Secure माँगता है, तो चार्ज पेंडिंग रहता है और प्लगइन ऑर्डर को विफल कर देता है, इसलिए उस प्रयास से कोई पैसा नहीं लिया जाता; ग्राहक को आपके कार्ड से भुगतान पूरा नहीं हो सका (अतिरिक्त सत्यापन आवश्यक है)। कृपया कोई दूसरा कार्ड या दूसरी भुगतान विधि आज़माएँ। दिखता है। बाद में कैप्चर वाला केवल-authorize मोड, सेव किए गए कार्ड, WooCommerce Subscriptions, Apple Pay या Google Pay, और वेबहुक उपलब्ध नहीं हैं।

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

Order statuses

Processing: Pin Payments ने ऑर्डर की राशि और मुद्रा से बिल्कुल मेल खाते सफल, कैप्चर्ड चार्ज की सूचना दी। केवल वर्चुअल, डाउनलोड योग्य उत्पादों वाले ऑर्डर WooCommerce के डिफ़ॉल्ट के अनुसार पूर्ण हो जाते हैं। ऑर्डर नोट में राशि और चार्ज टोकन दिखता है (टेस्ट भुगतानों के लिए TEST MODE भी)। ट्रांज़ैक्शन ID Pin Payments का चार्ज टोकन है।

Failed: कार्ड अस्वीकृत हुआ, चार्ज पेंडिंग रहा (3-D Secure), या Pin Payments ने secret कुंजी या अनुरोध अस्वीकार किया। हर विफल प्रयास ऑर्डर में Pin Payments की त्रुटि कोड और संदेश के साथ एक नोट जोड़ता है, यहाँ तक कि जब ऑर्डर पिछले प्रयास से पहले ही Failed हो चुका हो। ग्राहक उसी ऑर्डर के साथ फिर से प्रयास कर सकता है।

Pending payment: Pin Payments ने कोई स्पष्ट उत्तर नहीं दिया (टाइमआउट, सर्वर त्रुटि, न पढ़ा जा सकने वाला उत्तर)। ऑर्डर विफल चिह्नित नहीं होता, क्योंकि चार्ज फिर भी बन चुका हो सकता है। नोट आपको ग्राहक के दोबारा भुगतान करने या ऑर्डर भेजे जाने से पहले Pin Payments डैशबोर्ड में चार्ज का विवरण खोजने के लिए कहता है। यह स्थिति भुगतान लंबित है।

On hold: Pin Payments ने ऑर्डर से अलग राशि या मुद्रा चार्ज की (नोट में अपेक्षित और चार्ज की गई राशि दिखती है), या चार्ज को अधिकृत किया गया लेकिन कैप्चर नहीं किया गया। ऑर्डर पूरा करने से पहले Pin Payments डैशबोर्ड में चार्ज की जाँच करें।

रिफ़ंड

ऑर्डर खोलें, Refund पर क्लिक करें, राशि दर्ज करें और Refund via Credit card (Pin Payments) पर क्लिक करें (बटन पर आपका Title दिखता है)। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। रिफ़ंड उस एनवायरनमेंट (टेस्ट या लाइव) को भेजा जाता है जिसमें ऑर्डर का भुगतान हुआ था, इसलिए उस मोड की secret कुंजी भरी होनी चाहिए। सफल अनुरोध ऑर्डर में राशि, Pin Payments रिफ़ंड टोकन और उसकी स्थिति के साथ एक नोट जोड़ता है। Pin Payments रिफ़ंड को अतुल्यकालिक (asynchronously) प्रोसेस करता है, इसलिए स्थिति आमतौर पर Pending होती है। यदि Pin Payments रिफ़ंड अस्वीकार करता है या उत्तर नहीं देता, तो WooCommerce त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता।

Pin Payments डैशबोर्ड में किए गए रिफ़ंड WooCommerce से सिंक नहीं होते, इसलिए रिफ़ंड WooCommerce से ही करें।

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

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

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

सक्रिय कुंजी के बिना Pin Payments चेकआउट पर ग्राहकों को नहीं दिखता। फिर भी यदि भुगतान शुरू हो जाए, तो ग्राहक को यह भुगतान विधि उपलब्ध नहीं है। कृपया कोई दूसरी चुनें। दिखता है। लॉग-इन स्टोर मैनेजरों को भुगतान विधि (लाइसेंस नहीं — केवल एडमिन को दिखाई देता है) चिह्न के साथ दिखती रहती है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट अप और टेस्ट कर सकें। Plugins पेज और WooCommerce पेजों पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: रिफ़ंड चलते रहते हैं।

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

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

चेकआउट पर Pin Payments दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, मौजूदा मोड की दोनों कुंजियाँ भरी हैं (टेस्ट मोड में Test publishable key और Test secret key, अन्यथा लाइव कुंजियाँ), और कार्ट की मुद्रा 14 समर्थित मुद्राओं में से एक है। Pay for order पेज पर ऑर्डर की मुद्रा मायने रखती है। सेटिंग्स पेज कुंजियाँ गायब होने और असमर्थित मुद्रा के लिए त्रुटि दिखाता है।

चेकआउट पर लिखा आता है "हम Pin Payments के साथ आपके भुगतान की पुष्टि नहीं कर सके": Pin Payments ने समय पर उत्तर नहीं दिया। ऑर्डर नोट के साथ पेंडिंग भुगतान पर रहता है। ग्राहक के दोबारा भुगतान करने या ऑर्डर भेजे जाने से पहले Pin Payments डैशबोर्ड में <store name> - Order <number> विवरण वाला चार्ज खोजें। प्लगइन ऐसा चार्ज अपने-आप नहीं खोजता, और नया प्रयास नया चार्ज बनाता है।

ग्राहक "कार्ड भुगतान अभी उपलब्ध नहीं हैं" देखते हैं: Pin Payments ने secret कुंजी अस्वीकार की। ऑर्डर नोट कहता है कि मौजूदा मोड की कुंजियाँ जाँचें। टेस्ट कुंजियाँ केवल टेस्ट मोड में, और लाइव कुंजियाँ केवल लाइव मोड में काम करती हैं।

ऑर्डर "अतिरिक्त सत्यापन आवश्यक है" के साथ विफल होते हैं: आपके Pin Payments खाते में 3-D Secure आवश्यक है, जिसे प्लगइन समर्थित नहीं करता। Pin Payments से अनिवार्य 3-D Secure बंद करने को कहें।

कोई ऑर्डर "does not match" नोट के साथ On hold है: Pin Payments ने ऑर्डर से अलग चार्ज राशि या मुद्रा की सूचना दी। Pin Payments डैशबोर्ड में चार्ज जाँचें और ऑर्डर मैन्युअली रिफ़ंड करें या पूरा करें।

सुरक्षित कार्ड फ़ॉर्म लोड नहीं हो सका: Pin Payments CDN से Pin.js ब्राउज़र में लोड नहीं हुआ, उदाहरण के लिए स्क्रिप्ट ब्लॉकर या किसी कैशिंग या ऑप्टिमाइज़ेशन प्लगइन के कारण जो स्क्रिप्ट्स बदलता है। चेकआउट को ऐसे ऑप्टिमाइज़ेशन से बाहर रखें।

रिफ़ंड विफल: संदेश पढ़ें। TEST या LIVE मोड से संबंधित संदेश का अर्थ है कि जिस मोड में ऑर्डर का भुगतान हुआ था, उसकी secret कुंजी खाली है। Pin Payments ने रिफ़ंड की पुष्टि नहीं की का अर्थ है कि कोई उत्तर नहीं आया; दोबारा प्रयास करने से पहले Pin Payments डैशबोर्ड में चार्ज जाँचें।

Pin Payments के कारण से भुगतान विफल: Pin Payments ने चार्ज का विवरण अस्वीकार किया, उदाहरण के लिए मुद्रा के लिए न्यूनतम चार्ज से कम राशि। ग्राहक को कारण दिखता है, और ऑर्डर नोट में त्रुटि कोड होता है।

टेस्ट भुगतान: टेस्ट मोड टेस्ट एनवायरनमेंट और टेस्ट कुंजियों का उपयोग करता है। Pin Payments की डेवलपर डॉक्यूमेंटेशन के टेस्ट कार्ड इस्तेमाल करें, उदाहरण के लिए 4200 0000 0000 0000 (सफल) या 4100 0000 0000 0001 (अस्वीकृत), किसी भी भविष्य की समाप्ति तिथि और किसी भी CVC के साथ। ऑर्डर अपना भुगतान मोड बनाए रखते हैं, इसलिए मोड बदलने के बाद भी रिफ़ंड सही एनवायरनमेंट में जाते हैं।

त्रुटियाँ कहाँ मिलेंगी: त्रुटियाँ हमेशा WooCommerce > Status > Logs में, स्रोत wcp_pinpayments_gateway के तहत लिखी जाती हैं। हर API कॉल देखने के लिए Debug log चालू करें।

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

डेवलपर्स के लिए: फ़िल्टर wc_ppg_supported_currencies मुद्रा सूची बदलता है, और wc_ppg_icon WooCommerce की भुगतान विधि सूची में आइकन बदलता है।

अनइंस्टॉल

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

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