PrestaShop মডিউল

ওভারভিউ

PrestaShop-এর জন্য MakePay হোস্ট করা MakePay checkout এর মাধ্যমে ব্যবসায়ীদের ক্রিপ্টো পেমেন্ট গ্রহণ করতে দেয়। গ্রাহকরা PrestaShop checkout সময় MakePay অর্থপ্রদানের পদ্ধতি বেছে নেয়, অর্থপ্রদানের জন্য MakePay-এ পুনঃনির্দেশিত হয় এবং অর্থপ্রদানের পরে দোকানে ফিরে আসে।

মডিউলটি প্রতিটি PrestaShop অর্ডারের জন্য একটি MakePay অর্থপ্রদানের লিঙ্ক তৈরি করে এবং স্বাক্ষরিত MakePay webhooks এর জন্য শোনে তাই অর্ডারের অবস্থার পরিবর্তন স্বয়ংক্রিয়ভাবে ঘটে।

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

আপনার প্রয়োজন হবে:

• PrestaShop 8.0 বা নতুন, PrestaShop 9.x সহ
• PHP 7.4 বা OpenSSL সক্ষম সহ নতুন
• একটি HTTPS ব্যাক অফিস এবং checkout URL
• একটি PrestaShop কর্মচারী অ্যাকাউন্ট যা মডিউল কনফিগার করতে পারে
• MakePay সেটেলমেন্ট কনফিগার করা একটি MakeCrypto কোম্পানি

PHP সোডিয়াম সুপারিশ করা হয়। এটি উপলব্ধ হলে, মডিউলটি সংযোগের বিশদ বিবরণ, webhook গোপনীয়তা এবং ম্যানুয়াল API-কী ফলব্যাক শংসাপত্রগুলি এনক্রিপ্ট করতে PrestaShop কুকি গোপনীয়তার সাথে এটি ব্যবহার করে৷

MakeCrypto সেট আপ করুন

PrestaShop সংযোগ করার আগে merchant সেটআপ সম্পূর্ণ করুন।

1. https://www.makecrypto.io এ সাইন ইন করুন এবং নির্বাচন করুন যে কোম্পানির PrestaShop পেমেন্ট পাওয়া উচিত।
2. ওয়ালেট > ব্যালেন্স খুলুন, তারপর সেটেলমেন্ট কারেন্সি, চেইন এবং কনফিগার করুন গন্তব্য মানিব্যাগ।
3. মার্চেন্ট > পেমেন্ট সেটিংস খুলুন এবং পেমেন্ট ফি পর্যালোচনা করুন এবং রিডাইরেক্ট করুন আচরণ
4. ঐচ্ছিক: merchant ব্র্যান্ডিং, সমর্থন যোগ করতে সেটিংস > মার্চেন্ট খুলুন ইমেল, checkout রং, হোস্ট করা পেমেন্ট থিম এবং কাস্টম ডোমেন।

আপনাকে ম্যানুয়ালি ডেভেলপার অ্যাপ্লিকেশন তৈরি করতে হবে না। অফিসিয়াল PrestaShop মডিউল একটি স্টোর-নির্দিষ্ট সংযোগ তৈরি করে যখন আপনি Connect MakePay ক্লিক করেন।

মডিউল ইনস্টল করুন

সর্বশেষ অফিসিয়াল মডিউল ZIP ডাউনলোড করুন:

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

তারপর এটি PrestaShop এ ইনস্টল করুন:

1. ব্যাক অফিস> মডিউল> মডিউল ম্যানেজার খুলুন।
2. একটি মডিউল আপলোড করুন ক্লিক করুন এবং ডাউনলোড করা makepay.zip চয়ন করুন৷
3. ইনস্টলেশনের পর, কনফিগার এ ক্লিক করুন।
4. প্রমাণিকরণ ডিফল্ট সংযুক্ত মোডে সেট রাখুন।

ZIP রুট হল makepay/ এবং প্রধান মডিউল ফাইল হল makepay.php, PrestaShop মডিউল প্যাকেজিং প্রত্যাশার সাথে মিলে যায়।

!

আপনার দোকান সংযোগ করুন

স্বাভাবিক সেটআপের জন্য কানেক্ট MakePay ব্যবহার করুন। এটি এই PrestaShop স্টোরটিকে আপনার বেছে নেওয়া MakeCrypto কোম্পানির সাথে লিঙ্ক করে এবং স্টোর কোড পরিবর্তন না করে পরে সংযোগ বিচ্ছিন্ন করা যেতে পারে।

1. MakePay মডিউল কনফিগারেশনে, MakePay API বেস URL সেট রাখুন https://www.makecrypto.io.
2. কানেক্ট MakePay এ ক্লিক করুন।
3. MakeCrypto এ সাইন ইন করুন যদি অনুরোধ করা হয়, আপনি যে কোম্পানিটি প্রস্তুত করেছেন সেটি বেছে নিন এবং অনুরোধ করা অ্যাক্সেস অনুমোদন করুন।
4. PrestaShop এ ফিরে আসার পরে, নিশ্চিত করুন যে মডিউলটি স্টোরটিকে হিসাবে দেখায়৷ সংযুক্ত
5. গেটওয়ে সেটিংস সংরক্ষণ করুন এবং মডিউল সক্রিয় রাখুন।

