PrestaShop मॉड्यूल

सिंहावलोकन

PrestaShop के लिए MakePay व्यापारियों को होस्ट किए गए MakePay checkout के माध्यम से क्रिप्टो भुगतान स्वीकार करने देता है। ग्राहक PrestaShop checkout के दौरान MakePay भुगतान विधि चुनते हैं, उन्हें भुगतान करने के लिए MakePay पर रीडायरेक्ट किया जाता है, और भुगतान के बाद स्टोर पर वापस आ जाते हैं।

मॉड्यूल प्रत्येक PrestaShop ऑर्डर के लिए एक MakePay भुगतान लिंक बनाता है और हस्ताक्षरित MakePay webhooks को सुनता है, इसलिए ऑर्डर स्थिति में परिवर्तन स्वचालित रूप से होता है।

आपके शुरू करने से पहले

आपको चाहिये होगा:

• PrestaShop 8.0 या नया, जिसमें PrestaShop 9.x शामिल है
• PHP 7.4 या ओपनएसएसएल सक्षम के साथ नया
• एक HTTPS बैक ऑफिस और checkout URL
• एक PrestaShop कर्मचारी खाता जो मॉड्यूल कॉन्फ़िगर कर सकता है
• MakeCrypto कंपनी MakePay निपटान के साथ कॉन्फ़िगर की गई

PHP सोडियम की अनुशंसा की जाती है। जब यह उपलब्ध होता है, तो मॉड्यूल कनेक्शन विवरण, webhook रहस्यों और मैन्युअल API-कुंजी फ़ॉलबैक क्रेडेंशियल्स को एन्क्रिप्ट करने के लिए PrestaShop कुकी रहस्यों के साथ इसका उपयोग करता है।

MakeCrypto सेट करें

PrestaShop को कनेक्ट करने से पहले मर्चेंट सेटअप पूरा करें।

1. https://www.makecrypto.io पर साइन इन करें और चुनें वह कंपनी जिसे PrestaShop भुगतान प्राप्त होना चाहिए।
2. वॉलेट > बैलेंस खोलें, फिर निपटान मुद्रा, श्रृंखला और कॉन्फ़िगर करें गंतव्य बटुआ.
3. व्यापारी > भुगतान सेटिंग खोलें और भुगतान शुल्क और रीडायरेक्ट की समीक्षा करें व्यवहार।
4. वैकल्पिक: मर्चेंट ब्रांडिंग, समर्थन जोड़ने के लिए सेटिंग्स > मर्चेंट खोलें ईमेल, checkout रंग, होस्टेड भुगतान थीम और कस्टम डोमेन।

आपको मैन्युअल रूप से डेवलपर एप्लिकेशन बनाने की आवश्यकता नहीं है। जब आप कनेक्ट MakePay पर क्लिक करते हैं तो आधिकारिक PrestaShop मॉड्यूल एक स्टोर-विशिष्ट कनेक्शन बनाता है।

मॉड्यूल स्थापित करें

नवीनतम आधिकारिक मॉड्यूल ज़िप डाउनलोड करें:

https://plugins.makecrypto.io/downloads/prestashop/latest.zip

फिर इसे PrestaShop में इंस्टॉल करें:

1. बैक ऑफिस > मॉड्यूल > मॉड्यूल मैनेजर खोलें।
2. एक मॉड्यूल अपलोड करें पर क्लिक करें और डाउनलोड किया गया makepay.zip चुनें।
3. इंस्टालेशन के बाद, कॉन्फ़िगर पर क्लिक करें।
4. प्रमाणीकरण को डिफ़ॉल्ट कनेक्टेड मोड पर सेट रखें।

ज़िप रूट makepay/ है और मुख्य मॉड्यूल फ़ाइल makepay.php है, जो PrestaShop मॉड्यूल पैकेजिंग अपेक्षाओं से मेल खाती है।

अपना स्टोर कनेक्ट करें

सामान्य सेटअप के लिए कनेक्ट MakePay का उपयोग करें। यह इस PrestaShop स्टोर को आपके द्वारा चुनी गई MakeCrypto कंपनी से जोड़ता है और बाद में स्टोर कोड बदले बिना इसे डिस्कनेक्ट किया जा सकता है।

