VibeFox Khipu for WooCommerce — सहायता

आवश्यकताएँ

WordPress: 6.0 या उससे नया।

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

PHP: 8.0 या उससे नया।

स्टोर करेंसी: चिली पेसो (CLP), अर्जेंटीना पेसो (ARS) या पेरू सोल (PEN)। जब स्टोर, या Pay for order पेज पर मौजूद ऑर्डर, कोई दूसरी करेंसी इस्तेमाल करता है, तो चेकआउट पर यह भुगतान विधि छिपा दी जाती है।

Khipu खाता: आपको अपने Khipu कलेक्शन खाते का Receiver ID ("Id de cobrador"), API key और secret key ("llave") चाहिए। ये आपको अपने Khipu खाते में मर्चेंट प्रोफ़ाइल (khipu.com/merchant/profile) के अंतर्गत मिलते हैं। तीनों ज़रूरी हैं: secret key के बिना कोई भी भुगतान कन्फ़र्म नहीं हो सकता।

पहुँचने योग्य साइट: Khipu आपके स्टोर को कॉल करके भुगतान कन्फ़र्म करता है, इसलिए साइट इंटरनेट से पहुँचने योग्य होनी चाहिए (न मेंटेनेंस मोड, न बेसिक ऑथेंटिकेशन, और न ही Khipu को ब्लॉक करने वाला फ़ायरवॉल)।

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

इंस्टॉलेशन

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

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

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

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

5. अपने Khipu कलेक्शन खाते का Receiver ID, API key और Secret key दर्ज करें (कॉन्फ़िगरेशन देखें)।

6. Enable / Disable चालू करें और सहेजें। पहले परीक्षण के लिए किसी Khipu डेवलपर खाते की कुंजियाँ इस्तेमाल करें, फिर उन्हें अपने प्रोडक्शन खाते की कुंजियों से बदल दें।

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

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

सामान्य

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

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

Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला टेक्स्ट। डिफ़ॉल्ट: Pay by bank transfer with Khipu।

Khipu खाता

अपने Khipu कलेक्शन खाते (khipu.com/merchant/profile) से Receiver ID, API key और secret key कॉपी करें। Khipu का कोई अलग सैंडबॉक्स सर्वर नहीं है और प्लगइन में टेस्ट मोड का कोई स्विच नहीं है। परीक्षण के लिए डेवलपर ("desarrollo") कलेक्शन खाते की कुंजियाँ इस्तेमाल करें: इसमें भुगतान DemoBank टेस्ट बैंक से होता है और कोई वास्तविक पैसा नहीं जाता। लाइव जाने पर अपने प्रोडक्शन कलेक्शन खाते की कुंजियों पर स्विच करें।

Receiver ID: आपका Khipu Receiver ("cobrador") ID। दूसरे Khipu खातों के भुगतान अस्वीकार कर दिए जाते हैं।

API key: भुगतान बनाने और Khipu के साथ हर भुगतान की पुष्टि करने के लिए उपयोग होती है।

Secret key: Khipu भुगतान सूचनाओं के सिग्नेचर (HMAC-SHA256) की पुष्टि करने के लिए उपयोग होती है। इसके बिना कोई भी भुगतान कन्फ़र्म नहीं हो सकता।

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

Khipu सेटिंग्स के इसी भाग में दिखाए गए नोटिफ़िकेशन URL को कॉल करके भुगतान कन्फ़र्म करता है। यह ऐसा दिखता है: https://your-site/wc-api/webhook_wc_khipu/। यह URL हर भुगतान के साथ स्वतः भेजा जाता है, इसलिए आपके Khipu खाते में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है, लेकिन URL इंटरनेट से पहुँचने योग्य होना चाहिए।

हर सूचना के साथ आपकी Secret key से बना एक मान्य सिग्नेचर होना चाहिए। मान्य सिग्नेचर के बिना आने वाली सूचनाएँ अस्वीकार कर दी जाती हैं। इसके बाद प्लगइन Khipu से भुगतान की स्थिति पूछता है और Khipu जो बताता है उसके अनुसार कार्रवाई करता है:

