পে-আউট নোটিফিকেশন কলব্যাক (Payout Notification)

বিবরণ

পে-আউট অর্ডারের অর্থ প্রদান নিশ্চিতভাবে সফল বা ব্যর্থ হওয়ার পর, প্ল্যাটফর্ম স্বয়ংক্রিয়ভাবে HTTP POST রিকোয়েস্টের মাধ্যমে মার্চেন্টের notifyUrl-এ অ্যাসিনক্রোনাস নোটিফিকেশন পাঠাবে।

IMPORTANT

১. মার্চেন্ট সিস্টেম নোটিফিকেশন গ্রহণের পর অবশ্যই প্লেইন টেক্সট হিসেবে SUCCESS পাঠাতে হবে।
২. যদি মার্চেন্ট সিস্টেম SUCCESS না পাঠায়, প্ল্যাটফর্ম বারবার পাঠাতে থাকবে: প্রতি ১ মিনিট পর পর, মোট ৫ বার।
৩. বিরল অর্থনৈতিক ব্যতিক্রম: খুব বিরল ক্ষেত্রে ব্যাংকিং চ্যানেলের জটিলতার কারণে প্রথমে সফল হলেও পরবর্তীতে ব্যাংক রিভার্সাল বা রিফান্ডের কারণে ব্যর্থ হতে পারে। মার্চেন্ট সিস্টেমে এর জন্য আইডেমপোটেন্সি (Idempotency) নিশ্চিত করা উচিত।
৪. প্ল্যাটফর্মের পাবলিক কি ব্যবহার করে স্বাক্ষর যাচাই করুন এবং কেস সংবেদনশীলতা উপেক্ষা করুন।

---

রিকোয়েস্টের সাধারণ তথ্য

• রিকোয়েস্ট URL: মার্চেন্টের অর্ডারে প্রদত্ত notifyUrl
• মেথড (Method): POST
• Content-Type: application/json; charset=utf-8

---

রিকোয়েস্ট হেডার (HTTP Headers)

প্যারামিটার	বাধ্যতামূলক	ধরন (Type)	বিবরণ
merchantNo	হ্যাঁ (Yes)	String	মার্চেন্ট নম্বর
sign	হ্যাঁ (Yes)	String	প্ল্যাটফর্মের প্রাইভেট কি দ্বারা তৈরি ডিজিটাল স্বাক্ষর

---

কলব্যাক বডি প্যারামিটার

পেলোড উদাহরণ

{
  "timestamp": "1772880400000",
  "merchantOrderNo": "PO202603070001",
  "platOrderNo": "876324486452871168",
  "amount": "100.00",
  "fee": "5.00",
  "status": "3",
  "msg": "success",
  "remark": "Salary Payout"
}

ফিল্ডের স্পেসিফিকেশন

ফিল্ডের নাম	বাধ্যতামূলক	ধরন	উদাহরণের মান	বিবরণ
timestamp	হ্যাঁ	String	1772880400000	নোটিফিকেশন প্রেরণের সময়
merchantOrderNo	হ্যাঁ	String	PO202603070001	মার্চেন্টের নিজস্ব অর্ডার রেফারেন্স
platOrderNo	হ্যাঁ	String	876324486452871168	প্ল্যাটফর্ম ট্রানজ্যাকশন রেফারেন্স
amount	হ্যাঁ	String	100.00	অর্থ বিতরণের পরিমাণ
fee	হ্যাঁ	String	5.00	সার্ভিস ফি
msg	হ্যাঁ	String	success	স্ট্যাটাস বিবরণ
status	হ্যাঁ	String	3	পে-আউট স্ট্যাটাস: 0: তৈরি করা হয়েছে (Created) 1: প্রক্রিয়াধীন (Processing) 2: ব্যর্থ (Failed) 3: সফল (Succeeded)
remark	না	String	Salary Payout	মার্চেন্টের মূল মন্তব্য

---

মার্চেন্টের প্রয়োজনীয় রেসপন্স

মার্চেন্ট সার্ভারে প্রক্রিয়াকরণ সম্পন্ন হলে HTTP Response বডিতে নিচের টেক্সটটি পাঠাতে হবে:

SUCCESS