MakePay ClientExec গেটওয়ে

ওভারভিউ

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

পুনরাবৃত্ত বিলিং ClientExec এর মধ্যে থাকে। যখন ClientExec প্রতিটি পুনর্নবীকরণ চালান তৈরি করে, একই MakePay গেটওয়ে ফ্লো ক্লায়েন্টকে সেই চালানটি পরিশোধ করতে দেয়।

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

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

• ClientExec 6.8 বা নতুন, ClientExec 7.x সহ
• PHP 7.4 বা তার চেয়ে নতুন ওপেনএসএসএল এবং সিআরএল সক্ষম
• HTTPS ClientExec URL
• পেমেন্ট প্রসেসরগুলিতে ClientExec অ্যাডমিনিস্ট্রেটর অ্যাক্সেস
• একটি MakePay কোম্পানি যেখানে আপনি পেমেন্ট সেটিংস পরিচালনা করতে পারেন

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

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

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

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