BTCPAY SERVER প্লাগইন
তোমার BTCPay চেকআউটে স্টেবলকয়েন।
USDC, USDT ও স্টোরে গ্রহণযোগ্য অন্য অ্যাসেটের জন্য Wholly Crypto যোগ করো। বর্তমান BTCPay Bitcoin ও Lightning পদ্ধতি রেখো।
প্লাগইন নাও
v1.0.1BTCPay Server 2.4.4+ এবং আলাদা Wholly Crypto ইনস্টলেশন। BTCPay 2.4.4-এ পরীক্ষিত; নতুন ভার্সন নিজের স্থাপনায় পরীক্ষা করো।
MIT লাইসেন্স · স্বাধীন কানেক্টর, BTCPay-এর অনুমোদন বা ডিরেক্টরি তালিকা নয়।
তোমার চেকআউট, আরও পছন্দ
- হোস্টেড চেকআউট বা ঐচ্ছিক এমবেডেড iframe
- Wholly স্টোরের গ্রহণযোগ্য নেটওয়ার্ক ও অ্যাসেট থেকে বেছে নাও
- স্বাক্ষরিত IPN ও অথেন্টিকেটেড API পরীক্ষা
- সার্চযোগ্য যুক্ত পেমেন্ট ও সংযোগের ডায়াগনস্টিক
পেমেন্ট তোমার Wholly প্রজেক্ট ওয়ালেটে যায়। কানেক্টরের ওয়ালেট কী লাগে না। Wholly প্রসেসিং ক্রেডিটের নিয়ম প্রযোজ্য; প্লাগইন কোনো শতাংশ ফি যোগ করে না।
ইনস্টল করো
- ডাউনলোড করো
BTCPayServer.Plugins.WhollyCrypto.btcpayএবং রিলিজের এই ফাইলের সঙ্গে মিলিয়ে দেখোSHA256SUMS। প্লাগইন ফাইল ব্যবহার করো, GitHub-এর সোর্স ZIP নয়। - BTCPay অ্যাডমিন হিসেবে খোলো Manage Plugins → Upload Plugin, ফাইল আপলোড করে BTCPay রিস্টার্ট করো।
- স্টোর বেছে নাও → Plugins → Wholly Crypto। শুধু ইনস্টল করলেই স্টোর যুক্ত হয় না।
আপডেটেও একই আপলোড প্রক্রিয়া। Wholly মার্চেন্ট সফটওয়্যার আপডেট করলে BTCPay প্লাগইন আপডেট হয় না।
স্টোর যুক্ত করো
- Wholly-তে গ্রহণযোগ্য পদ্ধতি, ব্যাকআপ রাখা ওয়ালেট, রেট ও কনফার্মেশনসহ সক্রিয় প্রজেক্ট/স্টোর তৈরি করো। বর্তমান মার্চেন্ট ইনস্টলেশন ব্যবহার করো; এই কানেক্টর 6.4.5 API-র জন্য তৈরি।
- প্রজেক্ট/স্টোর UUID কপি করো এখানে থেকে স্টোর → মৌলিক → API ID। প্রজেক্ট-সীমিত পড়া/লেখার API ক্রেডেনশিয়াল বানাও। চালু করো স্টোর → IPN এবং তার সাইনিং সিক্রেট কপি করো, ওয়েবহুক সিক্রেট নয়।
- BTCPay-এর Wholly সেটিংসে সেই মানগুলোসহ API ও চেকআউট origin দাও, যেমন
https://api.example.comএবংhttps://pay.example.com। 443 পোর্টে পাবলিক HTTPS ব্যবহার করো; পাথ নয়। - চালু করো চেকআউটে Wholly Crypto দেখাও, সেভ করো, তারপর পড়ার অ্যাক্সেস পরীক্ষা। চাইলে স্টোরের গ্রহণযোগ্য পদ্ধতির একটি অংশ বেছে নাও।
দুই ফায়ারওয়ালেই Wholly সার্ভার থেকে BTCPay-তে HTTPS কলব্যাক যেতে দাও। প্লাগইন কলব্যাক URL দেয়। সেই রুটে ব্রাউজার লগইন, CAPTCHA ও Basic Auth রেখো না; স্বাক্ষর পরীক্ষা চালু থাকতে হবে।
এমবেডেড চেকআউট
পুরো পৃষ্ঠার চেকআউট ডিফল্ট, মোবাইল ওয়ালেট অ্যাপে বিশেষ কাজে লাগে। iframe-এর জন্য:
- Wholly-র স্টোর → উন্নত-এ চালু করো এমবেডেড চেকআউট অনুমোদন। তোমার সঠিক BTCPay HTTPS origin যোগ করো অনুমোদিত HTTPS origin-এ, পাথ বা ওয়াইল্ডকার্ড ছাড়া।
- BTCPay প্লাগইনের সেটিংসে বেছে নাও গ্রাহকের চেকআউট → এমবেডেড চেকআউট (iframe) ও সেভ করো।
- নতুন ইনভয়েস পরীক্ষা করো। আগের ইনভয়েস তার মূল প্রদর্শন মোড রাখে। পুরো চেকআউট খোলো একই ইনভয়েসের জন্য থাকে, ফ্রেম লোড না হলে।
ব্রাউজারের বার্তা ও ফেরার লিংক নেভিগেশনের জন্য, কখনো পেমেন্টের প্রমাণ নয়।
পেমেন্টের ধাপ পরীক্ষা করো
টেস্ট স্টোরে প্রচলিত মুদ্রায় ছোট, ধনাত্মক ইনভয়েস বানাও। বেছে নাও স্টেবলকয়েন ও ক্রিপ্টো · Wholly। কনফার্মেশন পর্যন্ত চেকআউট, স্বাক্ষরিত IPN ও API যাচাই পরীক্ষা করো। শুধু BTCPay-এর সেটেল হওয়া ইনভয়েস থেকে অর্ডার সম্পন্ন করো, প্রতি অর্ডারে একবার।
পড়ার অ্যাক্সেস পরীক্ষা ইনভয়েস তৈরি বা IPN পরীক্ষা করে না। ব্যবহার করো সংযোগ এবং যুক্ত পেমেন্ট নিরাপদ ত্রুটি, অর্ডার রেফারেন্স ও পেমেন্ট পরীক্ষার জন্য।
সীমা ও ডেলিভারি সমস্যা
শুধু নির্দিষ্ট ধনাত্মক প্রচলিত-মুদ্রার ইনভয়েস: সর্বোচ্চ আট দশমিক, শুরু করার সময় ৫ মিনিট থেকে ২৪ ঘণ্টা মেয়াদ বাকি থাকতে হবে। ক্রিপ্টো-মূল্যের বা টপ-আপ ইনভয়েস, মিশ্র পদ্ধতিতে অর্ডার সম্পন্ন ও রিফান্ড এই কানেক্টরের বাইরে। দেরি বা অস্পষ্ট পেমেন্ট পর্যালোচনা লাগে।
এই ক্ষেত্রে ডেলিভারি ব্যর্থ, Wholly-তে স্টোর → IPN → ইতিহাস → বিস্তারিত দেখো। নেটওয়ার্ক অ্যাক্সেস ও সাইনিং সিক্রেট পরীক্ষা করো। অনিশ্চিত ফল এড়াতে আরেক ইনভয়েস বানিও না।
গ্রাহক পেমেন্ট দিতে পারলেও কম প্রসেসিং ক্রেডিটে IPN থামতে পারে। ক্রেডিট ও প্রোভাইডার সচল রাখো। ক্রেডিটের নিয়ম → · IPN গাইড →