OpenCart एक्सटेंशन

सिंहावलोकन

OpenCart के लिए MakePay व्यापारियों को OpenCart के अंदर भुगतान विवरण एकत्र किए बिना होस्ट किए गए MakePay checkout के माध्यम से क्रिप्टो भुगतान स्वीकार करने देता है। एक्सटेंशन OpenCart भुगतान विधि के रूप में दिखाई देता है, प्रत्येक ऑर्डर के लिए एक MakePay भुगतान लिंक बनाता है, खरीदार को MakePay पर रीडायरेक्ट करता है, और OpenCart ऑर्डर स्थिति को अपडेट करने के लिए हस्ताक्षरित webhooks स्वीकार करता है।

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

• OpenCart 4.x
• PHP 8.0 या नया
• स्टोर फ्रंटएंड पर HTTPS
• MakePay सक्षम एक MakeCrypto कंपनी
• एक MakeCrypto उपयोगकर्ता जो प्राप्तकर्ता कंपनी से जुड़ सकता है
• वैकल्पिक: मैन्युअल API-कुंजी फ़ॉलबैक के लिए एक MakePay API एकीकरण

OpenCart अपने डेटाबेस में एक्सटेंशन सेटिंग्स संग्रहीत करता है। OpenCart एडमिन तक पहुंच विश्वसनीय ऑपरेटरों तक सीमित रखें क्योंकि कनेक्शन विवरण, webhook रहस्य, और वैकल्पिक API-कुंजी फ़ॉलबैक क्रेडेंशियल भुगतान एक्सटेंशन सेटिंग्स में संग्रहीत होते हैं।

MakeCrypto सेट करें

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

1. होम > मर्चेंट > भुगतान सेटिंग खोलें और पुष्टि करें कि MakePay सक्षम है।
2. होम > एकीकरण > API एकीकरण खोलें।
3. पुष्टि करें कि OpenCart को जोड़ने वाला उपयोगकर्ता उसके लिए एकीकरण प्रबंधित कर सकता है कंपनी।
4. वैकल्पिक फ़ॉलबैक: API एकीकरण बनाएं या चुनें, फिर कॉपी करें कंपनी आईडी, API कुंजी आईडी, और API कुंजी रहस्य।

एक्सटेंशन इंस्टॉल करें

अनुशंसित स्रोत आधिकारिक OpenCart मार्केटप्लेस सूची है:

OpenCart एक्सटेंशन एक्सप्लोरर में खोलें

मैन्युअल इंस्टॉलेशन के लिए, सीधे नवीनतम OpenCart पैकेज डाउनलोड करें:

मैनुअल OCMOD ज़िप डाउनलोड करें

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

1. OpenCart एडमिन में, एक्सटेंशन > इंस्टॉलर खोलें।
2. makepay.ocmod.zip अपलोड करें।
3. एक्सटेंशन > एक्सटेंशन खोलें और भुगतान चुनें।
4. MakePay ढूंढें और इंस्टॉल पर क्लिक करें।
5. भुगतान विधि कॉन्फ़िगर करने के लिए संपादित करें खोलें।

पैकेज रूट में install.json, admin/, और catalog/ शामिल हैं, जो OpenCart 4 एक्सटेंशन इंस्टॉलर लेआउट से मेल खाते हैं।

MakePay कनेक्ट करें

एक्सटेंशन > भुगतान > MakePay में, कनेक्ट MakePay का उपयोग करें। विस्तृति:

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

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

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

रीडायरेक्ट यूआरआई का आकार इस प्रकार है:

https://your-store.example/index.php?route=extension/makepay/payment/makepay.oauth

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

एक्सटेंशन > भुगतान > MakePay में, कॉन्फ़िगर करें:

फ़ील्ड	मूल्य
स्थिति	सक्षम
भुगतान विधि का नाम	दुकानदार-सामना करने वाला checkout लेबल
कनेक्शन विधि	MakePay कनेक्ट करें, या मैन्युअल API कुंजी फ़ॉलबैक
MakePay कंपनी आईडी	कनेक्शन के बाद भरा गया, या API-कुंजी फ़ॉलबैक के लिए मैन्युअल रूप से दर्ज किया गया
API कुंजी आईडी	केवल फ़ॉलबैक के लिए API एकीकरण कुंजी आईडी
API कुंजी रहस्य	केवल फ़ॉलबैक के लिए API एकीकरण रहस्य
Webhook रहस्य	कनेक्शन के दौरान सेट करें, या फ़ॉलबैक के लिए मैन्युअल रूप से दर्ज करें
API आधार URL	https://www.makecrypto.io
निपटान मुद्रा	डिफ़ॉल्ट निपटान परिसंपत्ति, उदाहरण के लिए USDT
भुगतान लिंक की समाप्ति	उदाहरण के लिए 12h
चेकआउट अनुभव	होस्टेड रीडायरेक्ट, या एक सुरक्षित आईफ्रेम और होस्टेड-लिंक फ़ॉलबैक के साथ एम्बेडेड checkout

डिफ़ॉल्ट भुगतान विधि का नाम है:

Crypto Payment in USDT, BTC, ETH, LTC, DOGE and others

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

OpenCart MakePay सेटिंग पेज में दिखाए गए webhook URL को कॉपी करें। इसका यह आकार है:

