OpenCart এক্সটেনশন

ওভারভিউ

OpenCart-এর জন্য MakePay ব্যবসায়ীদের OpenCart-এর মধ্যে অর্থপ্রদানের বিবরণ সংগ্রহ না করে হোস্ট করা MakePay checkout এর মাধ্যমে ক্রিপ্টো পেমেন্ট গ্রহণ করতে দেয়। এক্সটেনশনটি একটি OpenCart অর্থপ্রদানের পদ্ধতি হিসাবে উপস্থিত হয়, প্রতিটি অর্ডারের জন্য একটি MakePay অর্থপ্রদানের লিঙ্ক তৈরি করে, ক্রেতাকে MakePay-এ পুনঃনির্দেশ করে এবং OpenCart অর্ডার স্থিতি আপডেট করতে স্বাক্ষরিত webhooks গ্রহণ করে৷

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

• OpenCart 4.x
• PHP 8.0 বা নতুন
• স্টোর ফ্রন্টএন্ডে HTTPS
• MakePay সক্ষম সহ একটি MakeCrypto কোম্পানি৷
• একজন MakeCrypto ব্যবহারকারী যিনি গ্রহণকারী কোম্পানির সাথে সংযোগ করতে পারেন
• ঐচ্ছিক: ম্যানুয়াল API-কী ফলব্যাকের জন্য একটি MakePay API ইন্টিগ্রেশন

OpenCart এর ডাটাবেসে এক্সটেনশন সেটিংস সঞ্চয় করে। OpenCart অ্যাডমিনের অ্যাক্সেস বিশ্বস্ত অপারেটরদের মধ্যে সীমাবদ্ধ রাখুন কারণ সংযোগের বিশদ বিবরণ, webhook গোপনীয়তা এবং ঐচ্ছিক API-কী ফলব্যাক শংসাপত্রগুলি পেমেন্ট এক্সটেনশন সেটিংসে সংরক্ষণ করা হয়৷

MakeCrypto সেট আপ করুন

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

1. হোম > মার্চেন্ট > পেমেন্ট সেটিংস খুলুন এবং নিশ্চিত করুন MakePay সক্ষম আছে।
2. হোম > ইন্টিগ্রেশনস > API ইন্টিগ্রেশন খুলুন।
3. OpenCart সংযোগকারী ব্যবহারকারী এটির জন্য একীকরণ পরিচালনা করতে পারে তা নিশ্চিত করুন৷ কোম্পানি
4. ঐচ্ছিক ফলব্যাক: একটি API ইন্টিগ্রেশন তৈরি করুন বা নির্বাচন করুন, তারপর অনুলিপি করুন কোম্পানির আইডি, API কী আইডি, এবং API কী গোপন৷

এক্সটেনশন ইনস্টল করুন

প্রস্তাবিত উত্স হল অফিসিয়াল OpenCart মার্কেটপ্লেস তালিকা:

OpenCart এক্সটেনশন এক্সপ্লোরারে খুলুন

ম্যানুয়াল ইনস্টলেশনের জন্য, সরাসরি সর্বশেষ OpenCart প্যাকেজ ডাউনলোড করুন:

ম্যানুয়াল OCMOD ZIP ডাউনলোড করুন

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

1. OpenCart অ্যাডমিনে, এক্সটেনশন > ইনস্টলার খুলুন।
2. makepay.ocmod.zip আপলোড করুন।
3. এক্সটেনশন > এক্সটেনশন খুলুন এবং পেমেন্ট বেছে নিন।
4. MakePay খুঁজুন এবং ইনস্টল ক্লিক করুন।
5. পেমেন্ট পদ্ধতি কনফিগার করতে সম্পাদনা খুলুন।

প্যাকেজ রুটে install.json, admin/, এবং catalog/ রয়েছে, যা OpenCart 4 এক্সটেনশন ইনস্টলার লেআউটের সাথে মিলে যায়।

MakePay সংযোগ করুন

এক্সটেনশন > পেমেন্ট > MakePay-এ, MakePay কানেক্ট করুন। এক্সটেনশন:

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

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

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

