API การโอนเงิน
API การโอนเงินช่วยให้คุณสามารถโอนเงินจากยอดคงเหลือในบัญชี Omise ของคุณไป ยังบัญชีธนาคารของผู้รับได้ การโอนเงินเป็นขั้นตอนสุดท้ายในกระบวนการจ่ายเงิน โดยเคลื่อนย้ายเงินไปยังร้านค้า ผู้ขาย หรือบุคคลทั่วไป
ภาพรวม
การโอนเงินช่วยให้คุณสามารถ:
- ส่งเงินไปยังผู้รับ - โอนเงินจากยอดคงเหลือ Omise ไปยังบัญชีธนาคาร
- กำหนดตารางการจ่ายเงิน - ควบคุมเวลาที่เงินถูกส่งไปยังผู้รับ
- ติดตามสถานะการโอน - ตรวจสอบการโอนที่รอดำเนินการ ส่งแล้ว จ่ายแล้ว และล้มเหลว
- จัดการ metadata - แนบข้อมูลที่กำหนดเองสำหรับการกระทบยอดและการรายงาน
- จัดการความล้มเหลว - ระบุและลองโอนที่ล้มเหลวอีกครั้ง
วงจรชีวิตของการโอน
- สร้าง - เริ่มต้นการโอนไปยังผู้รับ
- รอดำเนินการ - การโอนอยู่ในคิวรอการประมวลผล
- ส่งแล้ว - การโอนถูกส่งไปยังระบบธนาคาร
- จ่ายแล้ว - เงินถึงบัญชีธนาคารของผู้รับเรียบร้อยแล้ว
- ล้มเหลว - การโอนล้มเหลว (ยอดคงเหลือไม่เพียงพอ บัญชีไม่ถูกต้อง ฯลฯ)
แนวคิดหลัก
ผู้รับ
การโอนต้องมีผู้รับ - ปลายทางบัญชีธนาคารที่ได้รับการยืนยัน คุณต้องสร้างผู้รับก่อนเริ่มต้นการโอน
ข้อกำหนดยอดคงเหลือ
การโอนจะหักจากยอดคงเหลือที่ใช้ได้ของคุณ ตรวจสอบให้แน่ใจว่ามีเงินเพียงพอก่อนสร้างการโอน
เวลาในการประมวลผล
- ประเทศไทย: 1-2 วันทำการสำหรับการโอนธนาคารในประเทศ
- ระหว่างประเทศ: 3-7 วันทำการขึ้นอยู่กับประเทศปลายทาง
ขีดจำกัดการโอน
ขีดจำกัดการโอนขึ้นอยู่กับการตั้งค่าบัญชีและสถานะการยืนยันผู้รับ ติดต่อฝ่ายสนับสนุนสำหรับขีด จำกัดที่กำหนดเอง
การรับรองความถูกต้อง
endpoint การโอนทั้งหมดต้องใช้ secret key ของคุณสำหรับการรับรองความถูกต้อง อย่าเปิดเผย secret key ของคุณในโค้ดฝั่งไคลเอนต์
Endpoints ที่พร้อมใช้งาน
| เมธอด | Endpoint | คำอธิบาย |
|---|---|---|
| POST | /transfers | สร้างการโอนใหม่ |
| GET | /transfers/:id | ดึงข้อมูลการโอนที่ระบุ |
| GET | /transfers | แสดงรายการการโอนทั้งหมด |
| PATCH | /transfers/:id | อัปเดตการโอน |
| DELETE | /transfers/:id | ยกเลิกการโอนที่รอดำเนินการ |
กรณีใช้งานทั่วไป
การจ่ายเงิน Marketplace
โอนเงินไปยังผู้ขายหลังจากการทำธุรกรรมสำเร็จพร้อมการหักค่าธรรมเนียมอัตโนมัติ
ค่าคอมมิชชั่นพันธมิตร
กำหนดตารางการโอนรายเดือนให้กับพันธมิตรตามตัวชี้วัดประสิทธิภาพที่เก็บไว้ใน metadata
คืนเงินไปยังบัญชีธนาคาร
ประมวลผลการคืนเงินโดยตรงไปยังบัญชีธนาคารของลูกค้าแทนวิธีการชำระเงินเดิม
การชำระเงินผู้ขาย
ชำระเงินให้ซัพพลายเออร์และผู้ขายด้วยการโอนอัตโนมัติที่เชื่อมต่อกับระบบบัญชีของคุณ
รหัสความล้มเหลวของการโอน
เมื่อการโอนล้มเหลว แอตทริบิวต์ failure_code จะระบุสาเหตุ:
| รหัส | ข้อความ | คำอธิบาย |
|---|---|---|
insufficient_balance | "insufficient balance" | จำนวนเงินโอนเกินเงินที่มีอยู่ |
invalid_recipient | "invalid recipient" | ผู้รับไม่ถูกต้องหรือไม่ได้รับการยืนยัน |
invalid_bank_account | "invalid bank account" | รายละเอียดบัญชีธนาคารไม่ถูกต้อง |
transfers_suspended | "transfers suspended" | การโอนถูกระงับสำหรับบัญชี |
transfer_deleted | "transfer deleted" | พยายามประมวลผลการโอนที่ถูกลบ |
transfer_sent | "transfer already sent" | พยายามส่งการโอนที่ส่งไปแล้วอีกครั้ง |
transfer_failed | "transfer failed" | การประมวลผลการโอนล้มเหลวทั่วไป |
bank_not_found | "bank not found" | ไม่พบธนาคารที่ระบุ |
account_not_found | "account not found" | ไม่พบบัญชีธนาคาร |
name_mismatch | "name mismatch" | ชื่อเจ้าของบัญชีไม่ตรงกัน |
ค่าสถานะการโอน
| สถานะ | คำอธิบาย |
|---|---|
pending | การโอนอยู่ในคิวรอการประมวลผล |
sent | การโอนถูกส่งไปยังระบบธนาคาร |
paid | เงินถึงบัญชีธนาคารของผู้รับ |
failed | การโอนล้มเหลว (ตรวจสอบ failure_code) |
แนวทางปฏิบัติที่ดีที่สุด
- ยืนยันผู้รับก่อนเริ่มต้นการโอน
- ตรวจสอบยอดคงเหลือเพื่อให้แน่ใจว่ามีเงินเพียงพอ
- ใช้ metadata สำหรับการกระทบยอดและการติดตาม
- ใช้งาน webhooks เพื่อตรวจสอบการเปลี่ยนแปลงสถานะการโอน
- จัดการความล้มเหลวอย่างเหมาะสมด้วยตรรกะการลองใหม่
- ทดสอบอย่างละเอียดในโหมดทดสอบก่อนประมวลผลการโอนจริง
แหล่งข้อมูลที่เกี่ยวข้อง
- API ผู้รับ - จัดการบัญชีธนาคารผู้รับ
- API ยอดคงเหลือ - ตรวจสอบยอดคงเหลือที่ใช้ได้
- API ธุรกรรม - ดูประวัติธุรกรรม
- Webhooks - รับการอัปเดตสถานะการโอน
ต้องการความช่วยเหลือ? ติดต่อ support@omise.co สำหรับขีดจำกัดการโอน เวลาในการประมวลผล หรือความช่วยเหลือในการเชื่อมต่อ