সংযোগের সময়, মডিউলটি স্বয়ংক্রিয়ভাবে সর্বজনীন webhook URL নিবন্ধন করে:

https://your-store.example/module/makepay/webhook

সর্বজনীন ইন্টারনেট থেকে এই এন্ডপয়েন্টটি পৌঁছানো যায়। নিরাপত্তা মডিউল, ফায়ারওয়াল, এবং ক্যাশিং নিয়ম সেই URL-এ স্বাক্ষরিত POST অনুরোধের অনুমতি দেওয়া উচিত।

সংযোগ কিভাবে কাজ করে

Connect MakePay বোতামটি একটি ব্রাউজার ট্যাবে MakeCrypto খোলে। আপনি সাইন ইন করুন, পেমেন্ট গ্রহণ করা উচিত এমন কোম্পানি বেছে নিন, অনুরোধ করা অ্যাক্সেস পর্যালোচনা করুন এবং অনুমোদনের পরে PrestaShop-এ ফিরে যান। মডিউলটি তারপর সংযোগ সংরক্ষণ করে, webhook URL নিবন্ধন করে এবং মাল্টিস্টোর ইনস্টলে প্রতিটি দোকানের প্রেক্ষাপটের জন্য আলাদা আলাদা সেটিংস রাখে।

PrestaShop এর জন্য কোনো শেয়ার করা অ্যাপ সিক্রেট বা ডেভেলপার অ্যাপ সেটআপের প্রয়োজন নেই।

গেটওয়ে সেটিংস

মডিউল > মডিউল ম্যানেজার > MakePay > কনফিগার-এ এই সেটিংস পর্যালোচনা করুন।

সেটিং	এটা কি করে
সক্ষম	checkout-এ MakePay অর্থপ্রদানের পদ্ধতি চালু বা বন্ধ করে।
প্রমাণিকরণ	সাধারণ ইনস্টলেশনের জন্য ডিফল্ট সংযুক্ত মোড ব্যবহার করুন। ম্যানুয়াল API কী ফলব্যাক সমর্থন-নেতৃত্ব পুনরুদ্ধারের জন্য।
পেমেন্ট পদ্ধতির নাম	নামটি গ্রাহকরা checkout-এ দেখেন, উদাহরণস্বরূপ Crypto Payment in USDT, BTC, ETH, LTC, DOGE and others৷
চেকআউট অভিজ্ঞতা	সবচেয়ে নির্ভরযোগ্য প্রবাহের জন্য হোস্টেড রিডাইরেক্ট ব্যবহার করুন অথবা হোস্ট করা লিঙ্কের ফলব্যাক সহ একটি নিরাপদ iframe পৃষ্ঠাতে MakePay দেখানোর জন্য এম্বেড করা checkout পৃষ্ঠা ব্যবহার করুন।
** সেটেলমেন্ট কারেন্সি**	পছন্দের MakePay সম্পদ যেমন USDT। MakePay যেখানে সম্ভব কোম্পানি সেটিংস থেকে চেইন সমাধান করে।
পেমেন্টের মেয়াদ শেষ	checkout আজীবন হোস্ট করা হয়েছে, উদাহরণস্বরূপ 30m, 2h, বা 12h।
MakePay API বেস URL	উৎপাদনের জন্য https://www.makecrypto.io ব্যবহার করুন।
কোম্পানি আইডি / API কী আইডি / API কী গোপন	শুধুমাত্র ম্যানুয়াল API-কী ফলব্যাকের জন্য প্রয়োজন।
Webhook গোপন	সংযোগের সময় স্বয়ংক্রিয়ভাবে সেট করুন। শুধুমাত্র ফলব্যাক মোডের জন্য ম্যানুয়ালি প্রবেশ করুন।

আদেশ রাষ্ট্র

checkout-এ, মডিউলটি কাস্টম অপেক্ষারত MakePay পেমেন্ট অবস্থায় একটি PrestaShop অর্ডার তৈরি করে এবং নির্বাচিত MakePay checkout অভিজ্ঞতা খুলে দেয়।

Webhook স্থিতি ম্যাপিং:

MakePay অবস্থা	PrestaShop অবস্থা
paid, completed, confirmed, succeeded	পেমেন্ট গৃহীত
refunded, refund	ফেরত দেওয়া হয়েছে
failed, expired, chargeback	পেমেন্ট ত্রুটি
cancelled, canceled	বাতিল
অন্যান্য চলমান অবস্থা	MakePay অর্থপ্রদানের অপেক্ষায়

