VibeFox Paystack for WooCommerce — सहायता

आवश्यकताएँ

WordPress: 5.8 या बाद का।

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

PHP: 8.0 या बाद का।

मुद्रा: ऑर्डर उस मुद्रा में होना चाहिए जिसे Paystack स्वीकार करता है: NGN, USD, GHS, ZAR, KES, XOF, EGP या RWF, जैसा आपके Paystack खाते में सक्षम है। अन्य मुद्राओं में भुगतान विधि छिप जाती है। XOF और RWF में Paystack केवल पूर्ण राशियाँ स्वीकार करता है।

Paystack खाता: आपको अपने Paystack खाते की सीक्रेट कुंजियाँ चाहिए: टेस्ट सीक्रेट कुंजी (sk_test_...) और/या लाइव सीक्रेट कुंजी (sk_live_...)। पब्लिक कुंजियाँ (pk_...) ज़रूरी नहीं हैं, क्योंकि भुगतान Paystack के होस्टेड पेज पर होता है। Paystack डैशबोर्ड में आप अपने स्टोर का वेबहुक URL भी सेट करते हैं (कॉन्फ़िगरेशन देखें)। वेबहुक प्राप्त करने के लिए आपकी साइट इंटरनेट से पहुँच योग्य होनी चाहिए।

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

इंस्टॉलेशन

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

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

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

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

5. Paystack डैशबोर्ड से अपनी सीक्रेट कुंजियाँ चिपकाएँ और Paystack डैशबोर्ड में वेबहुक URL सेट करें (कॉन्फ़िगरेशन देखें)।

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

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

सभी सेटिंग एक ही पेज पर हैं: WooCommerce > Settings > Payments > Paystack। फ़ील्ड के ऊपर एक स्टेटस बॉक्स मोड दिखाता है: टेस्ट मोड: कोई असली पैसा नहीं काटा जाता। या लाइव मोड: असली भुगतान स्वीकार किए जाते हैं। यह तब भी चेतावनी देता है जब वर्तमान मोड की सीक्रेट कुंजी खाली हो, जब सीक्रेट कुंजी फ़ील्ड में पब्लिक कुंजी (pk_...) डाली गई हो, जब लाइव मोड में टेस्ट कुंजी (sk_test_...) हो या टेस्ट मोड में लाइव कुंजी (sk_live_...) हो, और जब Paystack आपकी स्टोर मुद्रा स्वीकार न करे। कुंजी की किसी समस्या के रहते चेकआउट पर भुगतान विधि छिपी रहती है। भुगतान विधियों की सूची में, जब तक वर्तमान मोड में सीक्रेट कुंजी न हो, तब तक Paystack को सेटअप की ज़रूरत वाला चिह्नित किया जाता है।

चेकआउट

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

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

Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely using your debit card, credit card, or bank account via Paystack।

API कुंजियाँ

Paystack डैशबोर्ड के पेज Settings > API Keys & Webhooks से सीक्रेट कुंजियाँ कॉपी करें। यह सेक्शन उस पेज का लिंक देता है।

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

Test Secret Key: आपकी Paystack टेस्ट सीक्रेट कुंजी। यह sk_test_ से शुरू होती है।

Live Secret Key: आपकी Paystack लाइव सीक्रेट कुंजी। यह sk_live_ से शुरू होती है।

वेबहुक

वेबहुक आपके स्टोर को बताता है कि भुगतान हो गया है, भले ही ग्राहक स्टोर पर वापस न आए। Paystack डैशबोर्ड में, Settings > API Keys & Webhooks पेज पर, इस सेक्शन में दिखाए गए URL को Test Webhook URL और Live Webhook URL दोनों के रूप में सेट करें। यह कुछ इस तरह दिखता है: https://your-site/wc-api/paystack_p_webhook/। URL को ठीक वैसे ही कॉपी करें जैसा सेटिंग में दिखाया गया है।

