পে-আউট সেকেন্ডারি যাচাইকরণ API (মার্চেন্ট কর্তৃক প্রদত্ত)

বিবরণ

পে-আউট ফান্ড ডিসবার্সমেন্টের সর্বোচ্চ নিরাপত্তা নিশ্চিত করতে, প্ল্যাটফর্ম মূল অর্থ প্রদানের পূর্বে মার্চেন্ট সিস্টেমে কনফিগার করা যাচাইকরণ (Verification) এন্ডপয়েন্টে একটি HTTP POST রিকোয়েস্ট পাঠিয়ে অর্ডারটি পুনঃযাচাই করতে পারে।

IMPORTANT

• সফল যাচাইকরণ: মার্চেন্ট সিস্টেম রিকোয়েস্ট যাচাই করার পর প্লেইন টেক্সট স্ট্রিং true রিটার্ন করলে প্ল্যাটফর্ম চূড়ান্ত অর্থ প্রদান সম্পন্ন করবে;
• ব্যর্থ যাচাইকরণ: মার্চেন্ট যদি false রিটার্ন করে, তবে প্ল্যাটফর্ম তাৎক্ষণিকভাবে পে-আউট বাতিল করবে এবং পূর্ব-কর্তনকৃত ব্যালেন্স ও ফি মার্চেন্টের অ্যাকাউন্টে রিফান্ড করবে;
• নেটওয়ার্ক ত্রুটি / টাইমআউট: মার্চেন্ট সার্ভার যদি কোনো HTTP ত্রুটি (যেমন: 500) দেয় বা রেসপন্স টাইমআউট হয়, প্ল্যাটফর্ম তা ডিফল্টভাবে ব্যর্থ হিসেবে গণ্য করবে;
• সুবিধাটি চালু করার নিয়ম: এই সেকেন্ডারি যাচাইকরণ সুবিধা চালু করতে মার্চেন্টকে প্ল্যাটফর্মের টেকনিক্যাল টিমের সাথে যোগাযোগ করে ব্যাকএন্ডে যাচাইকরণ URL কনফিগার করতে হবে।
• প্ল্যাটফর্মের পাবলিক কি দিয়ে স্বাক্ষর যাচাই করুন এবং কেস সংবেদনশীলতা উপেক্ষা করুন।

---

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

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

---

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

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

---

রিকোয়েস্ট বডি প্যারামিটার

পেলোড উদাহরণ

{
  "timestamp": "1772880700000",
  "merchantOrderNo": "PO202603070001",
  "platOrderNo": "876324486452871168",
  "amount": "100.00",
  "bankCode": "BAC",
  "accountNo": "01812345678",
  "accountName": "Tanvir Ahmed"
}

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

ফিল্ডের নাম	বাধ্যতামূলক	ধরন	উদাহরণের মান	বিবরণ
timestamp	হ্যাঁ	String	1772880700000	মিলিসেকেন্ড টাইমস্ট্যাম্প
merchantOrderNo	হ্যাঁ	String	PO202603070001	মার্চেন্টের নিজস্ব অর্ডার নম্বর
platOrderNo	হ্যাঁ	String	876324486452871168	প্ল্যাটফর্ম অর্ডার রেফারেন্স
amount	হ্যাঁ	String	100.00	বিতরণের পরিমাণ
bankCode	হ্যাঁ	String	BAC	ব্যাংক বা ওয়ালেট কোড (যেমন: BAC, BKASH)
accountNo	হ্যাঁ	String	01812345678	প্রাপকের ব্যাংক বা ওয়ালেট অ্যাকাউন্ট নম্বর
accountName	হ্যাঁ	String	Tanvir Ahmed	প্রাপকের নাম

---

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

মার্চেন্ট সার্ভারে অভ্যন্তরীণ ডেটা ও ঝুঁকি যাচাইকরণ শেষে HTTP Response বডিতে প্লেইন টেক্সট (ছোট হাতের অক্ষর) পাঠাতে হবে:

পে-আউট অনুমোদন করতে:

true

পে-আউট প্রত্যাখ্যান করতে:

false