মডিউলটি webhook স্ট্যাটাস, পেমেন্ট UID, অর্থপ্রদানের পরিমাণ, সম্পদ, এবং MakePay webhook পেলোডে থাকাকালীন অর্থপ্রদান URL সহ ব্যক্তিগত অর্ডার বার্তা লেখে।

![PrestaShop checkout অর্ডার দেওয়ার আগে MakePay বেছে নেওয়া ক্রিপ্টো পেমেন্ট পদ্ধতি হিসেবে দেখাচ্ছে।](/images/documentation/apps/prestashop/screenshot-2.png

!

!

!

নিরাপত্তা এবং অনুমতি

PrestaShop সংযোগের অনুরোধ:

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

এটি ওয়ালেট তহবিল পাঠাতে পারে না বা লিগ্যাসি API কী তৈরি করতে পারে না।

Webhook আপডেটগুলি MakePay দ্বারা স্বাক্ষরিত হয় এবং যেকোনো PrestaShop অর্ডারের অবস্থা পরিবর্তনের আগে যাচাই করা হয়। স্টোর অ্যাডমিনিস্ট্রেটররা MakeCrypto-এ ইন্টিগ্রেশন > সংযুক্ত অ্যাপস-এর অধীনে সংযোগ প্রত্যাহার করতে পারেন, অথবা PrestaShop মডিউল কনফিগারেশন পৃষ্ঠা থেকে সংযোগ বিচ্ছিন্ন করতে পারেন।

ম্যানুয়াল API-কী ফলব্যাক

ম্যানুয়াল API-কী মোড ব্যবহার করুন শুধুমাত্র যদি Connect MakePay অনুপলব্ধ থাকে বা MakeCrypto সমর্থন আপনাকে এটি ব্যবহার করতে বলে।

1. MakeCrypto-এ, ইন্টিগ্রেশন > API ইন্টিগ্রেশন খুলুন।
2. একই কোম্পানির জন্য একটি MakePay API কী তৈরি করুন বা চয়ন করুন যেটি স্টোর গ্রহণ করে পেমেন্ট
3. কোম্পানির আইডি, API কী আইডি, API কী সিক্রেট এবং webhook গোপনীয়তা কপি করুন।
4. PrestaShop-এ, মডিউল > মডিউল ম্যানেজার > MakePay > কনফিগার খুলুন।
5. প্রমাণিকরণকে ম্যানুয়াল API কী ফলব্যাক এ সেট করুন।
6. শংসাপত্রগুলি পেস্ট করুন এবং সংরক্ষণ করুন।

থিম ফাইল, ক্লায়েন্ট-সাইড স্ক্রিপ্ট এবং পাবলিক সাপোর্ট টিকিটের বাইরে API মূল গোপনীয়তা রাখুন। কানেক্ট MakePay এখনও সাধারণ স্টোর অপারেশনের জন্য পছন্দের।

সমস্যা সমাধান

কানেক্ট MakePay ব্যর্থ হলে, নিশ্চিত করুন যে আপনার ব্যাক অফিস URL HTTPS ব্যবহার করে, আপনার স্টোর https://www.makecrypto.io-এ আউটবাউন্ড HTTPS অনুরোধ করতে পারে এবং কর্মচারী অ্যাকাউন্ট মডিউল কনফিগার করতে পারে।

যদি অর্থপ্রদানের পদ্ধতি checkout-এ উপস্থিত না হয়, তাহলে নিশ্চিত করুন যে মডিউলটি সক্রিয় আছে, সক্ষম চালু আছে এবং স্টোরটি MakePay-এর সাথে সংযুক্ত বা বৈধ ম্যানুয়াল API-কী শংসাপত্র রয়েছে৷

যদি checkout একটি নিষ্পত্তি বা অনবোর্ডিং ত্রুটি দেখায়, MakeCrypto এ ফিরে যান এবং স্টোরের সাথে সংযুক্ত কোম্পানির জন্য ওয়ালেট > ব্যালেন্স > সেট আপ সেটেলমেন্ট সম্পূর্ণ করুন।

পেমেন্টের পরেও অর্ডার আপডেট না হলে, ডেলিভারির চেষ্টার জন্য MakeCrypto-এ ইন্টিগ্রেশন > Webhook রিকোয়েস্ট দেখুন। PrestaShop webhook এন্ডপয়েন্ট একটি 2xx প্রতিক্রিয়া প্রদান করবে। এছাড়াও পরীক্ষা করুন যে হোস্টিং ফায়ারওয়ালগুলি /module/makepay/webhook-এ POST অনুরোধগুলিকে ব্লক করছে না।

আপনি যদি স্টোর ডোমেন, ব্যাক অফিস ডোমেন পরিবর্তন করেন বা দোকানটিকে একটি নতুন পরিবেশে নিয়ে যান, তাহলে সংযোগ বিচ্ছিন্ন করুন এবং MakePay পুনরায় সংযোগ করুন যাতে সংযোগ কলব্যাক এবং webhook URL বর্তমান স্টোরের সাথে মেলে৷