1. MakePay मॉड्यूल कॉन्फ़िगरेशन में, MakePay API बेस URL को सेट रखें https://www.makecrypto.io.
2. कनेक्ट MakePay पर क्लिक करें।
3. संकेत मिलने पर MakeCrypto में साइन इन करें, वह कंपनी चुनें जिसे आपने तैयार किया है, और अनुरोधित पहुंच को मंजूरी दें।
4. PrestaShop पर लौटने के बाद, पुष्टि करें कि मॉड्यूल स्टोर को इस रूप में दिखाता है जुड़े हुए।
5. गेटवे सेटिंग्स सहेजें और मॉड्यूल को सक्षम रखें।

कनेक्शन के दौरान, मॉड्यूल स्वचालित रूप से सार्वजनिक webhook URL को पंजीकृत करता है:

https://your-store.example/module/makepay/webhook

इस समापन बिंदु को सार्वजनिक इंटरनेट से पहुंच योग्य रखें। सुरक्षा मॉड्यूल, फ़ायरवॉल और कैशिंग नियमों को उस URL पर हस्ताक्षरित POST अनुरोधों की अनुमति देनी चाहिए।

कनेक्शन कैसे काम करता है

कनेक्ट MakePay बटन ब्राउज़र टैब में MakeCrypto खोलता है। आप साइन इन करते हैं, वह कंपनी चुनते हैं जिसे भुगतान प्राप्त होना चाहिए, अनुरोधित पहुंच की समीक्षा करें, और अनुमोदन के बाद PrestaShop पर वापस लौटें। मॉड्यूल तब कनेक्शन को सहेजता है, webhook URL को पंजीकृत करता है, और मल्टीस्टोर इंस्टॉल में प्रत्येक दुकान संदर्भ के लिए सेटिंग्स को अलग रखता है।

PrestaShop के लिए किसी साझा ऐप रहस्य या डेवलपर ऐप सेटअप की आवश्यकता नहीं है।

गेटवे सेटिंग्स

मॉड्यूल > मॉड्यूल मैनेजर > MakePay > कॉन्फिगर में इन सेटिंग्स की समीक्षा करें।

सेटिंग	यह क्या करता है
सक्षम	MakePay भुगतान विधि को checkout पर चालू या बंद करता है।
प्रमाणीकरण	सामान्य इंस्टॉल के लिए डिफ़ॉल्ट कनेक्टेड मोड का उपयोग करें। मैन्युअल API कुंजी फ़ॉलबैक समर्थन-आधारित पुनर्प्राप्ति के लिए है।
भुगतान विधि का नाम	ग्राहक checkout पर जो नाम देखते हैं, उदाहरण के लिए Crypto Payment in USDT, BTC, ETH, LTC, DOGE and others।
चेकआउट अनुभव	सबसे विश्वसनीय प्रवाह के लिए होस्टेड रीडायरेक्ट का उपयोग करें, या होस्टेड-लिंक फ़ॉलबैक के साथ एक सुरक्षित आईफ़्रेम पेज में MakePay को दिखाने के लिए एम्बेडेड checkout पेज का उपयोग करें।
निपटान मुद्रा	पसंदीदा MakePay संपत्ति जैसे USDT। MakePay जहां संभव हो कंपनी सेटिंग्स से श्रृंखला का समाधान करता है।
भुगतान समाप्ति	होस्ट किया गया checkout जीवनकाल, उदाहरण के लिए 30m, 2h, या 12h।
MakePay API आधार URL	उत्पादन के लिए https://www.makecrypto.io का उपयोग करें।
कंपनी आईडी / API कुंजी आईडी / API कुंजी रहस्य	केवल मैन्युअल API-कुंजी फ़ॉलबैक के लिए आवश्यक है।
Webhook रहस्य	कनेक्शन के दौरान स्वचालित रूप से सेट करें। केवल फ़ॉलबैक मोड के लिए मैन्युअल रूप से दर्ज करें।

आदेश बताता है

checkout पर, मॉड्यूल कस्टम MakePay भुगतान की प्रतीक्षा स्थिति में एक PrestaShop ऑर्डर बनाता है और चयनित MakePay checkout अनुभव को खोलता है।

Webhook स्थिति मानचित्रण:

MakePay स्थिति	PrestaShop स्थिति
paid, completed, confirmed, succeeded	भुगतान स्वीकार किया गया
refunded, refund	रिफंड किया गया
failed, expired, chargeback	भुगतान त्रुटि
cancelled, canceled	रद्द
अन्य प्रगतिरत स्थितियाँ	MakePay भुगतान की प्रतीक्षा में

