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

บัญชีธนาคาร

Bank account object แสดงถึงรายละเอียดบัญชีธนาคารที่ใช้สำหรับการจ่ายเงิน Object นี้ถูกใช้เมื่อสร้าง Recipient สำหรับการโอนเงินหรือตารางการโอนเงิน

ภาพรวม

บัญชีธนาคารไม่ได้ถูกสร้างโดยตรงผ่าน API แต่จะถูกสร้างเป็นส่วนหนึ่งของ:

  • การสร้าง Recipient - ระบุข้อมูลบัญชีธนาคารเมื่อสร้าง Recipient
  • การอัปเดต Recipient - อัปเดตข้อมูลบัญชีธนาคารสำหรับ Recipient ที่มีอยู่

โครงสร้าง Object

แอตทริบิวต์ประเภทคำอธิบาย
objectstringประเภทของ object คือ bank_account เสมอ
livemodebooleantrue หากเป็นข้อมูลจริง หรือ false หากเป็นข้อมูลทดสอบ
brandstringชื่อธนาคาร (เช่น Bangkok Bank, Kasikorn Bank)
bank_codestringรหัสธนาคาร (เช่น bbl, kbank, scb)
branch_codestringรหัสสาขาธนาคาร (จำเป็นสำหรับบางประเทศ เช่น ญี่ปุ่น)
account_numberstringเลขที่บัญชีธนาคาร (ถูกซ่อนบางส่วน)
last_digitsstringตัวเลข 4 หลักสุดท้ายของเลขบัญชี
namestringชื่อเจ้าของบัญชีธนาคาร
typestringประเภทบัญชี (เช่น normal, current) - จำเป็นสำหรับบางประเทศ
created_atdatetimeวันที่และเวลาที่สร้างบัญชีธนาคารในรูปแบบ ISO 8601

ตัวอย่าง Response

{
"object": "bank_account",
"livemode": true,
"brand": "Bangkok Bank",
"bank_code": "bbl",
"branch_code": null,
"account_number": null,
"last_digits": "6789",
"name": "SOMCHAI EXAMPLE",
"type": null,
"created_at": "2024-01-15T10:30:00Z"
}

ธนาคารที่รองรับ

ประเทศไทย

รหัสธนาคารที่ใช้งานได้บ่อย:

รหัสธนาคารชื่อธนาคาร
bblธนาคารกรุงเทพ
kbankธนาคารกสิกรไทย
scbธนาคารไทยพาณิชย์
ktbธนาคารกรุงไทย
bayธนาคารกรุงศรีอยุธยา
tmbธนาคารทหารไทย
gsbธนาคารออมสิน
baacธนาคารเพื่อการเกษตรและสหกรณ์การเกษตร

ประเทศญี่ปุ่น

สำหรับบัญชีธนาคารในญี่ปุ่น จำเป็นต้องระบุ:

  • branch_code - รหัสสาขาธนาคาร
  • type - ประเภทบัญชี (normal หรือ current)

สิงคโปร์ มาเลเซีย และอินโดนีเซีย

รองรับธนาคารหลักในแต่ละประเทศ ตรวจสอบรหัสธนาคารที่รองรับได้จาก Capability API

Endpoint ที่เกี่ยวข้อง

Bank account object ถูกใช้ร่วมกับ endpoint ต่อไปนี้:

เมธอดEndpointคำอธิบาย
POST/recipientsสร้าง Recipient ใหม่พร้อมข้อมูลบัญชีธนาคาร
PATCH/recipients/:idอัปเดตข้อมูลบัญชีธนาคารของ Recipient
POST/transfersสร้างการโอนเงินไปยังบัญชีธนาคารของ Recipient
GET/capabilityดึงข้อมูลธนาคารที่รองรับตามประเทศ

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

  • Recipients API - จัดการบัญชีธนาคารปลายทางสำหรับการโอนเงิน
  • Transfers API - โอนเงินไปยังบัญชีธนาคารของ Recipient
  • Capability API - ตรวจสอบธนาคารที่รองรับและความสามารถของบัญชี

ต้องการความช่วยเหลือ? ติดต่อ support@omise.co สำหรับข้อมูลเกี่ยวกับธนาคารที่รองรับหรือความช่วยเหลือในการเชื่อมต่อ