สอบถามยอดเงินคงเหลือของร้านค้า (Merchant Balance)

ร้านค้าสามารถสอบถามยอดเงินคงเหลือที่ใช้งานได้ ยอดเงินที่ถูกแช่แข็ง (ระงับ) และยอดเงินที่อยู่ระหว่างดำเนินการโอนเงินผ่านช่องทางนี้

---

ข้อมูลอินเทอร์เฟซ

• ที่อยู่เชื่อมต่อ (URL): /payout/balance
• วิธีการร้องขอ: POST
• Content-Type: application/json; charset=utf-8

---

พารามิเตอร์ส่วนหัว (Header)

พารามิเตอร์	จำเป็น	ประเภท	คำอธิบาย
merchantNo	ใช่	string	หมายเลขร้านค้า (Merchant Number)
sign	ใช่	string	ลายมือชื่อดิจิทัล RSA (โปรดอ้างอิงหน้า "คำอธิบายทั่วไป")

---

พารามิเตอร์ส่วนเนื้อหา (Request Body)

พารามิเตอร์	จำเป็น	ประเภท	คำอธิบาย
timestamp	ใช่	Long	ประทับเวลาเป็นมิลลิวินาที (Millisecond timestamp)

---

ตัวอย่างการตอบกลับ

ตอบกลับสำเร็จ

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

ตอบกลับล้มเหลว

{
  "code": 0,
  "msg": "param merchant error"
}

---

คำอธิบายพารามิเตอร์ส่งกลับ

พารามิเตอร์	ประเภท	คำอธิบาย
code	number	1 สำเร็จ, 0 ล้มเหลว
msg	string	คำอธิบายผลลัพธ์
data	object	ข้อมูลยอดเงินคงเหลือที่ส่งคืนเมื่อตรวจสอบสำเร็จ
└ merchantNo	string	หมายเลขร้านค้า
└ availableBalance	string	ยอดเงินคงเหลือที่ถอนได้/จ่ายได้ (โอนเงินออกได้)
└ frozenBalance	string	ยอดเงินที่ถูกระงับ/แช่แข็งชั่วคราว
└ unavailableBalance	string	ยอดเงินคงเหลือในระหว่างรอดำเนินการ (เช่น ยอดเงินเติมที่อยู่ระหว่างการประมวลผล)