MakePay ClientExec गेटवे

सिंहावलोकन

आधिकारिक MakePay ClientExec गेटवे होस्ट किए गए क्रिप्टो checkout को ClientExec इनवॉइस में जोड़ता है। ClientExec चालान बनाता है, गेटवे एक MakePay भुगतान लिंक बनाता है, और हस्ताक्षरित कॉलबैक भुगतान निपटान के बाद भुगतान किए गए चालान को चिह्नित करता है।

आवर्ती बिलिंग ClientExec के अंदर रहती है। जब ClientExec प्रत्येक नवीनीकरण चालान बनाता है, तो वही MakePay गेटवे प्रवाह ग्राहक को उस चालान का भुगतान करने देता है।

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

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

• ClientExec 6.8 या नया, ClientExec 7.x सहित
• PHP 7.4 या नया ओपनएसएसएल और कर्ल सक्षम के साथ
• HTTPS ClientExec URL
• ClientExec भुगतान प्रोसेसर तक प्रशासकीय पहुंच
• एक MakePay कंपनी जहां आप भुगतान सेटिंग प्रबंधित कर सकते हैं

गेटवे स्थापित करें

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

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

ज़िप निकालें और makepay फ़ोल्डर को यहां अपलोड करें:

ClientExec/plugins/gateways/makepay

पैकेज इन फ़ाइलों को स्थापित करता है:

plugins/gateways/makepay/PluginMakepay.php
plugins/gateways/makepay/PluginMakepayCallback.php
plugins/gateways/makepay/callback.php
plugins/gateways/makepay/oauth.php
plugins/gateways/makepay/lib/*.php

ClientExec में, सेटिंग्स > प्लगइन्स > भुगतान प्रोसेसर खोलें, MakePay चुनें, और भुगतान प्रोसेसर सेटिंग्स सहेजें।

MakePay कनेक्ट करें

MakePay भुगतान प्रोसेसर सेटिंग्स खोलें और कनेक्ट MakePay URL को अपने ब्राउज़र में कॉपी करें। प्रवेश द्वार:

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

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

कनेक्शन समाप्त होने के बाद, ऑथ मेथड को oauth पर सेट रखें। समीक्षा:

• MakePay कंपनी आईडी
• निपटान संपत्ति
• भुगतान समाप्ति
• Webhook हस्ताक्षर रहस्य
• ग्राहकों को साइनअप नाम दिखाया गया

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

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

जब कोई ग्राहक MakePay के साथ एक अवैतनिक ClientExec चालान का भुगतान करता है, तो गेटवे एक होस्टेड भुगतान लिंक बनाता है और क्लाइंट को MakePay checkout पर रीडायरेक्ट करता है।

फ़ील्ड	उद्देश्य
source=clientexec	एकीकरण की पहचान करता है
orderId=clientexec_invoice_<invoiceId>	मानचित्र MakePay गतिविधि वापस ClientExec पर
invoiceId	ClientExec चालान संख्या
clientId	ClientExec क्लाइंट आईडी जब उपलब्ध हो
moduleVersion	स्थापित MakePay गेटवे संस्करण
clientexecVersion	ClientExec रनटाइम संस्करण जब उपलब्ध हो

भुगतान या रद्दीकरण के बाद खरीदार मूल ClientExec चालान पर वापस लौट आता है।

आवर्ती चालान

ClientExec आवर्ती उत्पादों, नवीनीकरण तिथियों, करों, चालान निर्माण और ग्राहक ईमेल के लिए जिम्मेदार रहता है। MakePay v1 में एक अलग सदस्यता शेड्यूल नहीं बनाता है।

प्रत्येक आवर्ती चालान ClientExec के लिए, MakePay गेटवे एक बार के चालान के समान व्यवहार करता है: यह एक होस्ट किया गया checkout लिंक बनाता है और भुगतान किए गए चालान को चिह्नित करने से पहले हस्ताक्षरित कॉलबैक की प्रतीक्षा करता है।

चालान राज्य

MakePay हस्ताक्षरित कॉलबैक यहां भेजता है:

https://billing.example.com/plugins/gateways/makepay/callback.php

MakePay स्थिति	ClientExec व्यवहार
paid, completed, confirmed, succeeded	ClientExec भुगतान स्वीकृति पर कॉल करता है और लेनदेन आईडी रिकॉर्ड करता है
failed, expired	कॉलबैक लॉग करता है और चालान अवैतनिक छोड़ देता है
cancelled, canceled	कॉलबैक लॉग करता है और चालान अवैतनिक छोड़ देता है
refunded	मैन्युअल समीक्षा के लिए कॉलबैक लॉग करता है
अन्य स्थितियाँ	लॉग इन किया गया और अनदेखा किया गया

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

गेटवे ClientExec इंस्टॉलेशन पर कनेक्शन विवरण संग्रहीत करता है। ClientExec व्यवस्थापक पहुंच को विश्वसनीय ऑपरेटरों तक सीमित रखें, और यदि कोई व्यवस्थापक खाता या सर्वर बैकअप उजागर होता है, तो MakePay डैशबोर्ड से गेटवे को डिस्कनेक्ट करें।

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

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

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

यदि कनेक्ट MakePay प्रारंभ नहीं हो सकता है, तो पुष्टि करें कि ClientExec URL सार्वजनिक HTTPS है और makepay फ़ोल्डर plugins/gateways के अंतर्गत अपलोड किया गया है। यदि क्लाइंट को checkout त्रुटि दिखाई देती है, तो पुष्टि करें कि MakePay कनेक्ट है और चालान का भुगतान नहीं किया गया है। यदि कॉलबैक भुगतान किए गए चालान को चिह्नित नहीं करता है, तो ऊपर दिए गए कॉलबैक URL के साथ MakePay कॉलबैक URL की तुलना करें और गेटवे सेटिंग्स से webhook रहस्य को घुमाएं।