রিডাইরেক্ট ইউআরআই-এর এই আকৃতি রয়েছে:

https://your-store.example/index.php?route=extension/makepay/payment/makepay.oauth

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

এক্সটেনশন> পেমেন্ট> MakePay, কনফিগার করুন:

মাঠ	মান
স্ট্যাটাস	সক্রিয়
অর্থপ্রদান পদ্ধতির নাম	ক্রেতা-মুখী checkout লেবেল
সংযোগ পদ্ধতি	MakePay, অথবা ম্যানুয়াল API কী ফলব্যাক সংযোগ করুন
MakePay কোম্পানির আইডি	সংযোগের পরে পূর্ণ, বা API-কী ফলব্যাকের জন্য ম্যানুয়ালি প্রবেশ করানো হয়েছে৷
API কী আইডি	শুধুমাত্র ফলব্যাকের জন্য API ইন্টিগ্রেশন কী আইডি
API কী গোপনীয়তা	শুধুমাত্র ফলব্যাকের জন্য API ইন্টিগ্রেশন সিক্রেট
Webhook গোপন	সংযোগের সময় সেট করুন, অথবা ফলব্যাকের জন্য ম্যানুয়ালি প্রবেশ করুন
API বেস URL	https://www.makecrypto.io
সেটেলমেন্ট মুদ্রা	ডিফল্ট নিষ্পত্তি সম্পদ, উদাহরণস্বরূপ USDT
পেমেন্ট লিঙ্কের মেয়াদ শেষ	যেমন 12h
চেকআউট অভিজ্ঞতা	হোস্ট করা পুনঃনির্দেশ, অথবা একটি নিরাপদ iframe এবং হোস্টেড-লিঙ্ক ফলব্যাক সহ এম্বেড করা checkout

ডিফল্ট অর্থপ্রদান পদ্ধতির নাম হল:

Crypto Payment in USDT, BTC, ETH, LTC, DOGE and others

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

OpenCart MakePay সেটিংস পৃষ্ঠায় দেখানো webhook URL অনুলিপি করুন। এটির এই আকৃতি রয়েছে:

https://your-store.example/index.php?route=extension/makepay/payment/makepay.webhook

MakePay Connect স্বয়ংক্রিয়ভাবে এই কলব্যাক কনফিগার করে। ম্যানুয়াল API-কী ফলব্যাকের জন্য, এটি MakePay webhook সেটিংসে webhook গোপন OpenCart এ প্রবেশ করান।

কোনো অর্ডার আপডেট করার আগে এক্সটেনশনটি X-MakePay-Signature যাচাই করে। স্বাক্ষরটি টাইমস্ট্যাম্পযুক্ত HMAC ফর্ম্যাট ব্যবহার করে:

t=1760000000,v1=<hex-hmac>

চেকআউট প্রবাহ

যখন ক্রেতা MakePay নির্বাচন করে:

1. OpenCart সক্রিয় অর্ডার এবং নির্বাচিত অর্থপ্রদানের পদ্ধতি যাচাই করে।
2. এক্সটেনশনটি একটি পেমেন্ট লিঙ্ক তৈরি করতে MakePay অংশীদার API কে কল করে৷
3. অর্ডারটি কনফিগার করা মুলতুবি অবস্থায় সরানো হয়েছে।
4. ক্রেতা নির্বাচিত MakePay checkout অভিজ্ঞতা খোলে।
5. একটি স্বাক্ষরিত webhook অর্থপ্রদানের স্থিতি পরিবর্তনের পরে OpenCart অর্ডার আপডেট করে।

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

মেটাডেটা	উদ্দেশ্য
source=opencart	একীকরণ চিহ্নিত করে
orderId	OpenCart অর্ডার আইডি
storeId	OpenCart স্টোর আইডি
storeName	দোকানের নাম
storeUrl	স্টোর ফ্রন্টএন্ড URL
opencartOrderId	ড্যাশবোর্ড এবং webhook মিলের জন্য OpenCart অর্ডার আইডি
opencartOrderAdminUrl	অ্যাডমিন অর্ডার MakeCrypto এর অর্ডার দেখান অ্যাকশন দ্বারা ব্যবহৃত URL
storeOrderAdminUrl	সংযুক্ত দোকানের জন্য জেনেরিক অ্যাডমিন অর্ডার URL ফলব্যাক
moduleVersion	MakePay OpenCart এক্সটেনশন সংস্করণ
opencartVersion	OpenCart রানটাইম সংস্করণ

