MakePay WHMCS গেটওয়ে

ওভারভিউ

অফিসিয়াল MakePay WHMCS গেটওয়ে WHMCS ইনভয়েসে হোস্ট করা ক্রিপ্টো checkout যোগ করে। WHMCS ইনভয়েসে একটি পেমেন্ট বোতাম রেন্ডার করে, MakePay হোস্ট করা পেমেন্ট লিঙ্ক তৈরি করে, এবং সাইনড কলব্যাক পেমেন্ট সেটেল হওয়ার পর পেমেন্ট করা ইনভয়েসটিকে চিহ্নিত করে।

স্বাভাবিক সেটআপের জন্য কানেক্ট MakePay ব্যবহার করুন। ম্যানুয়াল API-কী শংসাপত্রগুলি একটি ফলব্যাক হিসাবে উপলব্ধ থাকে৷

আপনি শুরু করার আগে

• WHMCS 8.13 LTS বা WHMCS 9.x
• PHP 8.1 বা OpenSSL সক্ষম সহ নতুন
• HTTPS WHMCS সিস্টেম URL
• পেমেন্ট গেটওয়েতে WHMCS অ্যাডমিনিস্ট্রেটর অ্যাক্সেস
• একটি MakePay কোম্পানি যেখানে আপনি পেমেন্ট সেটিংস পরিচালনা করতে পারেন

গেটওয়ে ইনস্টল করুন

সর্বশেষ ZIP প্যাকেজ ডাউনলোড করুন:

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

ZIP বের করুন এবং WHMCS রুটে modules ডিরেক্টরি আপলোড করুন। প্যাকেজ এই ফাইলগুলি ইনস্টল করে:

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 Connect নির্বাচন করুন। প্রবেশদ্বার:

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 কোম্পানি আইডি সংরক্ষণ করা হয়েছে। কলব্যাকগুলি যদি প্রদত্ত ইনভয়েসগুলিকে চিহ্নিত না করে, তাহলে MakePay কলব্যাক WHMCS কলব্যাক URL এর সাথে তুলনা করুন এবং গেটওয়ে সেটিংস থেকে webhook গোপনটি ঘোরান৷