পে-আউট অর্ডার অনুসন্ধান (/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",
    "payTime": "2026-09-09 22:22:22",
    "payAccountNo": "01666777888",
    "trxId": "SDIIFKISDL"
  }
}

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

{
  "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)
data.payTime	না	String	অর্থপ্রদানের সময় (ফরম্যাট: yyyy-MM-dd HH:mm:ss)
data.payAccountNo	না	String	পেমেন্ট বিতরণকারী অ্যাকাউন্ট নম্বর
data.trxId	না	String	ই-ওয়ালেট সিস্টেম দ্বারা তৈরি অনন্য ট্রানজ্যাকশন আইডি