VibeFox Khipu for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

PHP: 8.0 या बाद का संस्करण। मॉड्यूल पुराने PHP संस्करणों पर इंस्टॉल नहीं होता।

मुद्रा: चिली पेसो (CLP), अर्जेंटीना पेसो (ARS) या पेरू सोल (PEN)। अन्य मुद्राओं वाले कार्ट के लिए चेकआउट पर यह भुगतान तरीका छिपा दिया जाता है।

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

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

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

इंस्टॉलेशन

1. बैक ऑफ़िस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।

2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox Khipu Gateway खोजकर Configure पर क्लिक करें।

3. Configure पेज के शीर्ष पर लाइसेंस ब्लॉक में License key फ़ील्ड में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।

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

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

इंस्टॉल होने पर मॉड्यूल ऑर्डर स्टेटस Khipu payment on hold बनाता है। PrestaShop सभी मुद्राओं, देशों और ग्राहक समूहों के लिए नया भुगतान मॉड्यूल डिफ़ॉल्ट रूप से सक्षम करता है। इन्हें आप Payment > Preferences में सीमित कर सकते हैं।

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

सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox Khipu Gateway > Configure। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सहेजता है। फ़ील्ड्स के ऊपर पेज चेतावनी देता है जब Receiver ID, API key या Secret key गायब हो (तब चेकआउट पर Khipu नहीं दिखाया जाता), और जब स्टोर की डिफ़ॉल्ट मुद्रा 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) को सत्यापित करने के लिए उपयोग होती है। इसके बिना कोई भुगतान पुष्ट नहीं हो सकता।

सहेजी गई कुंजियाँ फिर कभी नहीं दिखाई जातीं। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें।

Clear saved secrets: API key या Secret key पर टिक लगाएँ और हटाने के लिए Save पर क्लिक करें। खाली फ़ील्ड सहेजा हुआ मान बनाए रखता है।

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

Notification URL: Khipu यहाँ दिखाए गए URL को कॉल करके भुगतान की पुष्टि करता है। फ़्रेंडली URL के साथ यह इस तरह दिखता है: https://your-shop/module/wcp_khipu_gateway/webhook, संभवतः भाषा कोड के साथ। यह URL हर भुगतान के साथ अपने-आप भेजा जाता है, इसलिए आपके Khipu खाते में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है, लेकिन URL इंटरनेट से पहुँचने योग्य होना चाहिए।

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

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

उन्नत

Debug log: API कॉल और सूचनाएँ मॉड्यूल फ़ोल्डर में logs/wc_khp_debug.log.php में लॉग करता है। यह फ़ाइल वेब से नहीं खोली जा सकती। स्विच बंद होने पर भी त्रुटियाँ हमेशा लॉग होती हैं। कुंजियाँ और भुगतानकर्ता डेटा कभी नहीं लिखे जाते। डिफ़ॉल्ट: बंद।

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

Delete data on uninstall: चालू होने पर मॉड्यूल हटाने से गेटवे सेटिंग्स और लॉग हट जाते हैं। ऑर्डर डेटा (ऑर्डर के Khipu भुगतान ID) हमेशा रखा जाता है। डिफ़ॉल्ट: बंद।

चेकआउट

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

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर को तभी भुगतान किया हुआ चिह्नित किया जाता है जब Khipu उसकी पुष्टि कर दे: हस्ताक्षरित सूचना से, या ग्राहक के लौटने पर Khipu से स्थिति पूछने से। केवल लौटने से कुछ भी भुगतान किया हुआ चिह्नित नहीं होता। ऑर्डर बनने के बाद ग्राहक को मानक ऑर्डर पुष्टि पेज दिखता है। यदि बैंक अभी भी ट्रांसफ़र सत्यापित कर रहा है या Khipu तक पहुँचा नहीं जा सकता, तो Payment confirmation पेज दिखता है जिस पर लिखा होता है Khipu is confirming your bank transfer. Your order will be created automatically as soon as Khipu confirms the payment, and you will receive an e-mail. और उसके साथ Check again और Back to checkout बटन होते हैं। यदि कार्ट का नवीनतम Khipu भुगतान उससे मेल नहीं खाता (उदाहरण के लिए, वह किसी अन्य Receiver ID का है), तो ग्राहक We could not match this payment to an order. If you paid, please contact us. संदेश के साथ चेकआउट पर लौट आता है।

यदि ग्राहक बिना भुगतान किए Khipu पेज छोड़ देता है, या भुगतान पूरा नहीं हुआ, तो ग्राहक 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 भुगतान नहीं बना पाता, तो ग्राहक चेकआउट पर एक छोटे संदेश के साथ रहता है, उदाहरण के लिए 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. विवरण लॉग में लिखे जाते हैं।

