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

Balance API

ภาพรวม​

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

Endpoint ที่ใช้ได้​

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

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

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

ประเภทของ Balance​

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

  1. Total Balance - เงินทั้งหมดในบัญชีของคุณ (ที่ใช้ได้ + รอดำเนินการ)
  2. Available Balance - เงินที่สามารถโอนได้ทันที
  3. Transferable Balance - เงินที่สามารถโอนไปยังบัญชีธนาคารได้

เมื่อ Balance อัปเดต​

ยอดคงเหลือของคุณจะอัปเดตเมื่อ:

  • Charge สำเร็จ
  • Refund ถูกดำเนินการ
  • Transfer ถูกสร้าง
  • ค่าธรรมเนียมถูกหัก
  • Disputes ชนะหรือแพ้
  • Chargebacks ถูกดำเนินการ

ระยะเวลา Settlement​

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

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

Use Cases​

ตรวจสอบกระแสเงินสด​

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

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

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

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

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

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

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

โครงสร้าง Balance Object​

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

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

ควรทำ​

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

ไม่ควรทำ​

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

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

ดูเพิ่มเติม​

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