Status after payment: Khipu द्वारा भुगतान कन्फ़र्म होने पर ऑर्डर की स्थिति। स्थिति तुरंत सेट होती है, एक ही स्थिति परिवर्तन और ई-मेल के एक ही सेट के साथ।

उन्नत

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

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

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Khipu) और ऑर्डर करता है। प्लगइन ऑर्डर की करेंसी में ऑर्डर की कुल राशि के लिए Khipu भुगतान बनाता है, जिसमें ऑर्डर संख्या, स्टोर का नाम और ऑर्डर की गई वस्तुएँ होती हैं, और ग्राहक को Khipu भुगतान पेज पर भेजता है। बिलिंग ई-मेल मान्य होने पर Khipu को भेजा जाता है। Khipu पेज पर ग्राहक अपने ही बैंक से बैंक ट्रांसफ़र द्वारा भुगतान करता है और वहीं Khipu द्वारा दिए गए ट्रांसफ़र प्रकारों में से चुनता है।

भुगतान के बाद ग्राहक आपके स्टोर के ऑर्डर प्राप्त होने वाले पेज पर लौट आता है। ऑर्डर को भुगतान हो चुका तभी चिह्नित किया जाता है जब Khipu ट्रांसफ़र कन्फ़र्म कर दे: हस्ताक्षरित सूचना से, या जब ग्राहक ऑर्डर प्राप्त होने वाला पेज खोलता है तब Khipu को भेजे गए स्थिति अनुरोध से। लौटना अपने आप में कभी ऑर्डर को भुगतान हो चुका नहीं बनाता। जब तक ट्रांसफ़र कन्फ़र्म नहीं होता, पेज दिखाता है Khipu is confirming your bank transfer. Your order will be updated automatically as soon as Khipu confirms the payment, and you will receive an e-mail.

अगर ग्राहक बिना भुगतान किए Khipu पेज छोड़ देता है, तो वह Pay for order पेज पर पहुँचता है, जहाँ लिखा होता है The Khipu payment was not completed. You can try again or choose another payment method. नया प्रयास पिछले बिना भुगतान वाले Khipu भुगतान को हटा देता है, इसलिए पुराने लिंक से अब भुगतान नहीं किया जा सकता। अगर Khipu को पिछला भुगतान पहले ही मिल चुका है, तो ऑर्डर पूर्ण कर दिया जाता है और कोई नया भुगतान नहीं बनाया जाता। अगर पिछला ट्रांसफ़र अभी सत्यापित हो रहा है, तो ग्राहक देखता है Your previous Khipu payment for this order is still being verified by the bank. Please wait a few minutes before paying again.

स्टॉक प्रबंधन चालू होने पर Khipu भुगतान WooCommerce के Hold stock (minutes) समय के साथ ही समाप्त हो जाता है, इसलिए ग्राहक उस ऑर्डर का भुगतान नहीं कर सकता जो पहले ही रद्द हो चुका है।

अगर Khipu भुगतान नहीं बना पाता, तो ग्राहक को एक छोटा संदेश दिखता है, जैसे Khipu could not create the payment for this order. Please check your billing details and try again, or contact the store. या Khipu is temporarily unavailable. Please try again in a few minutes. विवरण लॉग में लिखे जाते हैं।

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

प्लगइन केवल एकमुश्त बैंक ट्रांसफ़र भुगतान लेता है। WooCommerce से रिफ़ंड समर्थित नहीं हैं, और इसमें कोई सदस्यता, सहेजी गई भुगतान विधियाँ या प्री-ऑथराइज़ेशन नहीं हैं।

ऑर्डर

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

Pending payment: ग्राहक को Khipu पर भेजा गया है और उसने अभी भुगतान नहीं किया, या Khipu ने ट्रांसफ़र अभी कन्फ़र्म नहीं किया। ऑर्डर नोट में Khipu भुगतान ID दिखती है।

