পেমেন্ট ফরওয়ার্ডার

Payment Forwarder মার্চেন্ট SIM-সহ একটি নির্দিষ্ট Android ফোনকে ISPbills-এর সঙ্গে যুক্ত করে। আলাদা ISPbills SMS Forwarder অ্যাপটি সমর্থিত মার্চেন্ট SMS ও অ্যাপ নোটিফিকেশন পড়ে পেমেন্টের তথ্য ISPbills-এ পাঠায় এবং আসা অর্থ বকেয়া পেমেন্টের সঙ্গে মেলাতে সাহায্য করে।

বর্তমান ডিভাইস পেজে bKash, Nagad, Rocket, Upay, mCash ও CellFin সমর্থিত ওয়ালেট হিসেবে দেখানো হয়। ওয়ালেট থেকে আসা বার্তার বিন্যাস অনুযায়ী তথ্য শনাক্ত হয়। refund, reversal, debit, cash-out এবং বাইরে পাঠানো send-money বার্তা পর্যালোচনার জন্য রাখা হয়, কিন্তু স্বয়ংক্রিয়ভাবে কখনো জমা হয় না।

অ্যাক্সেস ও প্রয়োজনীয় প্রস্তুতি

শুধু developer, super_admin বা group_admin ভূমিকার লগইন করা ব্যবহারকারী অ্যাডমিন Payment Forwarder পেজ খুলতে ও ব্যবহার করতে পারেন। ডিভাইস ও ইভেন্ট নির্বাচিত অপারেটরের মধ্যেই সীমাবদ্ধ থাকে। Group Admin সব সময় নিজের অপারেটর অ্যাকাউন্টের তথ্যই দেখতে পারেন।

সেটআপের আগে প্রস্তুত রাখুন:

• মার্চেন্ট SIM-সহ ইন্টারনেট সংযুক্ত Android ফোন;
• ওয়ালেটের বার্তা গ্রহণকারী সঠিক মার্চেন্ট নম্বর;
• ISPbills সার্ভার থেকে সরাসরি APK ইনস্টল করার অনুমতি;
• Bills & Payments → Payment Forwarder পেজের অ্যাক্সেস।

ডিভাইস নিবন্ধন করুন

1. Bills & Payments → Payment Forwarder খুলুন। চাইলে আপনার ISPbills সার্ভারের /admin/payment-forwarder ঠিকানা ব্যবহার করুন।
2. /sms.apk থেকে sms.apk ডাউনলোড করুন।
3. Register Device অংশে বোঝা যায় এমন Name এবং সঠিক Merchant Number লিখুন।
4. Register Device নির্বাচন করুন।

Wallet provider যে exact merchant number দেখায় সেটিই ব্যবহার করুন। ISPbills device-টিকে সংশ্লিষ্ট payment gateway-এর সঙ্গে যুক্ত করে।

Android ফোন কনফিগার করুন

1. মার্চেন্ট SIM থাকা ফোনে sms.apk ইনস্টল করুন। Android বাধা দিলে যে browser বা file manager দিয়ে APK খুলেছেন, সেটির জন্য APK ইনস্টলের অনুমতি দিন।
2. ISPbills SMS Forwarder খুলুন। এটি মূল ISPbills Android অ্যাপ থেকে আলাদা।
3. ISPbills-এর Server URL এবং নিবন্ধনের সময় দেওয়া একই Merchant number লিখুন।
4. Save and start নির্বাচন করুন। Provider নির্বাচন করতে হয় না।
5. SMS receive/read permission এবং Android 13 বা পরের সংস্করণে foreground notification permission দিন।
6. notification access settings খুলে ISPbills SMS Forwarder চালু করুন, যাতে সমর্থিত ওয়ালেট অ্যাপের নোটিফিকেশন পড়া যায়।
7. battery optimization থেকে অ্যাপটিকে বাদ দিয়ে Unrestricted, No restrictions বা ফোনে থাকা সমমানের অপশন বেছে নিন। ফোনে auto-start on boot থাকলে সেটিও চালু করুন।
8. foreground-service notification চালু রাখুন।

আগে কোনো permission প্রত্যাখ্যান করলে অ্যাপের Required permissions কার্ড থেকে notification access, battery বা app settings আবার খুলুন।

ডিভাইস সচল আছে কি না দেখুন

