ข้ามไปยังเนื้อหาหลัก
เวอร์ชัน: ล่าสุด

Balance API

ภาพรวม​

Balance API ช่วยให้คุณสามารถดึงข้อมูลยอดคงเหลือในบัญชีปัจจุบัน รวมถึงเงินที่พร้อมใช้งาน จำนวนเงินที่รอดำเนินการ และยอดคงเหลือที่สามารถโอนได้ในทุกสกุลเงินที่รองรับ

เอนด์พอยท์ที่พร้อมใช้งาน​

สิ่งที่คุณสามารถทำได้​

  • ตรวจสอบยอดคงเหลือที่พร้อมใช้งาน - ตรวจสอบจำนวนเงินที่พร้อมใช้งานสำหรับการโอน
  • แสดงจำนวนเงินที่รอดำเนินการ - ติดตามเงินที่รอการชำระเงิน
  • รองรับหลายสกุลเงิน - แสดงยอดคงเหลือในหลายสกุลเงินเช่น THB, JPY, SGD, MYR, USD
  • ข้อมูลแบบเรียลไทม์ - ดึงข้อมูลยอดคงเหลือล่าสุด
  • จำนวนเงินที่สามารถโอนได้ - ตรวจสอบจำนวนเงินที่สามารถโอนไปยังบัญชีธนาคาร

วิธีการทำงานของ Balance​

ประเภทของ Balance​

บัญชี Omise ของคุณมี 3 ประเภทของยอดคงเหลือ:

  1. ยอดคงเหลือรวม - เงินทั้งหมดในบัญชี (ที่พร้อมใช้งาน + ที่รอดำเนินการ)
  2. ยอดคงเหลือที่พร้อมใช้งาน - เงินที่สามารถโอนได้ทันที
  3. ยอดคงเหลือที่สามารถโอนได้ - เงินที่สามารถโอนไปยังบัญชีธนาคาร

เมื่อใดที่ยอดคงเหลือได้รับการอัปเดต​

ยอดคงเหลือจะได้รับการอัปเดตเมื่อ:

  • ✅ charge สำเร็จเสร็จสมบูรณ์
  • ✅ refund ถูกประมวลผล
  • ✅ transfer ถูกสร้าง
  • ✅ ค่าธรรมเนียมถูกหัก
  • ✅ dispute ได้รับการแก้ไข
  • ✅ chargeback ถูกประมวลผล

ระยะเวลาการชำระเงิน​

วิธีการชำระเงินแต่ละประเภทมีระยะเวลาการชำระเงินที่แตกต่างกัน:

  • บัตรเครดิต: โดยปกติ 2-3 วันทำการ
  • PromptPay: ทันที
  • โมบายแบงก์กิ้ง: 1-2 วันทำการ
  • ผ่อนชำระ: ตามกำหนดการผ่อนชำระ

กรณีการใช้งาน​

ติดตามกระแสเงินสด​

ตรวจสอบยอดคงเหลือที่พร้อมใช้งานก่อนเริ่มการโอนเพื่อยืนยันว่ามีเงินเพียงพอ

การจัดการหลายสกุลเงิน​

แสดงยอดคงเหลือในสกุลเงินต่างๆ หากคุณรับชำระเงินในหลายสกุลเงิน

การกระทบยอด​

เปรียบเทียบยอดคงเหลือจาก API กับใบแจ้งยอดธนาคารและแดชบอร์ดเพื่อวัตถุประสงค์ทางบัญชี

การโอนเงินอัตโนมัติ​

ตรวจสอบยอดคงเหลือที่สามารถโอนได้ก่อนสร้างกำหนดการโอนเงินอัตโนมัติ

โครงสร้างของออบเจ็กต์ Balance​

{
  "object": "balance",
  "livemode": true,
  "available": 1250000,
  "total": 1500000,
  "currency": "thb",
  "transferable": 1200000,
  "reserve": {
    "amount": 50000,
    "percentage": 10.0
  }
}

แนวทางปฏิบัติที่ดีที่สุด​

✅ คำแนะนำ​

  • ตรวจสอบก่อนการโอน - ตรวจสอบยอดคงเหลือที่พร้อมใช้งานก่อนสร้าง transfer
  • ติดตามเป็นประจำ - ตั้งค่าการติดตามยอดคงเหลืออัตโนมัติ
  • จัดการหลายสกุลเงิน - คำนึงถึงยอดคงเหลือในสกุลเงินต่างๆ
  • แคชอย่างเหมาะสม - ข้อมูลยอดคงเหลือสามารถแคชได้ 1-5 นาที
  • ใช้ Webhooks - รับฟังเหตุการณ์ charge.complete และ transfer.create

❌ สิ่งที่ควรหลีกเลี่ยง​

  • การโพลล์มากเกินไป - หลีกเลี่ยงการตรวจสอบยอดคงเหลือมากกว่า 1 ครั้งต่อนาที
  • การสันนิษฐานว่ามีเงินพร้อมใช้ทันที - คำนึงถึงระยะเวลาการชำระเงิน
  • การเพิกเฉยต่อเงินสำรอง - คำนึงถึงข้อกำหนดเงินสำรองของบัญชี
  • การลืมจำนวนเงินที่รอดำเนินการ - อย่าลืมว่ายอดคงเหลือรวมรวมเงินที่รอดำเนินการด้วย

ทรัพยากรที่เกี่ยวข้อง​

ข้อมูลที่เกี่ยวข้อง​

ต้องการความช่วยเหลือใช่หรือไม่? ติดต่อเราที่ support@omise.co