Processing or Completed: Khipu ने भुगतान कन्फ़र्म कर दिया। स्थिति Status after payment के अनुसार होती है। ऑर्डर नोट में Khipu भुगतान ID दिखती है, और ट्रांज़ैक्शन ID वही Khipu भुगतान ID होती है।

On hold: Khipu ने ऐसे भुगतान की सूचना दी जिसकी राशि या करेंसी ऑर्डर से मेल नहीं खाती, या भुगतान ऑर्डर रद्द होने के बाद आया (उदाहरण के लिए स्टॉक होल्ड का समय बीत जाने के बाद)। ऑर्डर नोट इसे समझाता है। अपने Khipu खाते में भुगतान जाँचें और ऑर्डर पूर्ण करें या ग्राहक को रिफ़ंड करें।

अगर किसी ऐसे ऑर्डर के लिए भुगतान आता है जिसका भुगतान पहले ही हो चुका है या भुगतान के बाद जो बंद कर दिया गया था, तो ऑर्डर में कोई बदलाव नहीं होता। एक नोट आपसे कहता है कि अगर यह दूसरा भुगतान है तो इसे ग्राहक को रिफ़ंड कर दें।

रिफ़ंड

WooCommerce से रिफ़ंड Khipu को नहीं भेजे जाते। ग्राहक को अपने Khipu खाते से या बैंक ट्रांसफ़र से रिफ़ंड करें, फिर WooCommerce में रिफ़ंड को मैन्युअली दर्ज करें।

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

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

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

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

लाइसेंस समाप्त होने पर प्लगइन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। स्थिति बैकग्राउंड में स्वतः दोबारा जाँची जाती है।

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

चेकआउट पर Khipu नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable / Disable चालू है और Receiver ID, API key तथा Secret key — तीनों भरी गई हैं। स्टोर की करेंसी CLP, ARS या PEN होनी चाहिए। कुछ छूटा होने पर सेटिंग्स पेज चेतावनी दिखाता है।

भुगतान हो गया, लेकिन ऑर्डर Pending payment पर अटका है: Khipu ट्रांसफ़र को बैंक द्वारा सत्यापित होने के बाद कन्फ़र्म करता है। ऑर्डर तब अपडेट होता है जब Khipu की सूचना आती है या जब ग्राहक ऑर्डर प्राप्त होने वाला पेज खोलता है। जाँचें कि सेटिंग्स में दिखाए गए नोटिफ़िकेशन URL पर आपकी साइट इंटरनेट से पहुँचने योग्य है (न मेंटेनेंस मोड, न बेसिक ऑथेंटिकेशन, और न ही Khipu को ब्लॉक करने वाला फ़ायरवॉल), और WooCommerce > Status > Logs में स्रोत wcp_khipu_gateway देखें।

सूचना का उत्तर Secret key not configured आता है: Secret key खाली है। इसे दर्ज करें। Khipu सूचना फिर से भेजता है।

सूचना का उत्तर Invalid signature, Missing signature या Malformed signature आता है: Secret key उसी कलेक्शन खाते की नहीं है जिसकी कुंजियाँ आप इस्तेमाल कर रहे हैं, या अनुरोध Khipu से नहीं आया।

सूचना का उत्तर Payment does not belong to this order आता है: भुगतान किसी दूसरे Receiver ID पर या किसी दूसरे ऑर्डर के लिए किया गया। Receiver ID जाँचें।

सूचना का उत्तर Payment not final yet या Verification unavailable आता है: ट्रांसफ़र अभी सत्यापित हो रहा है, या Khipu तक पहुँच नहीं हो सकी। Khipu सूचना फिर से भेजता है।

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

ग्राहक को "Khipu payments are not available right now" दिखता है: API key नहीं भरी है या गलत है। अपने Khipu खाते की कुंजियाँ जाँचें।

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

अगर आपका Khipu खाता कोई दूसरी करेंसी स्वीकार करता है, उदाहरण के लिए Khipu Spain के लिए EUR, तो डेवलपर इसे wc_khp_supported_currencies फ़िल्टर से जोड़ सकते हैं।

अनइंस्टॉल

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

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