ई-कॉमर्स plugins
गेटवे Wix Velo
MakePay Velo प्रदाता फ़ाइलों को Wix में जोड़ता है, होस्ट किए गए checkout लिंक बनाता है, और हस्ताक्षरित webhooks प्राप्त करता है।
सिंहावलोकन
Wix के लिए MakePay Wix Velo के भुगतान प्रदाता सेवा प्लगइन का उपयोग करता है। व्यापारी Wix संपादक में चार MakePay JavaScript फ़ाइलें जोड़ता है, crypto-js इंस्टॉल करता है, सेटिंग्स > भुगतान स्वीकार करें में भुगतान प्रदाता को जोड़ता है, और Wix सीक्रेट मैनेजर में API रहस्य संग्रहीत करता है।
checkout पर, Wix createTransaction() को कॉल करता है। MakePay बैकएंड फ़ाइल एक होस्ट किया गया MakePay भुगतान लिंक बनाती है और URL को Wix पर रीडायरेक्ट कर देती है। जब MakePay भुगतान की पुष्टि करता है, तो हस्ताक्षरित webhook Wix HTTP फ़ंक्शन को कॉल करता है और कोड Wix ऑर्डर पर भुगतान रिकॉर्ड करता है।
आपके शुरू करने से पहले
आपको चाहिये होगा:
- डेवलपर मोड सक्षम के साथ एक Wix स्टोर
- Velo बैकएंड फ़ाइलों और सेवा प्लगइन्स को संपादित करने की अनुमति
- Wix सीक्रेट मैनेजर का उपयोग करने की अनुमति
- MakeCrypto कंपनी MakePay निपटान के साथ कॉन्फ़िगर की गई
- भुगतान-लिंक लेखन पहुंच के साथ एक MakePay API कुंजी
- कंपनी के लिए एक MakePay webhook रहस्य
MakePay क्रेडेंशियल बनाएं
MakeCrypto में:
- उस कंपनी का चयन करें जिसे Wix भुगतान प्राप्त होना चाहिए।
- वॉलेट > बैलेंस खोलें और निपटान कॉन्फ़िगर करें।
- एकीकरण > API एकीकरण खोलें और एक API कुंजी बनाएं।
- कम से कम चाबी दो:
makepay:payment-links:readmakepay:payment-links:write
- कंपनी आईडी, API कुंजी आईडी और API कुंजी रहस्य की प्रतिलिपि बनाएँ।
- व्यापारी > भुगतान सेटिंग खोलें और webhook रहस्य को घुमाएँ या कॉपी करें।
API कुंजी रहस्य और webhook रहस्य Wix रहस्य प्रबंधक में जोड़े जाते हैं, फ्रंटएंड कोड में नहीं।
Wix Velo फ़ाइलें जोड़ें
MakePay Wix स्रोत भंडार खोलें:
https://github.com/makecryptoio/makepay-wix
इस मोनोरेपो में apps/plugins/wix के अंतर्गत वही स्रोत बनाए रखा गया है।
Wix में:
- साइट संपादक खोलें और डेव मोड सक्षम करें।
- सार्वजनिक और बैकएंड > बैकएंड के अंतर्गत, बनाएं:
MakePay.jshttp-functions.js
- सेवा प्लगइन्स के अंतर्गत, भुगतान नामक प्लगइन बनाएं
MakePayPayment. - प्रतिलिपि:
MakePayPayment-config.jsMakePayPayment.js
- पैकेज और ऐप्स से
crypto-jsnpm पैकेज इंस्टॉल करें। - साइट प्रकाशित करें.
Wix रहस्य जोड़ें
डेवलपर टूल्स > सीक्रेट्स मैनेजर खोलें और जोड़ें:
| गुप्त नाम | मूल्य |
|---|---|
makepay_api_key_secret | MakePay API कुंजी रहस्य |
makepay_webhook_secret | MakePay webhook रहस्य |
इन मानों को पेज कोड या सार्वजनिक फ्रंटएंड फ़ाइलों में पेस्ट न करें।
MakePay को Wix में कनेक्ट करें
Wix डैशबोर्ड में सेटिंग्स > भुगतान स्वीकार करें खोलें और कस्टम MakePay भुगतान प्रदाता को कनेक्ट करें।
प्रवेश करना:
| फ़ील्ड | मूल्य |
|---|---|
| MakePay कंपनी आईडी | MakeCrypto कंपनी आईडी |
| MakePay API कुंजी आईडी | MakePay API कुंजी आईडी |
| निपटान मुद्रा | आमतौर पर USDT |
checkout भुगतान विधि का शीर्षक है:
Crypto Payment in USDT, BTC, ETH, LTC, DOGE and others
webhooks कॉन्फ़िगर करें
Wix HTTP फ़ंक्शन समापन बिंदु है:
https://your-wix-domain.com/_functions/makepay_notify
MakeCrypto में, व्यापारी > भुगतान सेटिंग खोलें और MakePay कॉलबैक URL को उस समापन बिंदु पर सेट करें। Wix सीक्रेट मैनेजर में webhook रहस्य MakePay webhook रहस्य से मेल खाना चाहिए।
Wix webhook हैंडलर किसी भी ऑर्डर को भुगतान के रूप में चिह्नित करने से पहले X-MakePay-Signature हेडर को सत्यापित करता है।
परीक्षण checkout
- अपने Wix कार्ट में कम मूल्य वाला उत्पाद जोड़ें।
- checkout पर जाएँ।
- MakePay क्रिप्टो भुगतान विधि चुनें।
- ऑर्डर दें और भुगतान करें पर क्लिक करें।
- पुष्टि करें कि Wix होस्ट किए गए MakePay checkout पर रीडायरेक्ट करता है।
- एक परीक्षण भुगतान पूरा करें.
- पुष्टि करें कि webhook प्राप्त होने के बाद Wix ऑर्डर को भुगतान के रूप में चिह्नित किया गया है।
- यदि ऑर्डर सही है तो MakeCrypto में एकीकरण > Webhook अनुरोध जांचें अद्यतन नहीं.
सुरक्षा नोट
Wix एकीकरण API-कुंजी प्रमाणीकरण का उपयोग करता है क्योंकि व्यापारी द्वारा कॉपी की गई Velo भुगतान प्रदाता फ़ाइलें अभी तक स्वचालित कनेक्ट MakePay प्रवाह का समर्थन नहीं करती हैं।
ये नियम रखें:
- रहस्यों को केवल Wix रहस्य प्रबंधक में संग्रहित करें।
- MakePay-विशिष्ट API कुंजी का उपयोग करें, व्यापक आंतरिक कुंजी का नहीं।
- वॉलेट-भेजें या API-कुंजी-प्रबंधन क्षेत्र प्रदान न करें।
- यदि किसी के पास पुराने Wix संपादक की पहुंच है तो API कुंजी और webhook रहस्य को घुमाएं अब भुगतान का प्रबंधन नहीं करना चाहिए.
- कॉलबैक URL HTTPS और सार्वजनिक रखें।
समस्या निवारण
यदि प्रदाता भुगतान स्वीकार करें में दिखाई नहीं देता है, तो पुष्टि करें कि सेवा प्लगइन का नाम MakePayPayment है, दो प्लगइन फ़ाइलें मौजूद हैं, और कोड जोड़ने के बाद साइट प्रकाशित हो गई है।
यदि कनेक्ट विफल रहता है, तो पुष्टि करें कि Wix सीक्रेट मैनेजर में makepay_api_key_secret मौजूद है और API कुंजी आईडी/कंपनी आईडी उसी MakeCrypto कंपनी से मेल खाती है।
यदि checkout रीडायरेक्ट नहीं करता है, तो createTransaction त्रुटि के लिए Wix Velo लॉग का निरीक्षण करें और पुष्टि करें कि API कुंजी में makepay:payment-links:write है।
यदि ऑर्डर अपडेट नहीं होते हैं, तो पुष्टि करें कि MakeCrypto कॉलबैक URL https://your-wix-domain.com/_functions/makepay_notify है, webhook गुप्त मिलान करता है, और MakeCrypto webhook डिलीवरी लॉग 2xx प्रतिक्रिया दिखाते हैं।