सूचना स्टोर के मेंटेनेंस मोड में भी काम करती है, और आपके स्टोर के देश-प्रतिबंध से अवरुद्ध नहीं होती।

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

ऑर्डर

ऑर्डर स्टेटस

No order yet: ग्राहक को Khipu पर भेजा गया और उसने भुगतान नहीं किया, या Khipu ने अभी ट्रांसफ़र की पुष्टि नहीं की है। केवल कार्ट मौजूद है।

Payment accepted or Delivered: Khipu ने भुगतान की पुष्टि कर दी है। स्थिति Status after payment का अनुसरण करती है। भुगतान Khipu भुगतान ID को ट्रांज़ैक्शन ID के रूप में दर्ज होता है, और एक नोट Khipu payment verified. Payment ID: के साथ भुगतान ID और राशि दिखाता है।

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

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

Khipu भुगतान ब्लॉक

ऑर्डर पेज पर एक Khipu payment ब्लॉक दिखता है, जिसमें ऑर्डर के कार्ट के Khipu भुगतान प्रयास (तारीख, राशि, Khipu भुगतान ID, Khipu स्थिति और परिणाम) होते हैं, ऑर्डर के Khipu payment on hold में रहने तक एक Manual review चेतावनी, और ऑर्डर के Khipu notes। यह ब्लॉक केवल-पढ़ने योग्य है।

रिफ़ंड

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

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

मॉड्यूल vibefox.net से प्राप्त VibeFox लाइसेंस कुंजी के साथ काम करता है। License — VibeFox Khipu Gateway लाइसेंस ब्लॉक, Modules > Module Manager > VibeFox Khipu Gateway > Configure पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में दर्ज करें और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को छिपाकर दिखाता है, स्थिति (जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन) दिखाता है, और ये बटन दिखाता है: Check now (स्थिति दोबारा जाँचने के लिए), Change key (कोई दूसरी कुंजी दर्ज करने के लिए) और Remove key (इस स्टोर से कुंजी हटाने के लिए)। इनके नीचे Product: presta-payment-khipu वाली पंक्ति और Manage licenses and domains in your account लिंक है, जो आपका vibefox.net खाता खोलता है। केवल वे कर्मचारी कुंजी बदल सकते हैं जिनके पास इस मॉड्यूल के लिए Configure अनुमति है। ब्लॉक के टेक्स्ट बैक ऑफ़िस की भाषा के अनुसार दिखते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

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

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

सक्रिय कुंजी के बिना, चेकआउट पर ग्राहकों को Khipu नहीं दिखाया जाता। अगर फिर भी भुगतान शुरू किया जाता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। PrestaShop स्टोरफ़्रंट को पता नहीं होता कि आप बैक ऑफ़िस में लॉग इन हैं, इसलिए भुगतान विकल्प आपसे भी छिपा रहता है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, लेकिन चेकआउट पर उसे टेस्ट नहीं कर सकते। Modules > Module Manager पर Alerts टैब में एक याद दिलाने वाला संदेश दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं उनकी पुष्टि अब भी होती है।

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

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

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

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

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

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

सूचना का उत्तर Order not found या Payment does not belong to this order है: भुगतान किसी अन्य Receiver ID को या किसी अन्य कार्ट के लिए किया गया था। Receiver ID जाँचें।

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

सूचना का उत्तर Busy, retry later या Order could not be created, retry later है: उसी समय कोई अन्य अनुरोध ऑर्डर की पुष्टि कर रहा था, या ऑर्डर नहीं बनाया जा सका (उदाहरण के लिए, मॉड्यूल अक्षम है)। Khipu सूचना फिर से भेजता है। कारण लॉग में है।

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

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

यदि आपका Khipu खाता कोई अन्य मुद्रा स्वीकार करता है, उदाहरण के लिए Khipu Spain के लिए EUR, तो डेवलपर इसे actionWcpKhipuSupportedCurrencies हुक से जोड़ सकते हैं।

अनइंस्टॉल

Modules > Module Manager पर जाएँ, VibeFox Khipu Gateway के बगल का मेनू खोलें और Uninstall चुनें। इस मॉड्यूल की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती है। यदि Delete data on uninstall चालू है, तो गेटवे सेटिंग्स और लॉग हटा दिए जाते हैं। यदि बंद है, तो बाद में फिर से इंस्टॉल करने के लिए सभी सेटिंग्स रखी जाती हैं। Khipu भुगतान प्रयास और ऑर्डर स्टेटस Khipu payment on hold हमेशा रखे जाते हैं। मौजूदा ऑर्डर अपने भुगतान नोट और ट्रांज़ैक्शन ID बनाए रखते हैं।

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