ई-कॉमर्स plugins
VirtueMart प्लगइन
Joomla स्टोर्स पर checkout द्वारा होस्ट किए गए MakePay के लिए आधिकारिक VirtueMart प्लगइन इंस्टॉल और कॉन्फ़िगर करें।
MakePay VirtueMart प्लगइन
सिंहावलोकन
MakePay VirtueMart प्लगइन Joomla स्टोर्स में एक होस्टेड क्रिप्टो भुगतान विधि जोड़ता है जो VirtueMart का उपयोग करते हैं। ग्राहक checkout पर MakePay चुनते हैं, MakePay checkout पेज पर भुगतान करते हैं, और स्टोर पर लौटते हैं जबकि VirtueMart ऑर्डर रिकॉर्ड रखता है।
हस्ताक्षरित भुगतान सूचनाएं भुगतान के बाद VirtueMart ऑर्डर को अपडेट करती हैं, ताकि स्टोर टीम VirtueMart के अंदर ऑर्डर प्रबंधित करना जारी रख सके।
आपके शुरू करने से पहले
- Joomla VirtueMart के साथ स्थापित है
- PHP 7.4 या नया ओपनएसएसएल और कर्ल सक्षम के साथ
- एक सार्वजनिक HTTPS स्टोरफ्रंट URL
- Joomla एक्सटेंशन इंस्टॉलेशन और VirtueMart भुगतान विधियों तक पहुंच
- निपटान और ब्रांडिंग के साथ एक MakePay कंपनी कॉन्फ़िगर की गई
प्लगइन इंस्टॉल करें
नवीनतम ज़िप डाउनलोड करें:
https://plugins.makecrypto.io/downloads/virtuemart/latest.zip
Joomla में, सिस्टम > एक्सटेंशन खोलें, ज़िप अपलोड करें, फिर प्लगइन मैनेजर से VM पेमेंट - MakePay क्रिप्टो पेमेंट गेटवे सक्षम करें।
VirtueMart में, भुगतान विधियां खोलें, एक भुगतान विधि बनाएं, MakePay भुगतान प्लगइन चुनें, और इसे एक बार सेव करें ताकि VirtueMart एक भुगतान विधि आईडी निर्दिष्ट कर सके।
MakePay कनेक्ट करें
भुगतान विधि सहेजे जाने के बाद, स्टोरफ्रंट से कनेक्शन URL खोलें। PAYMENT_METHOD_ID को VirtueMart भुगतान विधि आईडी से बदलें:
https://store.example.com/index.php?option=com_virtuemart&view=pluginresponse&task=pluginnotification&tmpl=component&makepay_oauth=connect&pm=PAYMENT_METHOD_ID
MakePay आपसे साइन इन करने, भुगतान प्राप्त करने वाली कंपनी चुनने और कनेक्शन स्वीकृत करने के लिए कहता है। अनुमोदन के बाद, प्लगइन उस VirtueMart भुगतान विधि पर कनेक्शन संग्रहीत करता है और MakePay कॉलबैक URL को कॉन्फ़िगर करता है।
गेटवे सेटिंग्स
भुगतान विधि को सार्वजनिक रूप से सक्षम करने से पहले इन फ़ील्ड की समीक्षा करें:
| सेटिंग | उद्देश्य |
|---|---|
| कनेक्शन विधि | सामान्य सेटअप के लिए कनेक्ट MakePay का उपयोग करें, या फ़ॉलबैक के रूप में मैन्युअल API कुंजियों का उपयोग करें |
| MakePay कंपनी आईडी | कनेक्शन के बाद भरा गया, या फ़ॉलबैक के लिए मैन्युअल रूप से दर्ज किया गया |
| निपटान मुद्रा | पसंदीदा निपटान संपत्ति, जैसे USDT |
| भुगतान समाप्ति | होस्ट किया गया checkout लिंक कितने समय तक देय रहेगा |
| Webhook रहस्य | MakePay भुगतान सूचनाओं को सत्यापित करने के लिए उपयोग किया जाता है |
| ऑर्डर की स्थिति | VirtueMart लंबित, भुगतान, विफल, समाप्त, रद्द और रिफंड भुगतान की स्थिति |
चेकआउट प्रवाह
जब कोई खरीदार MakePay का चयन करता है, तो प्लगइन एक MakePay भुगतान लिंक बनाता है:
| फ़ील्ड | उद्देश्य |
|---|---|
source=virtuemart | एकीकरण की पहचान करता है |
orderId=virtuemart_order_<id> | मानचित्र MakePay गतिविधि वापस VirtueMart पर |
orderNumber | VirtueMart ऑर्डर नंबर व्यापारी को दिखाया गया |
pluginVersion | स्थापित MakePay प्लगइन संस्करण |
virtuemartVersion | VirtueMart रनटाइम संस्करण जब उपलब्ध हो |
खरीदार को होस्ट किए गए checkout पर पुनर्निर्देशित किया गया है। MakePay फिर VirtueMart के प्लगइन अधिसूचना समापन बिंदु पर एक हस्ताक्षरित अधिसूचना भेजता है।
आदेश राज्य
| MakePay स्थिति | VirtueMart व्यवहार |
|---|---|
paid, completed, confirmed, succeeded | ऑर्डर को कॉन्फ़िगर की गई भुगतान स्थिति में ले जाता है |
expired | ऑर्डर को कॉन्फ़िगर की गई समाप्त स्थिति में ले जाता है |
failed | ऑर्डर को कॉन्फ़िगर की गई विफल स्थिति में ले जाता है |
cancelled, canceled | ऑर्डर को कॉन्फ़िगर की गई रद्द स्थिति में ले जाता है |
refunded | ऑर्डर को कॉन्फ़िगर की गई रिफंड स्थिति में ले जाता है |
| अन्य स्थितियाँ | अंतिम भुगतान स्थिति आने तक नजरअंदाज कर दिया जाता है |
प्रत्येक अद्यतन MakePay लेनदेन, राशि, संपत्ति और भुगतान URL के साथ एक निजी ऑर्डर टिप्पणी लिखता है जब वे फ़ील्ड मौजूद होते हैं।
मैनुअल API-कुंजी फ़ॉलबैक
यदि कनेक्शन प्रवाह का उपयोग नहीं किया जा सकता है, तो कनेक्शन विधि को मैन्युअल API कुंजी फ़ॉलबैक पर सेट करें और दर्ज करें:
- MakePay कंपनी आईडी
- API कुंजी आईडी
- API कुंजी रहस्य
- Webhook रहस्य
इसका उपयोग केवल जरूरत पड़ने पर ही करें और Joomla व्यवस्थापक पहुंच को विश्वसनीय ऑपरेटरों तक ही सीमित रखें।
समस्या निवारण
यदि checkout प्रारंभ नहीं हो सकता है, तो पुष्टि करें कि भुगतान विधि में कंपनी कनेक्शन या मैन्युअल API-कुंजी सेटिंग्स हैं। यदि कनेक्शन URL विफल हो जाता है, तो पुष्टि करें कि स्टोरफ्रंट सार्वजनिक HTTPS है और pm मान सहेजे गए MakePay भुगतान विधि की ओर इशारा करता है।
यदि ऑर्डर अपडेट नहीं होते हैं, तो MakePay कॉलबैक URL की तुलना VirtueMart के प्लगइन नोटिफिकेशन URL से करें और भुगतान विधि सेटिंग्स से webhook रहस्य को घुमाएं।