!

আদেশ রাষ্ট্র

এক্সটেনশন সেটিংসে স্ট্যাটাস ম্যাপিং কনফিগার করুন।

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

এক্সটেনশন MakePay স্ট্যাটাস, পেমেন্ট UID বা ID, পরিমাণ, সম্পদ এবং checkout URL পেলোডে উপস্থিত থাকাকালীন হোস্ট করা checkout সমন্বিত একটি অর্ডার ইতিহাস মন্তব্য যোগ করে। প্রাথমিক checkout ইতিহাস এন্ট্রিতে পাবলিক পেমেন্ট URL এবং MakeCrypto ড্যাশবোর্ড পেমেন্ট লিঙ্ক অন্তর্ভুক্ত থাকে যখন API প্রতিক্রিয়া একটি প্রদান করে।

পরে সম্পূর্ণ চিহ্নিত

!

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

• checkout এবং webhook URL-এর জন্য HTTPS ব্যবহার করুন।
• OpenCart অ্যাডমিন অ্যাক্সেস সীমাবদ্ধ রাখুন কারণ সংযোগের বিবরণ এবং ঐচ্ছিক৷ API শংসাপত্রগুলি OpenCart সেটিংসে সংরক্ষণ করা হয়৷
• OpenCart অ্যাডমিন অ্যাকাউন্ট থাকলে MakeCrypto থেকে OpenCart সংযুক্ত অ্যাপ প্রত্যাহার করুন আপস করা হয়
• MakePay API কী ঘোরান যদি ম্যানুয়াল API-কী ফলব্যাক শংসাপত্রগুলি উন্মুক্ত হয়।
• webhook গোপন রাখুন API কী গোপন থেকে আলাদা।
• অপ্রত্যাশিত webhook স্বাক্ষর ব্যর্থতাকে শংসাপত্রের অমিল বা একটি হিসাবে বিবেচনা করুন সম্ভাব্য স্পুফিং প্রচেষ্টা।

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

অর্থপ্রদানের পদ্ধতিটি দৃশ্যমান না হলে, নিশ্চিত করুন MakePay সক্ষম করা হয়েছে, কার্ট মোট কনফিগার করা সর্বনিম্ন পূরণ করে এবং গ্রাহকের ঠিকানা কনফিগার করা জিও জোনের সাথে মেলে।

কানেক্ট MakePay ব্যর্থ হলে, OpenCart স্টোর URL HTTPS এবং ব্রাউজার উপরে দেখানো কলব্যাকে URL ফিরে আসে।

checkout পুনঃনির্দেশ না করলে, নিশ্চিত করুন যে দোকানটি সংযুক্ত আছে। ম্যানুয়াল ফলব্যাকের জন্য, কোম্পানির আইডি, API কী আইডি, API কী সিক্রেট, API বেস URL এবং MakePay API ইন্টিগ্রেশন অনুমতিগুলি নিশ্চিত করুন৷

পেমেন্টের পর অর্ডার আপডেট না হলে, নিশ্চিত করুন যে webhook URL HTTPS-এর মাধ্যমে সর্বজনীনভাবে পৌঁছানো যায় এবং MakePay-এ MakePay-এর গোপনীয়তা OpenCart-এ সংরক্ষিত গোপনীয়তার সাথে মিলে যায়।

যদি OpenCart একটি ইনস্টলার ত্রুটি রিপোর্ট করে, ডাউনলোড করা ফাইলটি .ocmod.zip দিয়ে শেষ হয়েছে এবং ZIP রুটে install.json, admin/, এবং catalog/ রয়েছে তা নিশ্চিত করুন৷