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

ডিজিটাল বই বিক্রয় প্ল্যাটফর্ম লারাভেল স্ক্রিপ্ট-এর পাঠাও কুরিয়ার সংযোগ অ্যাডঅনটি ফিজিক্যাল বইয়ের অর্ডার সরাসরি Pathao Courier Merchant API-তে পাঠানোর জন্য তৈরি। Order Page থেকে Manual Data Entry না করে গ্রাহকের নাম, ফোন, পূর্ণ ঠিকানা, Cash on Delivery Amount, Order Number, Item Description, Weight ও Special Instruction ব্যবহার করে Courier Consignment তৈরি করা যায়। অ্যাডমিন Sandbox এবং Live—দুই পরিবেশ আলাদাভাবে নির্বাচন করতে পারেন। Client ID, Client Secret, Merchant Email, Merchant Password ও Store ID ব্যবহার করে API Authentication করা হয়। সংবেদনশীল Secret ও Password সাধারণ Database Settings-এ প্রকাশ না করে Laravel Private Storage-এ নিরাপদভাবে সংরক্ষণ করার নকশা রয়েছে। “API সংযোগ পরীক্ষা করুন” ব্যবহার করলে Pathao Store List আনা হয় এবং সংরক্ষিত Store ID সেই Merchant Account-এ আছে কি না যাচাই করা হয়। শুধু HTTP Response সফল হলেই Success দেখানো হয় না; নির্বাচিত Store বাস্তবে পাওয়া না গেলে পরিষ্কার Error দেখানো হয়। অর্ডার পাঠানোর সময় শুধুমাত্র ফিজিক্যাল বা ফিজিক্যাল-যুক্ত অর্ডার গ্রহণ করা হয়। Digital-only Order কুরিয়ারে পাঠানো যায় না। একই Order আগে Pathao বা Steadfast-এ পাঠানো থাকলে Duplicate Shipment বন্ধ করা হয়। API থেকে সফল Response Code এবং বৈধ Consignment ID না পাওয়া পর্যন্ত স্থানীয়ভাবে Order-কে Shipped করা হয় না। API Success-এর পর Courier Record Database-এ Save হয়েছে কি না আবার যাচাই করা হয়। প্রধান ফিচার ও ফাংশন ১. Pathao Sandbox Environment সমর্থন। ২. Pathao Live/Production Environment সমর্থন। ৩. Client ID সংরক্ষণ করা। ৪. Client Secret নিরাপদভাবে সংরক্ষণ করা। ৫. Merchant Email ও Password ব্যবহার করা। ৬. Merchant Store ID নির্ধারণ করা। ৭. Normal Delivery Type নির্বাচন করা। ৮. On Demand Delivery Type নির্বাচন করা। ৯. Parcel বা Document Item Type নির্বাচন করা। ১০. Default Weight ০.৫ থেকে ১০ কেজি নির্ধারণ করা। ১১. Default Special Instruction সংরক্ষণ করা। ১২. API Credentials Private Storage-এ রাখা। ১৩. OAuth Access Token সংগ্রহ ও API Request-এ ব্যবহার করা। ১৪. Store List এনে Connection Test করা। ১৫. নির্বাচিত Store ID Account-এ আছে কি না যাচাই করা। ১৬. Customer Full Address থেকে Pathao Area Auto-Mapping সহায়তা। ১৭. City/Zone/Area ID বাধ্যতামূলকভাবে হাতে পাঠানো না করা। ১৮. গ্রাহকের নাম, Phone ও Address দিয়ে Shipment তৈরি করা। ১৯. Merchant Order ID হিসেবে Software Order Number ব্যবহার করা। ২০. COD Amount পাঠানো। ২১. Item Description ও Quantity পাঠানো। ২২. Physical Order ছাড়া অন্য Order Block করা। ২৩. একই Order দুইবার Pathao-তে পাঠানো বন্ধ করা। ২৪. Steadfast-এ পাঠানো Order আবার Pathao-তে পাঠানো বন্ধ করা। ২৫. API HTTP Status ও Response Code যাচাই করা। ২৬. বৈধ Consignment ID ছাড়া Success না দেখানো। ২৭. Consignment ID, Merchant Order ID, Status ও Delivery Fee সংরক্ষণ করা। ২৮. API Response Unicode-safe JSON হিসেবে সংরক্ষণ করা। ২৯. Courier Record নিশ্চিত হওয়ার পর Order Status আপডেট করা। ৩০. API ব্যর্থ হলে False Success বন্ধ করা। ৩১. Pathao Consignment Status Refresh করা। ৩২. Last Status Response সংরক্ষণ করা। ৩৩. Pathao Status-কে Software Order Status-এ Mapping করা। ৩৪. Delivered, Out for Delivery, Transit, Pickup, Hold, Cancel ও Return অবস্থা পরিচালনা করা। ৩৫. 401/403 হলে Credentials/Account Error-এর পরিষ্কার বাংলা বার্তা দেখানো। ৩৬. Network ও API Exception Handle করা। অ্যাডমিন কী কী পাবেন একটি সম্পূর্ণ Pathao Settings Page, Environment Selection, Credential Form, Store ID, Delivery Type, Item Type, Weight, Instruction এবং Connection Test পাবেন। Order Page থেকে Shipment Create ও Status Refresh করা যাবে। প্রকাশক বা অপারেশন টিম কী সুবিধা পাবে সফটওয়্যারের অর্ডারের তথ্য আবার Pathao Panel-এ লিখতে হবে না। Consignment ID ও Courier Status Order-এর সঙ্গে সংরক্ষিত থাকবে। একই Order ভুল করে দুই Courier-এ পাঠানো থেকে সিস্টেম বাধা দেবে। ঠিকানা ব্যবস্থাপনা গ্রাহকের পূর্ণ Address-এ রাস্তা, এলাকা/থানা/উপজেলা ও জেলা পরিষ্কারভাবে থাকতে হবে। অ্যাডঅন Pathao-কে পূর্ণ Address পাঠায়, যাতে Pathao নিজস্ব Address Mapping ব্যবহার করতে পারে। অসম্পূর্ণ বা অস্পষ্ট Address হলে API Order Reject করতে পারে। প্রয়োজনীয় কনফিগারেশন Pathao Merchant Account, API Client ID/Secret, Merchant Email/Password ও সঠিক Store ID প্রয়োজন। প্রথমে Sandbox-এ Test করা এবং Connection Test-এ Store পাওয়া নিশ্চিত করার পর Live Environment ব্যবহার করা উচিত। গুরুত্বপূর্ণ নোট Courier Charge, Coverage, Status Name ও API Policy Pathao পরিবর্তন করতে পারে। API Account অনুমোদিত না থাকলে Credentials সঠিক হলেও Request ব্যর্থ হতে পারে। এই অ্যাডঅন Courier Service সরবরাহ করে না; এটি আপনার Pathao Merchant Account-এর সঙ্গে Software সংযুক্ত করে। লাইসেন্স তথ্য এই অ্যাডঅনের লাইসেন্স আজীবন। তবে সফটওয়্যারে ব্যবহার করার সময় লাইসেন্স সার্ভার থেকে লাইসেন্সটি সক্রিয় ও বৈধ কি না নিয়মিত যাচাই করা হবে। লাইসেন্স নিষ্ক্রিয়, বাতিল বা ডোমেইনের সঙ্গে মিল না থাকলে অ্যাডঅনের কার্যক্রম বন্ধ থাকবে।