मॉड्यूल webhook स्थिति, भुगतान UID, राशि, संपत्ति और भुगतान URL के साथ निजी ऑर्डर संदेश लिखता है जब MakePay webhook पेलोड में मौजूद होता है।

सुरक्षा और अनुमतियाँ

PrestaShop कनेक्शन अनुरोध:

• company:read
• makepay:payment-links:read
• makepay:payment-links:write
• makepay:customers:read
• makepay:customers:write
• makepay:settings:read
• makepay:settings:write

यह वॉलेट फंड नहीं भेज सकता या लीगेसी API कुंजी नहीं बना सकता।

Webhook अपडेट पर MakePay द्वारा हस्ताक्षर किए जाते हैं और किसी भी PrestaShop ऑर्डर स्थिति में बदलाव से पहले सत्यापित किया जाता है। स्टोर व्यवस्थापक एकीकरण > कनेक्टेड ऐप्स के अंतर्गत MakeCrypto में कनेक्शन रद्द कर सकते हैं, या इसे PrestaShop मॉड्यूल कॉन्फ़िगरेशन पृष्ठ से डिस्कनेक्ट कर सकते हैं।

मैनुअल API-कुंजी फ़ॉलबैक

मैन्युअल API-कुंजी मोड का उपयोग केवल तभी करें जब कनेक्ट MakePay अनुपलब्ध हो या MakeCrypto समर्थन आपको इसका उपयोग करने के लिए कहे।

1. MakeCrypto में, एकीकरण > API एकीकरण खोलें।
2. उसी कंपनी के लिए MakePay API कुंजी बनाएं या चुनें जो स्टोर प्राप्त करती है भुगतान.
3. कंपनी आईडी, API कुंजी आईडी, API कुंजी रहस्य और webhook रहस्य की प्रतिलिपि बनाएँ।
4. PrestaShop में, मॉड्यूल > मॉड्यूल मैनेजर > MakePay > कॉन्फ़िगर करें खोलें।
5. प्रमाणीकरण को मैन्युअल API कुंजी फ़ॉलबैक पर सेट करें।
6. क्रेडेंशियल चिपकाएँ और सहेजें।

API प्रमुख रहस्यों को थीम फ़ाइलों, क्लाइंट-साइड स्क्रिप्ट और सार्वजनिक समर्थन टिकटों से दूर रखें। कनेक्ट MakePay को अभी भी सामान्य स्टोर संचालन के लिए प्राथमिकता दी जाती है।

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

यदि कनेक्ट MakePay विफल रहता है, तो पुष्टि करें कि आपका बैक ऑफिस URL HTTPS का उपयोग करता है, आपका स्टोर https://www.makecrypto.io को आउटबाउंड HTTPS अनुरोध कर सकता है, और कर्मचारी खाता मॉड्यूल कॉन्फ़िगर कर सकता है।

यदि भुगतान विधि checkout पर दिखाई नहीं देती है, तो पुष्टि करें कि मॉड्यूल सक्रिय है, सक्षम चालू है, और स्टोर MakePay से जुड़ा है या उसके पास वैध मैनुअल API-कुंजी क्रेडेंशियल हैं।

यदि checkout कोई निपटान या ऑनबोर्डिंग त्रुटि दिखाता है, तो MakeCrypto पर वापस लौटें और स्टोर से जुड़ी कंपनी के लिए वॉलेट > बैलेंस > सेट अप सेटलमेंट पूरा करें।

यदि भुगतान के बाद ऑर्डर अपडेट नहीं होते हैं, तो डिलीवरी प्रयासों के लिए MakeCrypto में एकीकरण > Webhook अनुरोध जांचें। PrestaShop webhook समापन बिंदु को 2xx प्रतिक्रिया लौटानी चाहिए। यह भी जांचें कि होस्टिंग फ़ायरवॉल POST अनुरोधों को /module/makepay/webhook पर रोक नहीं रहे हैं।

यदि आप स्टोर डोमेन, बैक ऑफिस डोमेन बदलते हैं, या दुकान को एक नए वातावरण में ले जाते हैं, तो MakePay को डिस्कनेक्ट और पुनः कनेक्ट करें ताकि कनेक्शन कॉलबैक और webhook URLs वर्तमान स्टोर से मेल खा सकें।