MakePay WHMCS गेटवे

सिंहावलोकन

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

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

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

• WHMCS 8.13 LTS या WHMCS 9.x
• PHP 8.1 या ओपनएसएसएल सक्षम के साथ नया
• HTTPS WHMCS सिस्टम URL
• WHMCS भुगतान गेटवे तक प्रशासक की पहुंच
• एक MakePay कंपनी जहां आप भुगतान सेटिंग प्रबंधित कर सकते हैं

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

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

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

ज़िप निकालें और modules निर्देशिका को WHMCS रूट में अपलोड करें। पैकेज इन फ़ाइलों को स्थापित करता है:

modules/gateways/makepay.php
modules/gateways/makepay/checkout.php
modules/gateways/makepay/oauth.php
modules/gateways/makepay/lib/*.php
modules/gateways/callback/makepay.php

WHMCS में, सिस्टम सेटिंग्स > पेमेंट गेटवे खोलें, MakePay सक्रिय करें, फिर गेटवे सेटिंग्स सहेजें।

MakePay कनेक्ट करें

MakePay गेटवे सेटिंग खोलें और कनेक्ट MakePay चुनें। प्रवेश द्वार:

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

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

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

• MakePay कंपनी आईडी
• निपटान संपत्ति
• भुगतान समाप्ति
• MakePay कनेक्शन स्थिति
• Webhook हस्ताक्षर रहस्य

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

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

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

फ़ील्ड	उद्देश्य
source=whmcs	एकीकरण की पहचान करता है
orderId=whmcs_invoice_<invoiceId>	मानचित्र MakePay गतिविधि वापस WHMCS पर
invoiceId	WHMCS चालान आईडी
clientId	WHMCS क्लाइंट आईडी
moduleVersion	स्थापित MakePay गेटवे संस्करण
whmcsVersion	WHMCS रनटाइम संस्करण

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

चालान राज्य

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

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

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

WHMCS लेनदेन लॉग में MakePay कॉलबैक पेलोड शामिल है ताकि सहायता टीमें भुगतान UID, चालान मेटाडेटा, राशि और स्थिति का पता लगा सकें।

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

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

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

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

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

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