Paystack हर वेबहुक को आपकी सीक्रेट कुंजी से हस्ताक्षरित करता है, इसलिए और कुछ कॉन्फ़िगर करने की ज़रूरत नहीं। टेस्ट वेबहुक टेस्ट सीक्रेट कुंजी से और लाइव वेबहुक लाइव सीक्रेट कुंजी से जाँचे जाते हैं। बिना मान्य हस्ताक्षर वाले वेबहुक अस्वीकार कर दिए जाते हैं। प्लगइन charge.success इवेंट का उपयोग करता है:

अन्य इवेंट का उत्तर OK से दिया जाता है और उन्हें अनदेखा किया जाता है। वेबहुक के बिना, ऑर्डर केवल तब पुष्ट होता है जब ग्राहक भुगतान के बाद स्टोर पर लौटता है। बाद में पूरे होने वाले बैंक ट्रांसफ़र और USSD भुगतान केवल वेबहुक से पुष्ट होते हैं।

ऑर्डर

Autocomplete Order: Automatically mark orders as completed after successful payment। चिह्नित होने पर भुगतान किए गए ऑर्डर Processing की जगह Completed हो जाते हैं, एक स्टेटस परिवर्तन और ग्राहक को एक ईमेल के साथ। डिफ़ॉल्ट: बंद।

उन्नत

Debug log: Log Paystack events and API calls for debugging विवरण WooCommerce > Status > Logs में लिखता है, स्रोत wcp_paystack_payment। त्रुटियाँ हमेशा लॉग होती हैं। कुंजियाँ और ग्राहक डेटा कभी लॉग नहीं होते। डिफ़ॉल्ट: बंद।

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

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Paystack) और ऑर्डर देता है। टेस्ट मोड में चेकआउट पर TEST MODE ENABLED. No real charges will be made. दिखता है। प्लगइन ऑर्डर मुद्रा में ऑर्डर कुल के लिए, ऑर्डर के बिलिंग ईमेल के साथ, एक Paystack लेन-देन शुरू करता है और ग्राहक को Paystack के होस्टेड चेकआउट पेज पर भेजता है। वहाँ ग्राहक आपके Paystack खाते में सक्षम चैनलों में से किसी एक से भुगतान करता है।

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर केवल तब भुगतान किया हुआ चिह्नित होता है जब Paystack उसकी पुष्टि कर दे: जब ग्राहक लौटता है और जब वेबहुक आता है, प्लगइन उस मोड की सीक्रेट कुंजी से, जिसमें भुगतान शुरू हुआ था, Paystack API से लेन-देन पढ़ता है और संदर्भ, स्टेटस, राशि और मुद्रा जाँचता है। यदि भुगतान अभी भी संसाधित हो रहा है, जैसे बैंक ट्रांसफ़र, तो ऑर्डर प्राप्ति पेज पर Your payment is being confirmed by Paystack. You will receive an email as soon as it is confirmed. (आपका भुगतान Paystack द्वारा पुष्ट किया जा रहा है। पुष्टि होते ही आपको एक ईमेल मिलेगा।) दिखता है। वेबहुक ऑर्डर को बाद में पूरा करता है।

यदि ग्राहक Paystack पेज पर रद्द करता है या बिना भुगतान किए उसे छोड़ देता है, तो ऑर्डर भुगतान की प्रतीक्षा करता रहता है। ग्राहक एक संदेश के साथ चेकआउट या Pay for order पेज पर लौटता है, उदाहरण के लिए Payment was cancelled. You can try again or choose another payment method., The payment was not completed. You can try again or choose another payment method. या Your payment was declined. You can try again or choose another payment method. ग्राहक उसी ऑर्डर का दोबारा भुगतान कर सकता है। ऑर्डर का पिछला भुगतान पेज भी मान्य रहता है: यदि उस पर बाद में भुगतान होता है, तो वह भुगतान फिर भी स्वीकार होता है।

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

