মার্চেন্ট ব্যালেন্স অনুসন্ধান (/payout/balance)

বিবরণ

মার্চেন্ট প্ল্যাটফর্মে তার অ্যাকাউন্টের রিয়েল-টাইম বিভিন্ন ব্যালেন্স (উত্তোলনযোগ্য ব্যালেন্স, ফ্রিজ করা ব্যালেন্স, ট্রানজিট ব্যালেন্স) অনুসন্ধানের জন্য এই এপিআই কল করবে।

---

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

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

---

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

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

---

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

প্যারামিটার	বাধ্যতামূলক	ধরন	উদাহরণের মান	বিবরণ
timestamp	হ্যাঁ	Long	1772880600000	মিলিসেকেন্ড টাইমস্ট্যাম্প

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

{
  "timestamp": 1772880600000
}

---

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

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

{
  "code": 1,
  "msg": "ok",
  "data": {
    "merchantNo": "M1652264659533",
    "availableBalance": "971.40",
    "frozenBalance": "0.00",
    "unavailableBalance": "100.00"
  }
}

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

{
  "code": 0,
  "msg": "invalid merchant"
}

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

ফিল্ডের নাম	ধরন	বিবরণ
code	Integer / String	স্ট্যাটাস কোড: 1 সফল, 0 ব্যর্থ
msg	String	তথ্যের বিবরণ
data	Object	অ্যাকাউন্ট ব্যালেন্স ডেটা অবজেক্ট
data.merchantNo	String	মার্চেন্ট নম্বর
data.availableBalance	String	উত্তোলনযোগ্য ব্যালেন্স (Available Balance) (যা সরাসরি পে-আউট বা উইথড্রয়ালের জন্য ব্যবহারযোগ্য)
data.frozenBalance	String	স্থগিত ব্যালেন্স (Frozen Balance) (ঝুঁকি ব্যবস্থাপনা বা বিরোধের কারণে সাময়িক লকড ফান্ড)
data.unavailableBalance	String	প্রক্রিয়াধীন ব্যালেন্স (Unavailable / In-transit) (যা ব্যাংকিং চ্যানেলে ক্লিয়ারিংয়ের অপেক্ষায় রয়েছে)