পে-আউট অর্ডার অনুসন্ধান (/payout/query)

বিবরণ

মার্চেন্ট পে-আউট (অর্থ বিতরণ) অর্ডারের রিয়েল-টাইম স্ট্যাটাস এবং বিবরণ অনুসন্ধান করতে এই এপিআই ব্যবহার করবে।

---

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

• রিকোয়েস্ট URL: /payout/query
• মেথড (Method): POST
• Content-Type: application/json; charset=utf-8

---

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

প্যারামিটার	বাধ্যতামূলক	ধরন (Type)	বিবরণ
merchantNo	হ্যাঁ (Yes)	String	মার্চেন্ট নম্বর
sign	হ্যাঁ (Yes)	String	রিকোয়েস্ট বডির Base64 RSA ডিজিটাল স্বাক্ষর

---

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

প্যারামিটার	বাধ্যতামূলক	ধরন	উদাহরণের মান	বিবরণ
timestamp	হ্যাঁ	Long	1772880500000	মিলিসেকেন্ড টাইমস্ট্যাম্প
merchantOrderNo	হ্যাঁ	String	PO202603070001	অনুসন্ধানের জন্য মার্চেন্ট অর্ডার নম্বর

রিকোয়েস্ট পেলোড উদাহরণ

{
  "timestamp": 1772880500000,
  "merchantOrderNo": "PO202603070001"
}

---

রেসপন্স প্যারামিটার

সফল রেসপন্স উদাহরণ

{
  "code": 1,
  "msg": "ok",
  "data": {
    "merchantNo": "M1639466186292",
    "merchantOrderNo": "PO202603070001",
    "platOrderNo": "876324486452871168",
    "amount": "220.00",
    "fee": "5.00",
    "status": "3"
  }
}

ব্যর্থ রেসপন্স উদাহরণ

{
  "code": 0,
  "msg": "order not found"
}

রেসপন্স ফিল্ডের বিবরণ

ফিল্ডের নাম	ধরন	বিবরণ
code	Integer / String	1 সফল, 0 ব্যর্থ
msg	String	বিবরণের বার্তা
data	Object	পে-আউট অর্ডারের বিস্তারিত তথ্য
data.merchantNo	String	মার্চেন্ট নম্বর
data.merchantOrderNo	String	মার্চেন্ট অর্ডার নম্বর
data.platOrderNo	String	প্ল্যাটফর্মের লেনদেন নম্বর
data.amount	String	বিতরণের পরিমাণ
data.fee	String	সার্ভিস ফি
data.status	String	পে-আউট স্ট্যাটাস: 0: তৈরি করা হয়েছে (Created) 1: প্রক্রিয়াধীন (Processing / Sent to bank) 2: ব্যর্থ (Failed) 3: সফল (Succeeded)