https://your-store.example/index.php?route=extension/makepay/payment/makepay.webhook

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

किसी ऑर्डर को अपडेट करने से पहले एक्सटेंशन X-MakePay-Signature को सत्यापित करता है। हस्ताक्षर टाइमस्टैम्प्ड HMAC प्रारूप का उपयोग करता है:

t=1760000000,v1=<hex-hmac>

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

जब खरीदार MakePay का चयन करता है:

1. OpenCart सक्रिय ऑर्डर और चयनित भुगतान विधि को मान्य करता है।
2. भुगतान लिंक बनाने के लिए एक्सटेंशन MakePay पार्टनर API को कॉल करता है।
3. ऑर्डर को कॉन्फ़िगर की गई लंबित स्थिति में ले जाया गया है।
4. खरीदार चयनित MakePay checkout अनुभव खोलता है।
5. भुगतान स्थिति में बदलाव के बाद हस्ताक्षरित webhook OpenCart ऑर्डर को अपडेट करता है।

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

मेटाडेटा	उद्देश्य
source=opencart	एकीकरण की पहचान करता है
orderId	OpenCart ऑर्डर आईडी
storeId	OpenCart स्टोर आईडी
storeName	स्टोर का नाम
storeUrl	स्टोर फ्रंटएंड URL
opencartOrderId	डैशबोर्ड के लिए OpenCart ऑर्डर आईडी और webhook मिलान
opencartOrderAdminUrl	एडमिन ऑर्डर URL का उपयोग MakeCrypto की ऑर्डर दिखाएं कार्रवाई द्वारा किया जाता है
storeOrderAdminUrl	कनेक्टेड स्टोर्स के लिए जेनेरिक एडमिन ऑर्डर URL फ़ॉलबैक
moduleVersion	MakePay OpenCart एक्सटेंशन संस्करण
opencartVersion	OpenCart रनटाइम संस्करण

आदेश बताता है

एक्सटेंशन सेटिंग्स में स्टेटस मैपिंग कॉन्फ़िगर करें।

MakePay स्थिति	OpenCart स्थिति
paid, completed, confirmed, succeeded	भुगतान स्थिति
failed, expired, chargeback	असफल स्थिति
cancelled, canceled	रद्द स्थिति
refunded	वापसी की स्थिति
कोई भी प्रगतिरत स्थिति	लंबित स्थिति

एक्सटेंशन एक ऑर्डर इतिहास टिप्पणी जोड़ता है जिसमें MakePay स्थिति, भुगतान UID या आईडी, राशि, संपत्ति और webhook पेलोड में मौजूद होने पर होस्ट किए गए checkout URL शामिल होते हैं। प्रारंभिक checkout इतिहास प्रविष्टि में सार्वजनिक भुगतान URL और MakeCrypto डैशबोर्ड भुगतान लिंक भी शामिल है जब API प्रतिक्रिया एक प्रदान करती है।

सुरक्षा नोट

• checkout और webhook URLs के लिए HTTPS का उपयोग करें।
• कनेक्शन विवरण और वैकल्पिक होने के कारण OpenCart व्यवस्थापक पहुंच प्रतिबंधित रखें API क्रेडेंशियल OpenCart सेटिंग्स में संग्रहीत हैं।
• यदि कोई OpenCart व्यवस्थापक खाता है तो MakeCrypto से OpenCart कनेक्टेड ऐप को निरस्त करें समझौता किया गया है.
• यदि मैन्युअल API-कुंजी फ़ॉलबैक क्रेडेंशियल उजागर हो तो MakePay API कुंजी घुमाएँ।
• webhook रहस्य को API कुंजी रहस्य से अलग रखें।
• अप्रत्याशित webhook हस्ताक्षर विफलताओं को क्रेडेंशियल बेमेल या ए के रूप में मानें संभावित धोखाधड़ी का प्रयास.

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

यदि भुगतान विधि दिखाई नहीं दे रही है, तो पुष्टि करें कि MakePay सक्षम है, कार्ट कुल कॉन्फ़िगर न्यूनतम से मेल खाता है, और ग्राहक का पता कॉन्फ़िगर किए गए जियो ज़ोन से मेल खाता है।

यदि कनेक्ट MakePay विफल रहता है, तो पुष्टि करें कि OpenCart स्टोर URL HTTPS है और ब्राउज़र ऊपर दिखाए गए कॉलबैक URL पर वापस आ जाता है।

यदि checkout रीडायरेक्ट नहीं होता है, तो पुष्टि करें कि स्टोर कनेक्ट है। मैन्युअल फ़ॉलबैक के लिए, कंपनी आईडी, API कुंजी आईडी, API कुंजी रहस्य, API आधार URL, और MakePay API एकीकरण अनुमतियों की पुष्टि करें।

यदि भुगतान के बाद ऑर्डर अपडेट नहीं होते हैं, तो पुष्टि करें कि webhook URL HTTPS पर सार्वजनिक रूप से उपलब्ध है और MakePay में webhook रहस्य OpenCart में सहेजे गए रहस्य से मेल खाता है।

यदि OpenCart एक इंस्टॉलर त्रुटि की रिपोर्ट करता है, तो पुष्टि करें कि डाउनलोड की गई फ़ाइल .ocmod.zip के साथ समाप्त होती है और इसमें ज़िप रूट पर install.json, admin/ और catalog/ शामिल हैं।