ডিজিটাল বই বিক্রয় প্ল্যাটফর্ম লারাভেল স্ক্রিপ্ট – স্টেডফাস্ট কুরিয়ার সংযোগ অ্যাডঅন

ডিজিটাল বই বিক্রয় প্ল্যাটফর্ম লারাভেল স্ক্রিপ্ট-এর স্টেডফাস্ট কুরিয়ার সংযোগ অ্যাডঅনটি ফিজিক্যাল বইয়ের অর্ডার সরাসরি Steadfast Merchant API-তে পাঠানোর জন্য তৈরি। সফটওয়্যারের Order Page থেকে গ্রাহকের নাম, ফোন, ঠিকানা, Invoice Number, COD Amount ও Order Note ব্যবহার করে Courier Consignment তৈরি করা যায়। API থেকে Consignment ID এবং Tracking Code পাওয়া গেলে সেগুলো Order-এর সঙ্গে সংরক্ষণ করা হয়। অ্যাডঅনটি False Success প্রতিরোধে বিশেষভাবে সতর্ক। শুধু Request পাঠানো বা HTTP Response পাওয়া মানেই Shipment সফল নয়। API Response Status, Success Message এবং বৈধ Consignment ID যাচাই করা হয়। Database-এ Courier Record সফলভাবে Save হওয়ার পরেই Order-কে Courier-এ পাঠানো হয়েছে হিসেবে দেখানো উচিত। API Key/Secret ভুল, Account Unauthorized, Validation Error বা Network Failure হলে সঠিক Error দেখানো হয়। Steadfast Webhook Integration ব্যবহার করে Courier-এর Delivery Status পরিবর্তন Software-এ গ্রহণ করা যায়। Settings Page-এ Webhook Callback URL ও Bearer Auth Token দেখানো হয়। Steadfast থেকে Webhook এলে Token যাচাই করে Consignment/Tracking Data অনুযায়ী Shipment Record এবং Order Status আপডেট করা হয়। এতে Courier Panel বারবার খুলে Status মিলানোর প্রয়োজন কমে। প্রধান ফিচার ও ফাংশন ১. Steadfast API Key সংরক্ষণ করা। ২. Steadfast Secret Key নিরাপদভাবে সংরক্ষণ করা। ৩. Addon Active ও Configured না হলে Courier Action বন্ধ রাখা। ৪. Webhook Callback URL তৈরি করা। ৫. Webhook Bearer Token তৈরি ও দেখানো। ৬. ফিজিক্যাল বইয়ের Order Courier-এ পাঠানো। ৭. Digital-only Order Block করা। ৮. Order Number Invoice হিসেবে পাঠানো। ৯. Customer Name পাঠানো। ১০. Customer Phone পাঠানো। ১১. Customer Full Address পাঠানো। ১২. COD Amount পাঠানো। ১৩. Order Note/Item Description প্রয়োজন অনুযায়ী পাঠানো। ১৪. একই Order দ্বিতীয়বার Steadfast-এ পাঠানো বন্ধ করা। ১৫. Pathao-তে পাঠানো Order আবার Steadfast-এ পাঠানো বন্ধ করা। ১৬. API HTTP Status যাচাই করা। ১৭. API Success Response যাচাই করা। ১৮. বৈধ Consignment ID ছাড়া Success বন্ধ করা। ১৯. Consignment ID সংরক্ষণ করা। ২০. Tracking Code সংরক্ষণ করা। ২১. Courier Status ও Tracking Message সংরক্ষণ করা। ২২. Delivery Charge ও COD Amount প্রয়োজন অনুযায়ী সংরক্ষণ করা। ২৩. API Response Unicode-safe JSON হিসেবে সংরক্ষণ করা। ২৪. বাংলা Customer Name ও Address সঠিকভাবে সংরক্ষণ করা। ২৫. Database Transaction ব্যবহার করে Courier Record ও Order Status আপডেট করা। ২৬. Database Save নিশ্চিত না হলে Shipment Success না দেখানো। ২৭. API Error Message গ্রাহ্য করে পরিষ্কার বাংলা Error দেখানো। ২৮. 401 Unauthorized হলে API Key/Secret সমস্যা নির্দেশ করা। ২৯. Webhook Bearer Token যাচাই করা। ৩০. Webhook Response সংরক্ষণ করা। ৩১. Consignment ID বা Tracking Code দিয়ে Shipment শনাক্ত করা। ৩২. Courier Delivery Status থেকে Software Status Mapping করা। ৩৩. Pending, In Review, Pickup, Transit, Out for Delivery, Delivered, Cancelled ও Return জাতীয় অবস্থা পরিচালনা করা। ৩৪. Delivery সম্পন্ন হলে Order Status আপডেট করা। ৩৫. Cancellation/Return হলে সঠিক Order Status আপডেট করা। ৩৬. Webhook Replay বা Duplicate Update নিরাপদভাবে পরিচালনা করা। ৩৭. Courier Record থেকে Tracking তথ্য দেখানোর ভিত্তি প্রদান করা। ৩৮. Order Page থেকে Courier Shipment Action যোগ করা। অ্যাডমিন কী কী পাবেন API Key ও Secret Key-এর Settings, Webhook URL ও Token, Order Page থেকে Shipment Create, Consignment/Tracking Data এবং Courier Status দেখতে পারবেন। API Error হলে “কাজটি সফল হয়েছে” ধরনের ভুল বার্তা না দেখিয়ে বাস্তব Error পাওয়া যাবে। প্রকাশক বা অপারেশন টিম কী সুবিধা পাবে ফিজিক্যাল বইয়ের Order Steadfast-এ পাঠাতে আলাদা করে Merchant Panel-এ সব তথ্য লিখতে হবে না। Shipment ID, Tracking Code ও Status Software Order-এর সঙ্গে থাকবে। Dynamic Menu/Permission ব্যবস্থায় Addon Active না থাকলে সংশ্লিষ্ট Courier Option দেখানো হবে না। Webhook কীভাবে সাহায্য করবে Steadfast Courier Status পরিবর্তনের পর নির্ধারিত Callback URL-এ Data পাঠালে Software সেটি গ্রহণ করবে। Bearer Token না মিললে Request গ্রহণ করা হবে না। সফল Webhook-এর মাধ্যমে Order Tracking Timeline আপডেট করা যায়। প্রয়োজনীয় কনফিগারেশন Steadfast Merchant Account থেকে API Key ও Secret Key নিতে হবে। Settings Page-এর Webhook URL এবং Bearer Token Steadfast-এর Webhook Configuration-এ বসাতে হবে। Production ব্যবহারের আগে Test Order পাঠিয়ে Consignment, Tracking ও Webhook পরীক্ষা করা উচিত। গুরুত্বপূর্ণ নোট Courier Coverage, Charge, API Policy ও Status Steadfast নিয়ন্ত্রণ করে। অ্যাডঅন শুধু আপনার Merchant Account ও Software-এর মধ্যে সংযোগ তৈরি করে। ভুল Customer Phone/Address বা Account Restriction-এর কারণে API Order Reject হতে পারে। লাইসেন্স তথ্য এই অ্যাডঅনের লাইসেন্স আজীবন। তবে সফটওয়্যারে ব্যবহার করার সময় লাইসেন্স সার্ভার থেকে লাইসেন্সটি সক্রিয় ও বৈধ কি না নিয়মিত যাচাই করা হবে। লাইসেন্স নিষ্ক্রিয়, বাতিল বা ডোমেইনের সঙ্গে মিল না থাকলে অ্যাডঅনের কার্যক্রম বন্ধ থাকবে।