यदि Paystack भुगतान शुरू नहीं कर पाता, तो ग्राहक को एक छोटा संदेश दिखता है, उदाहरण के लिए Paystack could not start the payment: के बाद Paystack से मिला कारण, या Paystack is temporarily unavailable. Please try again in a moment or choose another payment method. ऑर्डर कुल शून्य से अधिक होना चाहिए, और ऑर्डर में एक मान्य ईमेल पता होना चाहिए।

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

इस प्लगइन में इनलाइन या पॉप-अप भुगतान फ़ॉर्म, सहेजे गए कार्ड, सब्सक्रिप्शन, विभाजित भुगतान या सब-अकाउंट नहीं हैं, और WooCommerce में भुगतान चैनलों का चयन भी नहीं है।

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

ऑर्डर स्टेटस

Pending payment: ग्राहक को Paystack पर भेजा गया है और उसने अभी भुगतान नहीं किया है, या बिना भुगतान किए Paystack पेज छोड़ दिया है, या भुगतान अब भी Paystack द्वारा संसाधित हो रहा है। जब ग्राहक बिना भुगतान किए लौटता है, तो एक नोट बताता है कि ऑर्डर अब भी भुगतान की प्रतीक्षा में है।

Processing or Completed: भुगतान की पुष्टि हो गई है। जब Autocomplete Order चालू हो, तो स्टेटस Completed होता है। ऑर्डर नोट में राशि, Paystack संदर्भ, लेन-देन संख्या, मोड (टेस्ट या लाइव), भुगतान चैनल, कार्ड भुगतान के लिए कार्ड का प्रकार और अंतिम अंक, और ग्राहक द्वारा चुकाए गए Paystack शुल्क दिखते हैं। ऑर्डर का लेन-देन ID Paystack संदर्भ (order_...) है।

On hold: भुगतान की गई राशि या मुद्रा ऑर्डर से भिन्न है (नोट Paystack amount or currency mismatch), या ऑर्डर रद्द होने के बाद भुगतान आया। ऑर्डर नोट बताता है कि क्या जाँचना है। ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

Failed: Paystack बताता है कि किसी लंबित ऑर्डर का नवीनतम भुगतान प्रयास विफल हो गया या उलट दिया गया। किसी पुराने प्रयास की विफलता ऑर्डर को नहीं बदलती। ग्राहक फिर से भुगतान कर सकता है।

यदि पहले से भुगतान किए गए ऑर्डर का दूसरा भुगतान प्रयास भी भुगतान हो जाता है, तो ऑर्डर नहीं बदलता। एक नोट आपसे Paystack डैशबोर्ड में डुप्लीकेट भुगतान रिफ़ंड करने के लिए कहता है। किसी दूसरी स्थिति वाले ऑर्डर (जैसे Refunded) के लिए आया भुगतान केवल ऑर्डर पर नोट किया जाता है।

रिफ़ंड

ऑर्डर खोलें, Refund पर क्लिक करें, राशि दर्ज करें और Refund via Paystack पर क्लिक करें। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। रिफ़ंड बटन केवल उन ऑर्डर के लिए दिया जाता है जो सत्यापित Paystack लेन-देन के माध्यम से भुगतान किए गए हों। रिफ़ंड उसी लेन-देन पर जाता है जिससे ऑर्डर का भुगतान हुआ था, और उस मोड (टेस्ट या लाइव) की सीक्रेट कुंजी से किया जाता है जिसमें वह हुआ था, इसलिए वह कुंजी सेट होनी चाहिए। XOF और RWF में रिफ़ंड पूर्ण राशियाँ होनी चाहिए। Paystack रिफ़ंड को कतार में डालता है: ऑर्डर नोट में Paystack द्वारा लौटाया गया स्टेटस, जैसे pending, और रिफ़ंड ID दिखते हैं। यदि Paystack रिफ़ंड स्वीकार नहीं करता, तो WooCommerce कारण सहित Paystack refund failed: दिखाता है, और कोई रिफ़ंड दर्ज नहीं होता।

