MakePay VirtueMart প্লাগইন

ওভারভিউ

MakePay VirtueMart প্লাগইন VirtueMart ব্যবহার করে এমন জুমলা স্টোরগুলিতে একটি হোস্ট করা ক্রিপ্টো অর্থপ্রদানের পদ্ধতি যোগ করে। গ্রাহকরা checkout এ MakePay বেছে নিন, MakePay checkout পৃষ্ঠায় অর্থ প্রদান করুন এবং VirtueMart অর্ডার রেকর্ড রাখার সময় দোকানে ফিরে যান।

স্বাক্ষরিত অর্থপ্রদানের বিজ্ঞপ্তিগুলি অর্থপ্রদানের পরে VirtueMart অর্ডার আপডেট করে, যাতে স্টোর টিম VirtueMart এর মধ্যে অর্ডারগুলি পরিচালনা করতে পারে৷

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

• VirtueMart ইনস্টল করা জুমলা
• PHP 7.4 বা নতুন ওপেনএসএসএল এবং সিআরএল সক্ষম সহ
• একটি সর্বজনীন HTTPS স্টোরফ্রন্ট URL
• জুমলা এক্সটেনশন ইনস্টলেশন এবং VirtueMart অর্থপ্রদানের পদ্ধতিতে অ্যাক্সেস
• সেটেলমেন্ট এবং ব্র্যান্ডিং কনফিগার করা একটি MakePay কোম্পানি

প্লাগইন ইনস্টল করুন

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

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

জুমলায়, সিস্টেম > এক্সটেনশন খুলুন, ZIP আপলোড করুন, তারপর প্লাগইন ম্যানেজার থেকে VM পেমেন্ট - MakePay ক্রিপ্টো পেমেন্ট গেটওয়ে সক্ষম করুন।

VirtueMart-এ, পেমেন্ট মেথড খুলুন, একটি পেমেন্ট পদ্ধতি তৈরি করুন, MakePay পেমেন্ট প্লাগইন বেছে নিন এবং একবার সেভ করুন যাতে VirtueMart একটি পেমেন্ট পদ্ধতি আইডি অ্যাসাইন করে।

MakePay সংযোগ করুন

অর্থপ্রদানের পদ্ধতিটি সংরক্ষণ করার পরে, স্টোরফ্রন্ট থেকে URL সংযোগটি খুলুন৷ PAYMENT_METHOD_ID VirtueMart পেমেন্ট পদ্ধতি আইডি দিয়ে প্রতিস্থাপন করুন:

https://store.example.com/index.php?option=com_virtuemart&view=pluginresponse&task=pluginnotification&tmpl=component&makepay_oauth=connect&pm=PAYMENT_METHOD_ID

MakePay আপনাকে সাইন ইন করতে, অর্থপ্রদান গ্রহণ করা উচিত এমন কোম্পানি বেছে নিতে এবং সংযোগ অনুমোদন করতে বলে৷ অনুমোদনের পরে, প্লাগইনটি সেই VirtueMart অর্থপ্রদানের পদ্ধতিতে সংযোগ সঞ্চয় করে এবং MakePay কলব্যাক URL কনফিগার করে৷

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

সর্বজনীনভাবে অর্থপ্রদানের পদ্ধতি সক্ষম করার আগে এই ক্ষেত্রগুলি পর্যালোচনা করুন:

সেটিং	উদ্দেশ্য
সংযোগ পদ্ধতি	স্বাভাবিক সেটআপের জন্য Connect MakePay ব্যবহার করুন, অথবা ফলব্যাক হিসাবে ম্যানুয়াল API কী
MakePay কোম্পানির আইডি	সংযোগের পরে পূর্ণ, অথবা ফলব্যাকের জন্য ম্যানুয়ালি প্রবেশ করানো হয়েছে৷
সেটেলমেন্ট মুদ্রা	পছন্দের নিষ্পত্তি সম্পদ, যেমন USDT
পেমেন্টের মেয়াদ শেষ	হোস্ট করা checkout লিঙ্কটি কতক্ষণ পরিশোধযোগ্য থাকে
Webhook গোপন	MakePay অর্থপ্রদানের বিজ্ঞপ্তি যাচাই করতে ব্যবহৃত হয়
অর্ডার স্ট্যাটাস	VirtueMart স্থিতাবস্থা মুলতুবি, অর্থপ্রদান, ব্যর্থ, মেয়াদ উত্তীর্ণ, বাতিল এবং ফেরত প্রদানের জন্য

