আপনার যা দরকার
| ফিল্ড | এটি যা করে |
|---|---|
| API key ID | আপনার MakePay API key চিহ্নিত করে যাতে আমরা সঠিক অ্যাকাউন্ট কল করি। গোপন। |
| API key secret | আমাদের আপনার অ্যাকাউন্টে MakePay চেকআউট তৈরি করতে দেয়। গোপন। |
| Webhook secret | নিশ্চিত করে যে একটি ওয়েবহুক সত্যিই MakePay থেকে এসেছে। গোপন। |
| Success URL | একটি সম্পন্ন পেমেন্টের পর ক্রেতা কোথায় পৌঁছান। |
| Failure URL | পেমেন্ট ব্যর্থ বা বাতিল হলে ক্রেতা কোথায় পৌঁছান। |
MakePay API key ID ও secret একসাথে ইস্যু করে যখন আপনি একটি কি তৈরি করেন; ওয়েবহুক secret আপনার কলব্যাক সেটিং থেকে একটি আলাদা মান।
প্রতিটি ফিল্ড আমরা কেন চাই
API key ID
কোন MakePay কি দিয়ে প্রমাণীকরণ করতে হবে তা নাম দেয়। নিজে থেকে গোপন নয়, কিন্তু নিচের secret-এর সাথে যুক্ত।
API key secret
চেকআউট তৈরির অনুমোদন দেয়, তাই পেমেন্ট আপনার MakePay অ্যাকাউন্টের মধ্য দিয়ে চলে আর আপনার ওয়ালেটে জমা হয়। MakePay এটি একবার দেখায়, ঠিক কি তৈরির পর।
Webhook secret
প্রমাণ করে যে একটি আগত ওয়েবহুক প্রকৃতপক্ষে MakePay থেকে, তাই কেউ একটি "paid" ইভেন্ট জাল করতে পারে না। এটি API key থেকে একটি আলাদা মান।
Success and Failure URL
সাধারণ সেটিং: অর্থ দেওয়ার বা ব্যর্থ বা বাতিল পেমেন্টের পর ক্রেতা কোথায় পৌঁছান। গোপন নয়।
সেট আপ
- MakePay-তে একটি API key তৈরি করুন
MakePay-তে সাইন ইন করুন আর API & SDK → API integrations খুলুন। API keys-এর অধীনে, Generate API Key ক্লিক করুন, এটির একটি নাম দিন যেমন "Coin Moebius", আর তৈরি করুন। MakePay API key ID ও এর secret একবার দেখায়, ঠিক তৈরির পর — দুটোই এখনই কপি করুন, কারণ secret আবার দেখা যাবে না।
MakePay → API & SDK → API integrations → Generate API Key API key secret-কে পাসওয়ার্ডের মতো রাখুন। হারিয়ে গেলে, পুরনো কি খুঁজে পাওয়ার চেয়ে একটি নতুন কি তৈরি করুন।
- আপনার Coin Moebius প্রজেক্ট আইডি খুঁজুন
একটি আলাদা ট্যাবে, Coin Moebius ড্যাশবোর্ডে আপনার প্রজেক্ট খুলুন আর প্রজেক্টের নামের নিচে প্রজেক্ট আইডি কপি করুন। আপনার MakePay কলব্যাক URL সেই আইডি নিচের ঠিকানায় বসিয়ে — আপনি পরবর্তী ধাপে এটি MakePay-তে পেস্ট করবেন।
https://api.coinmoebius.com/webhook/makepay/<your project id>Coin Moebius → আপনার প্রজেক্ট → Project ID কানেক্টেড প্রোভাইডার কার্ড (শেষ ধাপ) একই URL দেখাবে, তাই আপনি যেকোনো সময় আবার কপি করতে পারবেন।
- কলব্যাক URL নির্ধারণ করুন ও ওয়েবহুক secret কপি করুন
MakePay-তে ফিরুন, Delivery → Callback URL configuration-এ স্ক্রল করুন। Edit Callback URL ক্লিক করুন, আপনার Coin Moebius ওয়েবহুক URL সক্রিয় গন্তব্য হিসেবে পেস্ট করুন, আর সংরক্ষণ করুন। তারপর, Webhook signing-এর অধীনে, signing secret কপি করুন (যদি কোনো মান না থাকে তো Regenerate secret ব্যবহার করুন) — এটিই Coin Moebius যা Webhook secret-এর জন্য চায়।
MakePay → Delivery → Callback URL configuration MakePay প্রতিটি মার্চেন্ট-দৃশ্যমান স্ট্যাটাস পরিবর্তনের পর এই ঠিকানায় ডেলিভারি আপডেট পোস্ট করে। signing secret API key থেকে আলাদা — আপনার দুটোই দরকার।
- Coin Moebius ড্যাশবোর্ডে যুক্ত করুন
Coin Moebius-তে, Providers → Add provider → MakePay খুলুন। আপনার API key ID, API key secret, আর Webhook secret পেস্ট করুন, তারপর Success URL ও Failure URL নির্ধারণ করুন (অর্থ দেওয়ার বা ব্যর্থ পেমেন্টের পর ক্রেতারা কোথায় পৌঁছাবেন)। Save ক্লিক করুন।
Coin Moebius → Add provider → MakePay সংরক্ষিত secret লুকানো থাকে। পরে একটি পরিবর্তন করতে, Replace বেছে নিন ও নতুন মান পেস্ট করুন।
- আপনি সংযুক্ত
MakePay এখন আপনার Providers ট্যাবে সংযুক্ত হওয়ার তারিখ ও এটি যে ওয়েবহুক URL আশা করে তা সহ দেখাবে। এখনো না করলে, সেই URL MakePay-এর কলব্যাক সেটিংয়ে পেস্ট করুন। Edit ব্যবহার করে কি রোটেট করুন বা Disconnect দিয়ে সরান, আর Test mode টগল দিয়ে আসল সংখ্যা না ছুঁয়ে একটি অর্ডার চালান।
Coin Moebius → Providers → MakePay (সংযুক্ত)
যুক্ত করার পর
লাইভ যাওয়ার আগে একটি অর্ডার চালান:
- সংযুক্ত MakePay কার্ডে Test mode টগল চালু করুন যাতে আপনি আসল সংখ্যা না ছুঁয়ে একটি অর্ডার চালাতে পারেন।
- একটি পণ্য তৈরি করুন আর আপনার প্রজেক্টের দিকে নির্দেশিত একটি পৃষ্ঠায় (একটি লোকাল HTML ফাইল চলে) বাই বাটন রাখুন।
- MakePay-এর মাধ্যমে চেকআউট সম্পন্ন করুন।
- Transactions ট্যাব খুলুন। নতুন সারির স্ট্যাটাস succeeded-এ পৌঁছালে, আপনার কি ও ওয়েবহুক দুটোই শুরু থেকে শেষ পর্যন্ত কাজ করছে।
আসল পেমেন্টের জন্য প্রস্তুত হলে Test mode বন্ধ করুন।
সমস্যা সমাধান
ড্যাশবোর্ডে শুরু করুন: নিশ্চিত করুন MakePay কার্ড সংযুক্ত দেখাচ্ছে আর ওয়েবহুক URL MakePay-তে সংরক্ষিত কলব্যাক গন্তব্যের সাথে মেলছে।
পেমেন্ট সম্পন্ন হয় কিন্তু অর্ডার মুলতবি থাকে।
ওয়েবহুক আসছে না বা যাচাই হচ্ছে না। নিশ্চিত করুন MakePay-এর কলব্যাক URL আপনার প্রজেক্টের ওয়েবহুক URL-এর সাথে ঠিক মেলছে, আর Coin Moebius-এর Webhook secret MakePay-এর signing secret-এর সাথে মেলছে।
প্রোভাইডার সংরক্ষণ প্রত্যাখ্যাত হয়।
API key ID, API key secret, ও Webhook secret সবই প্রয়োজনীয়। MakePay থেকে আবার কপি করুন — secret শুধু একবার দেখা যায়, তাই হারিয়ে গেলে পুরনো একটি বদলে নতুন কি তৈরি করুন।
একটি টেস্ট অর্ডার Transactions-এ কখনো দেখা দেয় না।
বাই বাটন চালানোর আগে MakePay কার্ডের Test mode টগল চালু করুন, আর নিশ্চিত করুন পণ্য একই প্রজেক্ট দিকে নির্দেশিত।
জেনে রাখা ভালো
নন-কাস্টোডিয়াল. MakePay ক্রিপ্টো সরাসরি আপনার নিজের ওয়ালেটে জমা করে। Coin Moebius কখনো তহবিল রাখে না ও সেগুলো সরাতে পারে না।
সিক্রেট রোটেট করা. যেকোনো সময় একটি নতুন API key বা ওয়েবহুক signing secret তৈরি করুন, তারপর ড্যাশবোর্ডে Replace বেছে নিয়ে নতুন মান পেস্ট করুন। সম্পাদনায় সিক্রেট ফিল্ড খালি থাকে।
প্রশ্ন আছে? Join our Discord