Paystack डैशबोर्ड में किए गए रिफ़ंड, और Paystack द्वारा कतार में डाले गए रिफ़ंड की अंतिम स्थिति, WooCommerce में वापस सिंक नहीं होते। ज़रूरत हो तो उन्हें मैन्युअली दर्ज करें।

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

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

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

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

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

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

चेकआउट पर Paystack नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, वर्तमान मोड में सही सीक्रेट कुंजी है (टेस्ट मोड में sk_test_... वाली Test Secret Key, लाइव मोड में sk_live_... वाली Live Secret Key), और ऑर्डर की मुद्रा ऐसी है जिसे Paystack स्वीकार करता है। सेटिंग के ऊपर का स्टेटस बॉक्स समस्या बताता है।

भुगतान हो गया, पर ऑर्डर Pending payment पर रहता है: वेबहुक आपके स्टोर तक नहीं पहुँचा और ग्राहक भी वापस नहीं लौटा। Paystack डैशबोर्ड में जाँचें कि Test Webhook URL और Live Webhook URL सेटिंग में दिखाए गए URL से बिल्कुल मेल खाते हैं, और कोई मेंटेनेंस मोड, फ़ायरवॉल या पासवर्ड सुरक्षा उसे रोक नहीं रही है। अस्वीकृत वेबहुक के लिए WooCommerce > Status > Logs में स्रोत wcp_paystack_payment देखें।

वेबहुक Invalid signature से जवाब देता है: वेबहुक उस टेस्ट या लाइव सीक्रेट कुंजी से हस्ताक्षरित नहीं है जो सेटिंग में दर्ज है, उदाहरण के लिए कुंजियाँ किसी दूसरे Paystack खाते की हैं। वेबहुक भेजने वाले खाते की कुंजियाँ दर्ज करें।

वेबहुक Secret key not configured से जवाब देता है: कोई सीक्रेट कुंजी सेट नहीं है। सेटिंग में सीक्रेट कुंजियाँ दर्ज करें।

वेबहुक Verification failed या Busy, retry later से जवाब देता है: उस समय Paystack API से लेन-देन नहीं पढ़ा जा सका, या ऑर्डर उसी समय ग्राहक की वापसी से अपडेट हो रहा था। ऑर्डर नहीं बदलता, और Paystack वेबहुक दोबारा भेजता है।

वेबहुक OK - unknown reference से जवाब देता है: भुगतान इस स्टोर के किसी ऑर्डर के लिए नहीं था, उदाहरण के लिए कोई Paystack भुगतान पेज या उसी खाते पर कोई दूसरी इंटीग्रेशन। इसे अनदेखा किया जाता है।

ग्राहक को Payment gateway is not properly configured दिखता है: वर्तमान मोड की सीक्रेट कुंजी गायब है या गलत है। सेटिंग के ऊपर के स्टेटस बॉक्स के निर्देश के अनुसार इसे ठीक करें।

भुगतान के बाद ऑर्डर On hold है: ऑर्डर नोट पढ़ें। भुगतान की गई राशि या मुद्रा ऑर्डर से अलग थी, या ऑर्डर रद्द होने के बाद भुगतान आया। ऑर्डर प्रोसेस करें या भुगतान रिफ़ंड करें।

मोड से जुड़े संदेश के साथ रिफ़ंड विफल होता है: भुगतान टेस्ट या लाइव मोड में हुआ था, और उस मोड की सीक्रेट कुंजी कॉन्फ़िगर नहीं है। उसे दर्ज करें और फिर से प्रयास करें। संदेश No verified Paystack payment was found for this order का अर्थ है कि ऑर्डर किसी सत्यापित Paystack लेन-देन से भुगतान नहीं हुआ था। उसे Paystack डैशबोर्ड में रिफ़ंड करें।

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

अनइंस्टॉल

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

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