MakePay Magento मॉड्यूल

सिंहावलोकन

आधिकारिक MakePay Magento मॉड्यूल Magento ओपन सोर्स और Adobe Commerce 2.4.x स्टोर्स में एक होस्टेड क्रिप्टो checkout विधि जोड़ता है। Magento ऑर्डर बनाता है, MakePay होस्टेड भुगतान लिंक बनाता है, और हस्ताक्षरित webhooks भुगतान स्थिति में बदलाव के बाद ऑर्डर को अपडेट करता है।

सामान्य सेटअप के लिए कनेक्ट MakePay का उपयोग करें। मैनुअल API-कुंजी क्रेडेंशियल फ़ॉलबैक के रूप में उपलब्ध रहते हैं।

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

• Magento ओपन सोर्स या Adobe Commerce 2.4.x
• PHP 8.1 या नया
• स्टोर > कॉन्फ़िगरेशन > बिक्री > भुगतान विधियों तक व्यवस्थापकीय पहुंच
• एक MakePay कंपनी जहां आप भुगतान सेटिंग प्रबंधित कर सकते हैं

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

नवीनतम ज़िप डाउनलोड करें:

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

पैकेज निकालें ताकि मॉड्यूल यहां स्थित हो:

app/code/MakePay/Payment

इसे अपने Magento रूट से सक्षम करें:

bin/magento module:enable MakePay_Payment
bin/magento setup:upgrade
bin/magento cache:clean

MakePay कनेक्ट करें

स्टोर खोलें > कॉन्फ़िगरेशन > बिक्री > भुगतान विधियां > MakePay और कनेक्ट MakePay चुनें। मॉड्यूल:

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

MakePay कॉन्फ़िगर करें

कनेक्शन समाप्त होने के बाद, कनेक्शन विधि को डिफ़ॉल्ट कनेक्टेड मोड पर सेट रखें। भुगतान विधि सक्षम करें और समीक्षा करें:

• भुगतान विधि का नाम
• चेकआउट अनुभव
• निपटान मुद्रा
• भुगतान लिंक की समाप्ति
• लंबित, भुगतान, विफल, रद्द, और धनवापसी आदेश की स्थिति

मैनुअल API-कुंजी फ़ॉलबैक के लिए MakePay कंपनी आईडी, API कुंजी आईडी, API कुंजी रहस्य और webhook रहस्य की आवश्यकता होती है।

चेकआउट प्रवाह

जब कोई ग्राहक MakePay चुनता है, तो Magento लंबित भुगतान में ऑर्डर देता है, फिर चयनित MakePay checkout अनुभव खोलता है। होस्ट किया गया रीडायरेक्ट अनुशंसित डिफ़ॉल्ट है; एम्बेडेड checkout एक होस्टेड-लिंक फ़ॉलबैक के साथ एक सुरक्षित MakePay iframe पेज दिखाता है।

भुगतान लिंक पेलोड में शामिल हैं:

फ़ील्ड	उद्देश्य
source=magento	एकीकरण की पहचान करता है
orderId=magento_order_<id>	मानचित्र MakePay गतिविधि वापस Magento पर
incrementId	मानव-पठनीय Magento ऑर्डर संख्या
magentoOrderAdminUrl	आइए MakeCrypto प्रशासकों को वापस Magento ऑर्डर से लिंक करें
moduleVersion	स्थापित MakePay मॉड्यूल संस्करण
magentoVersion	Magento या Adobe Commerce रनटाइम संस्करण

आदेश राज्य

webhook समापन बिंदु /makepay/webhook/index है। यह किसी ऑर्डर को अपडेट करने से पहले X-MakePay-Signature हेडर को सत्यापित करता है।

MakePay स्थिति	Magento स्थिति
paid, completed, confirmed, succeeded	प्रसंस्करण
failed, expired	रद्द
cancelled, canceled	रद्द
refunded	बंद
अन्य स्थितियाँ	लंबित भुगतान

प्रत्येक webhook भुगतान स्थिति, सार्वजनिक MakePay checkout URL, MakeCrypto डैशबोर्ड URL, और उपलब्ध MakePay पहचानकर्ताओं के साथ एक निजी ऑर्डर इतिहास टिप्पणी लिखता है।

सुरक्षा नोट्स

मॉड्यूल Magento एन्क्रिप्टेड कॉन्फ़िगरेशन में कनेक्शन विवरण संग्रहीत करता है। Magento एडमिन एक्सेस को विश्वसनीय ऑपरेटरों तक सीमित रखें, और यदि कोई एडमिन अकाउंट या सर्वर बैकअप सामने आता है तो MakeCrypto में स्टोर को डिस्कनेक्ट कर दें।

कनेक्शन ये अनुमतियाँ मांगता है:

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

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

यदि कनेक्ट MakePay प्रारंभ नहीं हो सकता है, तो पुष्टि करें कि Magento आधार URL HTTPS है और सार्वजनिक रूप से पहुंच योग्य है। यदि checkout रीडायरेक्ट विफल हो जाता है, तो पुष्टि करें कि मॉड्यूल सक्षम है और MakePay के पास या तो सहेजा गया कनेक्शन है या मैन्युअल API-कुंजी फ़ॉलबैक क्रेडेंशियल हैं। यदि ऑर्डर अपडेट नहीं होते हैं, तो MakePay सेटिंग्स में webhook कॉलबैक URL की तुलना Magento /makepay/webhook/index URL से करें और webhook सीक्रेट को घुमाएं।