চেকআউট ফ্লো

যখন একজন ক্রেতা MakePay নির্বাচন করেন, তখন প্লাগইন একটি MakePay পেমেন্ট লিঙ্ক তৈরি করে:

মাঠ	উদ্দেশ্য
source=virtuemart	একীকরণ চিহ্নিত করে
orderId=virtuemart_order_<id>	মানচিত্র MakePay কার্যকলাপ VirtueMart এ ফিরে আসে
orderNumber	VirtueMart অর্ডার নম্বর merchant কে দেখানো হয়েছে
pluginVersion	MakePay প্লাগইন সংস্করণ ইনস্টল করা হয়েছে
virtuemartVersion	VirtueMart রানটাইম সংস্করণ পাওয়া গেলে

ক্রেতাকে হোস্ট করা checkout-এ পুনঃনির্দেশিত করা হয়েছে। MakePay তারপর VirtueMart এর প্লাগইন বিজ্ঞপ্তি শেষ পয়েন্টে একটি স্বাক্ষরিত বিজ্ঞপ্তি পাঠায়।

আদেশ রাষ্ট্র

MakePay অবস্থা	VirtueMart আচরণ
paid, completed, confirmed, succeeded	অর্ডারটিকে কনফিগার করা অর্থপ্রদানের স্থিতিতে নিয়ে যায়
expired	অর্ডারটিকে কনফিগার করা মেয়াদ উত্তীর্ণ অবস্থায় নিয়ে যায়
failed	অর্ডারটিকে কনফিগার করা ব্যর্থ অবস্থায় নিয়ে যায়
cancelled, canceled	অর্ডারটিকে কনফিগার করা বাতিল অবস্থায় নিয়ে যায়
refunded	অর্ডারটিকে কনফিগার করা ফেরত স্থিতিতে নিয়ে যায়
অন্যান্য স্ট্যাটাস	চূড়ান্ত অর্থপ্রদানের অবস্থা না আসা পর্যন্ত উপেক্ষা করা হয়

প্রতিটি আপডেট MakePay লেনদেন, পরিমাণ, সম্পদ, এবং পেমেন্ট URL সহ একটি ব্যক্তিগত অর্ডার মন্তব্য লেখে যখন সেই ক্ষেত্রগুলি উপস্থিত থাকে৷

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

যদি সংযোগ প্রবাহ ব্যবহার করা না যায়, তাহলে সংযোগ পদ্ধতি সেট করুন ম্যানুয়াল API কী ফলব্যাক এবং লিখুন:

• MakePay কোম্পানির আইডি
• API কী আইডি
• API কী গোপনীয়তা
• Webhook গোপন

শুধুমাত্র প্রয়োজনের সময় এটি ব্যবহার করুন এবং জুমলা অ্যাডমিনিস্ট্রেটর অ্যাক্সেস বিশ্বস্ত অপারেটরদের মধ্যে সীমাবদ্ধ রাখুন।

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

checkout শুরু করতে না পারলে, পেমেন্ট পদ্ধতিতে কোম্পানির সংযোগ বা ম্যানুয়াল API-কী সেটিংস আছে কিনা তা নিশ্চিত করুন। যদি সংযোগ URL ব্যর্থ হয়, তাহলে নিশ্চিত করুন যে স্টোরফ্রন্টটি সর্বজনীন HTTPS এবং pm মান সংরক্ষিত MakePay অর্থপ্রদানের পদ্ধতিতে নির্দেশ করে৷

অর্ডার আপডেট না হলে, VirtueMart এর প্লাগইন বিজ্ঞপ্তি URL এর সাথে MakePay কলব্যাক URL তুলনা করুন এবং অর্থপ্রদানের পদ্ধতি সেটিংস থেকে webhook গোপনটি ঘোরান৷