วงจรรายการจ่ายเงิน

รายการจ่ายเงิน (payout) คือการโอนเงินจากยอดคงเหลือของคุณไปยังบัญชีธนาคารของผู้ชำระเงิน เช่น ถอนเงินรางวัลหรือคืนเงินให้ลูกค้า

ภาพรวม

 สร้างรายการ ─┬─ ยอดไม่เกินเกณฑ์ ─► สร้างใหม่ ─► เข้าคิว ─► ส่งธนาคารแล้ว ─► สำเร็จ
             │                      (pending)   (processing)  (processing)   (succeeded)
             │                                        │             │
             │                                        └──────┬──────┘
             │                                               ▼
             │                                           ผิดพลาด (failed) ─► ลองใหม่ หรือ ยกเลิก
             │
             └─ ยอดเกินเกณฑ์ ─► รอตรวจสอบ (in_review) ─┬─ อนุมัติ ─► สร้างใหม่ ─► ...
                                                     └─ ไม่อนุมัติ ─► ยกเลิกแล้ว (canceled)

ขั้นตอน

1. คุณสร้างรายการ

   ระบบของคุณเรียก POST /v1/payouts พร้อมผู้ชำระเงิน ยอดเงิน และ URL สำหรับแจ้งผล เงินจะโอนเข้าบัญชีธนาคารที่ลงทะเบียนไว้ของผู้ชำระเงินคนนั้น ดู จ่ายเงิน (API)

   ระบบตรวจว่า ยอดพร้อมใช้ พอสำหรับยอดจ่ายรวมค่าธรรมเนียม แล้ว กันยอด นั้นไว้ทันที ยอดพร้อมใช้จึงลดลงตั้งแต่ตอนนี้

2. ตรวจสอบรายการยอดสูง (ถ้ามี)

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

   • อนุมัติ: รายการกลับเป็น สร้างใหม่ และทำงานต่อ ระบบส่ง webhook payout.pending
   • ไม่อนุมัติ: รายการเป็น ยกเลิกแล้ว คืนยอดที่กันไว้ และส่ง webhook payout.canceled

   เกณฑ์นี้ผู้ให้บริการเป็นผู้กำหนด ถ้าต้องการเปลี่ยน ติดต่อฝ่ายสนับสนุน

3. ระบบโอนเงิน

   ระบบนำรายการเข้าคิว (เข้าคิว) แล้วส่งคำสั่งโอนให้ธนาคาร (ส่งธนาคารแล้ว) ปกติใช้เวลาไม่กี่นาที

4. ได้ผลลัพธ์

   เมื่อธนาคารยืนยัน รายการเป็น สำเร็จ ยอดที่กันไว้ถูกตัดจริง ระบบส่ง webhook payout.succeeded และแสดง เวลาจ่ายเงินสำเร็จ ในหน้า จ่ายเงิน

รายการที่ผิดพลาด

ถ้าธนาคารปฏิเสธหรือส่งคำสั่งไม่สำเร็จ รายการจะเป็น ผิดพลาด (failed) ช่อง ข้อความสถานะรายการ ในหน้ารายละเอียด (หรือ failureReason ใน API) บอกสาเหตุจากธนาคาร

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

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

ยกเลิกรายการ

ยกเลิกผ่าน POST /v1/payouts/{id}/cancel ได้เมื่อรายการเป็น

สถานะ	ยกเลิกได้เมื่อ
สร้างใหม่ (pending), เข้าคิว, ผิดพลาด (failed)	ทุกเวลา
ส่งธนาคารแล้ว	สร้างรายการมาแล้วเกิน 30 นาที และธนาคารยืนยันการยกเลิก
รอตรวจสอบ, สำเร็จ, ยกเลิกแล้ว	ยกเลิกไม่ได้

ยกเลิกสำเร็จแล้วยอดที่กันไว้จะคืนทันที การยกเลิกผ่าน API ไม่ส่ง webhook หน้าเว็บจัดการของพาร์ทเนอร์ไม่มีปุ่มยกเลิกรายการจ่ายเงิน ถ้าต้องการให้ช่วยยกเลิก ติดต่อฝ่ายสนับสนุนพร้อม UUID

อย่าสร้างรายการซ้ำระหว่างที่รายการเดิมยังไม่จบ

ผู้ชำระเงินหนึ่งรายมีรายการจ่ายเงินที่ยังไม่จบได้ครั้งละหนึ่งรายการ (pending_payout_exists) ถ้ารายการเดิม ผิดพลาด ให้ยกเลิกก่อนแล้วจึงสร้างใหม่ เพื่อไม่ให้จ่ายซ้ำ

ข้อผิดพลาดที่พบบ่อยตอนสร้างรายการ

รหัสใน API	สาเหตุ	ทำอย่างไร
insufficient_balance	ยอดพร้อมใช้ไม่พอ	เติมยอด หรือรอรายการรับเงินเข้า
pending_payout_exists	ผู้ชำระเงินมีรายการจ่ายที่ยังไม่จบ	รอรายการเดิมจบ หรือยกเลิกก่อน
amount_below_minimum / amount_above_maximum	ยอดนอกวงเงินต่อรายการ	ปรับยอด หรือขอเปลี่ยนวงเงิน
no_payout_account_available	ไม่มีบัญชีจ่ายเงินที่พร้อมใช้ในขณะนั้น	ลองใหม่ภายหลัง ถ้าเกิดต่อเนื่อง ติดต่อฝ่ายสนับสนุน
payouts_disabled	บัญชีของคุณปิดการจ่ายเงิน	ติดต่อฝ่ายสนับสนุน