পে-ইন নোটিফিকেশন কলব্যাক (Pay-in Notification)

বিবরণ

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

IMPORTANT

১. মার্চেন্ট সিস্টেম নোটিফিকেশন সফলভাবে গ্রহণ ও প্রসেস করার পর অবশ্যই প্লেইন টেক্সট স্ট্রিং SUCCESS রিটার্ন করতে হবে।
২. যদি মার্চেন্ট সিস্টেম SUCCESS না পাঠায় বা রিকোয়েস্ট টাইমআউট হয়, প্ল্যাটফর্ম স্বয়ংক্রিয়ভাবে পুনরায় চেষ্টা করবে: সর্বোচ্চ ৫ বার, প্রতি ২০ মিনিট অন্তর।
৩. প্ল্যাটফর্মের পাবলিক কি দিয়ে স্বাক্ষর যাচাই করার সময় অক্ষরের বড়/ছোট হাতের পার্থক্য (Case sensitivity) উপেক্ষা করুন।

---

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

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

---

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

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

---

কলব্যাক বডি প্যারামিটার (Body Parameters)

পেলোড উদাহরণ

{
  "timestamp": "1772880120000",
  "merchantOrderNo": "202603070001",
  "platOrderNo": "876324486452871168",
  "amount": "100.00",
  "fee": "2.00",
  "status": "3",
  "msg": "success",
  "remark": "Test Order"
}

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

ফিল্ডের নাম	বাধ্যতামূলক	ধরন	উদাহরণের মান	বিবরণ
timestamp	হ্যাঁ	String	1772880120000	নোটিফিকেশন প্রেরণের টাইমস্ট্যাম্প
merchantOrderNo	হ্যাঁ	String	202603070001	মার্চেন্টের নিজস্ব অর্ডার নম্বর
platOrderNo	হ্যাঁ	String	876324486452871168	প্ল্যাটফর্ম ট্রানজ্যাকশন রেফারেন্স নম্বর
amount	হ্যাঁ	String	100.00	পরিশোধিত অর্থ
fee	হ্যাঁ	String	2.00	লেনদেন ফি
msg	হ্যাঁ	String	success	স্ট্যাটাসের বিবরণ
status	হ্যাঁ	String	3	অর্ডারের অবস্থা: 0: তৈরি করা হয়েছে (Created) 1: মেয়াদোত্তীর্ণ (Expired) 2: পেমেন্ট ব্যর্থ (Payment Failed) 3: পেমেন্ট সফল (Payment Succeeded)
remark	না	String	Test Order	মার্চেন্ট কর্তৃক অর্ডারে প্রদত্ত মন্তব্য

---

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

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

SUCCESS