MakePay Magento মডিউল

ওভারভিউ

অফিসিয়াল MakePay Magento মডিউল Magento ওপেন সোর্স এবং Adobe Commerce 2.4.x স্টোরগুলিতে একটি হোস্ট করা ক্রিপ্টো checkout পদ্ধতি যোগ করে। Magento অর্ডার তৈরি করে, MakePay হোস্ট করা পেমেন্ট লিঙ্ক তৈরি করে, এবং স্বাক্ষরিত webhooks পেমেন্টের স্থিতি পরিবর্তনের পরে অর্ডার আপডেট করে।

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

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

• Magento ওপেন সোর্স বা Adobe Commerce 2.4.x
• PHP 8.1 বা নতুন
• স্টোর > কনফিগারেশন > বিক্রয় > অর্থপ্রদানের পদ্ধতিতে অ্যাডমিন অ্যাক্সেস
• একটি MakePay কোম্পানি যেখানে আপনি পেমেন্ট সেটিংস পরিচালনা করতে পারেন

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

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

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

প্যাকেজটি বের করুন যাতে মডিউলটি এখানে অবস্থিত:

app/code/MakePay/Payment

আপনার Magento রুট থেকে এটি সক্ষম করুন:

bin/magento module:enable MakePay_Payment
bin/magento setup:upgrade
bin/magento cache:clean

MakePay সংযোগ করুন

স্টোর খুলুন > কনফিগারেশন > বিক্রয় > অর্থপ্রদানের পদ্ধতি > MakePay এবং MakePay সংযোগ নির্বাচন করুন। মডিউল:

1. একটি ব্রাউজার ট্যাবে MakeCrypto খোলে।
2. আপনাকে সাইন ইন করতে এবং অর্থপ্রদান গ্রহণ করা উচিত এমন কোম্পানি বেছে নিতে বলে।
3. Magento মডিউল দ্বারা প্রয়োজনীয় অনুমতিগুলি দেখায়৷
4. অনুমোদনের পরে আপনাকে Magento এ ফেরত দেয়।
5. Magento এনক্রিপ্ট করা কনফিগারেশনে স্টোর সংযোগ সংরক্ষণ করে।
6. MakePay webhook কলব্যাক এবং webhook গোপন কনফিগার করে৷

MakePay কনফিগার করুন

সংযোগ শেষ হওয়ার পরে, সংযোগ পদ্ধতি ডিফল্ট সংযুক্ত মোডে সেট রাখুন। পেমেন্ট পদ্ধতি সক্রিয় করুন এবং পর্যালোচনা করুন:

• পেমেন্ট পদ্ধতির নাম
• চেকআউট অভিজ্ঞতা
• সেটেলমেন্ট কারেন্সি
• পেমেন্ট লিঙ্কের মেয়াদ শেষ
• মুলতুবি, অর্থপ্রদান, ব্যর্থ, বাতিল, এবং ফেরত অর্ডার স্থিতি

ম্যানুয়াল API-কী ফলব্যাকের জন্য একটি MakePay কোম্পানি আইডি, API কী ID, API কী গোপন এবং webhook গোপনীয়তা প্রয়োজন৷

চেকআউট ফ্লো

যখন একজন গ্রাহক MakePay চয়ন করেন, Magento মুলতুবি পেমেন্টে অর্ডার দেয়, তারপর নির্বাচিত MakePay checkout অভিজ্ঞতা খোলে। হোস্টেড পুনঃনির্দেশ প্রস্তাবিত ডিফল্ট; এমবেডেড checkout একটি হোস্টেড-লিঙ্ক ফলব্যাক সহ একটি নিরাপদ MakePay iframe পৃষ্ঠা দেখায়৷

পেমেন্ট লিঙ্ক পেলোড অন্তর্ভুক্ত:

মাঠ	উদ্দেশ্য
source=magento	একীকরণ চিহ্নিত করে
orderId=magento_order_<id>	মানচিত্র MakePay কার্যকলাপ Magento এ ফিরে আসে
incrementId	মানুষের পঠনযোগ্য Magento অর্ডার নম্বর
magentoOrderAdminUrl	MakeCrypto অ্যাডমিনিস্ট্রেটরদের Magento অর্ডারে ফিরে যেতে দিন
moduleVersion	MakePay মডিউল সংস্করণ ইনস্টল করা হয়েছে
magentoVersion	Magento বা Adobe Commerce রানটাইম সংস্করণ

আদেশ রাষ্ট্র

webhook শেষ পয়েন্ট হল /makepay/webhook/index। এটি একটি অর্ডার আপডেট করার আগে X-MakePay-Signature হেডার যাচাই করে।

MakePay অবস্থা	Magento অবস্থা
paid, completed, confirmed, succeeded	প্রক্রিয়াকরণ
failed, expired	বাতিল
cancelled, canceled	বাতিল
refunded	বন্ধ
অন্যান্য স্ট্যাটাস	পেমেন্ট বাকি আছে

প্রতিটি webhook পেমেন্ট স্ট্যাটাস, সর্বজনীন MakePay checkout URL, MakeCrypto ড্যাশবোর্ড URL এবং উপলব্ধ MakePay শনাক্তকারীর সাথে একটি ব্যক্তিগত অর্ডার ইতিহাস মন্তব্য লেখে।

নিরাপত্তা নোট

মডিউলটি Magento এনক্রিপ্ট করা কনফিগারেশনে সংযোগের বিবরণ সঞ্চয় করে। Magento অ্যাডমিন অ্যাক্সেস বিশ্বস্ত অপারেটরদের মধ্যে সীমিত রাখুন, এবং যদি কোনও অ্যাডমিন অ্যাকাউন্ট বা সার্ভার ব্যাকআপ উন্মুক্ত হয় তবে MakeCrypto-এ স্টোরটি সংযোগ বিচ্ছিন্ন করুন।

সংযোগটি এই অনুমতিগুলির জন্য জিজ্ঞাসা করে:

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

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

কানেক্ট MakePay শুরু না হলে, Magento বেস URL HTTPS এবং সর্বজনীনভাবে পৌঁছানো যায় কিনা তা নিশ্চিত করুন। checkout পুনঃনির্দেশ ব্যর্থ হলে, নিশ্চিত করুন যে মডিউলটি সক্ষম হয়েছে এবং MakePay এর হয় একটি সংরক্ষিত সংযোগ বা ম্যানুয়াল API-কী ফলব্যাক শংসাপত্র রয়েছে৷ অর্ডার আপডেট না হলে, Magento Magento /makepay/webhook/index URL এর সাথে MakePay কলব্যাক webhook কলব্যাক URL তুলনা করুন এবং webhook গোপনটি ঘোরান৷