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

Transfers API

Transfers API ช่วยให้คุณสามารถโอนเงินจากยอดคงเหลือในบัญชี Omise ของคุณไปยังบัญชีธนาคารของผู้รับได้ การโอนเงินเป็นขั้นตอนสุดท้ายของกระบวนการจ่ายเงินที่ย้ายเงินไปยังผู้ขาย ผู้จัดจำหน่าย หรือบุคคลทั่วไป

ภาพรวม

การโอนเงินช่วยให้คุณสามารถ:

  • โอนเงินไปยังผู้รับ - โอนเงินจากยอดคงเหลือ Omise ไปยังบัญชีธนาคาร
  • กำหนดเวลาการจ่ายเงิน - ควบคุมเวลาที่เงินถูกส่งไปยังผู้รับ
  • ติดตามสถานะการโอนเงิน - ติดตามการโอนเงินที่รอดำเนินการ ส่งแล้ว จ่ายแล้ว และล้มเหลว
  • จัดการข้อมูลเมตา - แนบข้อมูลที่กำหนดเองสำหรับการกระทบยอดและการรายงาน
  • จัดการความล้มเหลว - ระบุและลองใหม่สำหรับการโอนเงินที่ล้มเหลว

วงจรชีวิตของการโอนเงิน

  1. สร้าง - เริ่มการโอนเงินไปยังผู้รับ
  2. รอดำเนินการ - การโอนเงินถูกจัดคิวเพื่อรอการประมวลผล
  3. ส่งแล้ว - การโอนเงินถูกส่งไปยังระบบธนาคารแล้ว
  4. จ่ายแล้ว - เงินเข้าถึงบัญชีธนาคารของผู้รับเรียบร้อยแล้ว
  5. ล้มเหลว - การโอนเงินล้มเหลว (ยอดคงเหลือไม่เพียงพอ บัญชีไม่ถูกต้อง ฯลฯ)

แนวคิดหลัก

ผู้รับ

การโอนเงินต้องมีผู้รับ ผู้รับคือปลายทางบัญชีธนาคารที่ได้รับการยืนยันแล้ว คุณต้องสร้างผู้รับก่อนที่จะเริ่มการโอนเงิน

ข้อกำหนดยอดคงเหลือ

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

ระยะเวลาในการประมวลผล

  • ไทย: 1-2 วันทำการสำหรับการโอนเงินระหว่างธนาคารในประเทศ
  • ต่างประเทศ: 3-7 วันทำการขึ้นอยู่กับประเทศปลายทาง

ข้อจำกัดของการโอนเงิน

ข้อจำกัดของการโอนเงินขึ้นอยู่กับการตั้งค่าบัญชีของคุณและสถานะการยืนยันของผู้รับ กรุณาติดต่อฝ่ายสนับสนุนสำหรับข้อจำกัดที่กำหนดเอง

การยืนยันตัวตน

ปลายทางการโอนเงินทั้งหมดต้องใช้Secret Key สำหรับการยืนยันตัวตน ห้ามเปิดเผย Secret Key ในโค้ดฝั่งไคลเอนต์

ปลายทางที่มีให้บริการ

MethodEndpointคำอธิบาย
POST/transfersสร้างการโอนเงินใหม่
GET/transfers/:idดึงข้อมูลการโอนเงินที่ระบุ
GET/transfersแสดงรายการการโอนเงินทั้งหมด
PATCH/transfers/:idอัปเดตการโอนเงิน
DELETE/transfers/:idยกเลิกการโอนเงินที่รอดำเนินการ

กรณีการใช้งานทั่วไป

การจ่ายเงินในตลาดกลาง

โอนเงินไปยังผู้ขายหลังจากทำธุรกรรมสำเร็จพร้อมหักค่าธรรมเนียมอัตโนมัติ

ค่าคอมมิชชั่นพันธมิตร

กำหนดเวลาการโอนเงินรายเดือนให้กับพันธมิตรตามตัวชี้วัดประสิทธิภาพที่จัดเก็บในข้อมูลเมตา

การคืนเงินไปยังบัญชีธนาคาร

ประมวลผลการคืนเงินโดยตรงไปยังบัญชีธนาคารของลูกค้าแทนวิธีการชำระเงินเดิม

การชำระเงินให้กับผู้ขาย

จ่ายเงินให้กับซัพพลายเออร์และผู้จัดจำหน่ายด้วยการโอนเงินอัตโนมัติที่เชื่อมโยงกับระบบบัญชีของคุณ

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

  • ยืนยันผู้รับก่อนเริ่มการโอนเงิน
  • ตรวจสอบยอดคงเหลือเพื่อให้แน่ใจว่ามีเงินเพียงพอ
  • ใช้ข้อมูลเมตาสำหรับการกระทบยอดและการติดตาม
  • ใช้งาน Webhookเพื่อติดตามการเปลี่ยนแปลงสถานะการโอนเงิน
  • จัดการความล้มเหลวอย่างเหมาะสมด้วยตรรกะการลองใหม่
  • ทดสอบอย่างละเอียดในโหมดทดสอบก่อนประมวลผลการโอนเงินจริง

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

  • Recipients API - จัดการบัญชีธนาคารของผู้รับ
  • Balance API - ตรวจสอบยอดคงเหลือที่พร้อมใช้งาน
  • Transactions API - ดูประวัติธุรกรรม
  • Webhooks - รับการอัปเดตสถานะการโอนเงิน

ต้องการความช่วยเหลือหรือไม่? กรุณาติดต่อ support@omise.co สำหรับข้อจำกัดการโอนเงิน ระยะเวลาในการประมวลผล หรือความช่วยเหลือในการเชื่อมต่อ