Registered Devices টেবিলে মার্চেন্ট নম্বর, অ্যাপের সংস্করণ, সর্বশেষ যোগাযোগ, ব্যাটারির মাত্রা, Android ID, সর্বশেষ IP এবং diagnostics দেখা যায়। গত 20 মিনিটের মধ্যে ISPbills heartbeat পেলে ডিভাইসটি Online, না হলে Offline দেখায়। Online মানে সাম্প্রতিক যোগাযোগ হয়েছে; প্রতিটি মার্চেন্ট বার্তা শনাক্ত বা পেমেন্টের সঙ্গে মিলেছে—এটি তার নিশ্চয়তা নয়।

Forwarder payment event ও device health-এর তথ্য নিরাপদভাবে ISPbills-এ পাঠায়। Merchant phone setup-এর বাইরে device registration-এর তথ্য শেয়ার করবেন না।

ইভেন্টের অবস্থা বুঝুন

অবস্থা	অর্থ
received	ISPbills ইভেন্ট সংরক্ষণ করেছে, কিন্তু মেলানোর কাজ চূড়ান্ত হয়নি।
matched	টাকার পরিমাণ অনুযায়ী এক বা একাধিক সম্ভাব্য পেমেন্ট আছে, তবে মিল আংশিক বা একাধিক হওয়ায় পর্যালোচনা দরকার।
unmatched	নিরাপদ বকেয়া পেমেন্ট পাওয়া যায়নি, মার্চেন্ট নম্বরের গেটওয়ে মেলেনি অথবা বার্তাটি আসা অর্থ নয়।
auto_approved	ISPbills একটি নিরাপদ মিল পেয়েছে অথবা একটি অনন্য গ্রাহক-তথ্য থেকে নিরাপদে পেমেন্ট রেকর্ড তৈরি করে প্রক্রিয়া করেছে।
manually_approved	অনুমোদিত অ্যাডমিন একটি বকেয়া পেমেন্ট নির্বাচন বা Customer ID দিয়ে অনুমোদন করেছেন।
duplicate	লেনদেনটি আগে যুক্ত হওয়া event-এর পুনরাবৃত্তি, তাই আবার জমা হয়নি।
rejected	অ্যাডমিন ইভেন্টটি পর্যালোচনা করে প্রত্যাখ্যান করেছেন; এটি থেকে কোনো পেমেন্ট জমা হয় না।

ড্যাশবোর্ডের Needs Review সংখ্যায় received, matched ও unmatched ইভেন্ট একসঙ্গে দেখানো হয়।

পেমেন্ট কীভাবে মেলানো হয়

ISPbills merchant, amount, payer ও transaction reference-এর সঙ্গে pending payment তুলনা করে। শুধু একটি নিরাপদ match শনাক্ত হলেই payment স্বয়ংক্রিয়ভাবে process হয়। অস্পষ্ট বা অপ্রত্যাশিত event manual review-এর জন্য থেকে যায়।

অনুমোদনের পর ISPbills যুক্ত পেমেন্টকে Successful করে, প্রেরক ও লেনদেনের তথ্য কপি করে এবং স্বাভাবিক পেমেন্ট প্রক্রিয়ায় চালায়। স্বয়ংক্রিয় অনুমোদনে Approved by-এ কোনো অ্যাডমিন থাকে না; হাতে অনুমোদন করলে সংশ্লিষ্ট অপারেটরের তথ্য থাকে।

ইভেন্ট পর্যালোচনা ও নিষ্পত্তি করুন

1. Forwarded Events খুলে ইভেন্টের Review নির্বাচন করুন।
2. মার্চেন্ট ওয়ালেটের সঙ্গে amount, payer, merchant, reference, transaction type, raw message ও Match reason মিলিয়ে দেখুন।
3. ইভেন্ট আসার পর পেমেন্ট বা গ্রাহকের তথ্য যোগ হয়ে থাকলে Recheck নির্বাচন করুন। চূড়ান্ত auto_approved, manually_approved বা rejected ইভেন্ট আবার মেলানো হয় না।
4. বিদ্যমান পেমেন্ট অনুমোদন করতে একটি Pending recharge payment বেছে Approve / Match নির্বাচন করুন।
5. কোনো বকেয়া রেকর্ড না থাকলেও গ্রাহক নিশ্চিত হলে সঠিক Customer ID লিখুন। ISPbills ফরওয়ার্ড করা লেনদেন থেকে অনুসরণযোগ্য iPay customer-payment রেকর্ড তৈরি করে সেটি প্রক্রিয়া করবে।
6. বকেয়া পেমেন্ট অথবা Customer ID—যেকোনো একটি দিন, দুটো নয়। একই অপারেটরের শুধু Pending পেমেন্ট হাতে অনুমোদন করা যায়।
7. ইভেন্ট অবৈধ বা জমা দেওয়া যাবে না হলে Reject নির্বাচন করুন। চূড়ান্ত ও duplicate ইভেন্টে হাতে অনুমোদন বা প্রত্যাখ্যানের নিয়ন্ত্রণ দেখানো হয় না।

ইভেন্ট ফিল্টার ও গ্রাহক খোঁজার পার্থক্য

ওয়েব পেজে Toggle Filters ব্যবহার করে নির্দিষ্ট status ও লেনদেনের তারিখসীমা অনুযায়ী ইভেন্ট ছাঁকুন। Payer, merchant, ref… ঘরটি payer number, merchant number, reference number, client event UUID এবং raw message-এর লেখা খোঁজে। এটি যুক্ত গ্রাহকের নাম, username, mobile বা profile সরাসরি খোঁজে না।

Android ফরওয়ার্ডারের customer search আলাদা সুবিধা। সেখানে অপারেটর-সীমাবদ্ধ তালিকায় name, username, mobile, IP বা MAC দিয়ে গ্রাহক খুঁজে বিস্তারিত দেখা যায়। call, SMS ও copy কাজগুলো ফোনেই হয়; ওয়েবে customer profile খুলতে স্বাভাবিক ISPbills web login লাগে। এই customer lookup-কে ইভেন্ট মেলানো বা ওয়েবের event filter-এর সঙ্গে গুলিয়ে ফেলবেন না।

প্রতিদিন যা দেখবেন

• ডিভাইস Online রাখুন এবং diagnostics দেখুন।
• মার্চেন্ট ওয়ালেটে যাচাই করে Needs Review ইভেন্ট নিষ্পত্তি করুন।
• অনুমোদিত মোট টাকা wallet statement ও customer payment history-এর সঙ্গে মেলান।
• আরেকটি রেকর্ড অনুমোদন না করে বারবার duplicate আসার কারণ দেখুন।
• অ্যাপে Download update দেখালে নতুন সংস্করণ ইনস্টল করুন।

সমস্যা শনাক্তকরণ ও সমাধান

সমস্যা	যা দেখবেন
ডিভাইস Offline	mobile data/Wi-Fi ও Server URL দেখুন। এরপর battery ব্যবহার Unrestricted করে অ্যাপ আবার খুলুন। নিবন্ধিত ও অ্যাপে দেওয়া merchant number একই কি না দেখুন।
Device registration গ্রহণ করছে না	Merchant number active registered device-এর সঙ্গে মিলছে কি না দেখুন। প্রয়োজনে device আবার register করুন।
SMS এলেও ইভেন্ট নেই	SMS receive/read permission দিন, service চালু রাখুন এবং বার্তায় শনাক্ত করা যায় এমন amount আছে কি না দেখুন।
Wallet-app notification আসছে না	Android notification access-এ ISPbills SMS Forwarder চালু করুন। সাধারণ notification permission আর notification-listener access এক নয়।
ইভেন্ট unmatched থাকে	Pending payment-এর সঙ্গে merchant number, amount, payer ও reference তুলনা করে Recheck ব্যবহার করুন।
Search-এ গ্রাহক পাওয়া যায় না	Event search customer-profile search নয়। payer/reference/raw text দিয়ে খুঁজুন, অথবা Android customer list থেকে সঠিক Customer ID নিয়ে manual review-তে লিখুন।
একাধিক সম্ভাব্য পেমেন্ট	মার্চেন্ট লেনদেন বাইরে থেকে যাচাই করে সঠিক বকেয়া পেমেন্ট বেছে নিন। ফলাফল একাধিক হলে ISPbills ইচ্ছাকৃতভাবে auto-approval করে না।
একই বার্তা আবার এসেছে	Payer, amount ও reference মিলিয়ে দেখুন। Duplicate delivery আবার হাতে জমা দেবেন না।
Forward failed থেকে যাচ্ছে	দেখানো HTTP/network কারণ দেখুন। 1.0.6 বা পরের সংস্করণে সফলভাবে পাঠানোর পর পুরোনো failure মুছে যায়।
APK ইনস্টল হচ্ছে না	/sms.apk যে browser/file manager দিয়ে খুলেছেন, সেটির APK install permission দিন এবং ISPbills সার্ভার থেকে আবার ডাউনলোড করুন।

নিরাপত্তা ও রক্ষণাবেক্ষণ

ফোনে screen lock ব্যবহার করুন, notification access সীমিত রাখুন এবং অপ্রয়োজনে diagnostics বা লেনদেনের screenshot প্রকাশ করবেন না। শুধু নিজের ISPbills account-এর Payment Forwarder page থেকে update install করুন।