การถอนเงิน (Withdrawals)

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

POST /v1/withdrawals

ฟิลด์

ฟิลด์	จำเป็น	คำอธิบาย
`amount`	ใช่	ยอดที่ถอน เป็นเงินบาท (สตริงทศนิยม) หักจากยอดคงเหลือของคุณ
`currency`	ไม่	สกุลเงินที่จะได้รับ `THB` (ค่าเริ่มต้น), `USD` หรือ `USDT`
`channel`	ใช่	`bank_transfer` หรือ `crypto`
`bankName`	เมื่อ `bank_transfer`	ชื่อหรือรหัสธนาคาร (สูงสุด 100 ตัว)
`bankAccountName`	เมื่อ `bank_transfer`	ชื่อบัญชี
`bankAccountNumber`	เมื่อ `bank_transfer`	เลขบัญชี ตัวเลขและ `-` 4-32 ตัว
`walletAddress`	เมื่อ `crypto`	ที่อยู่ wallet
`network`	เมื่อ `crypto`	เครือข่าย เช่น `TRC20`
`note`	ไม่	หมายเหตุถึงทีมงาน (สูงสุด 500 ตัว)

รับเฉพาะฟิลด์ข้างต้น ฟิลด์อื่นจะถูกปฏิเสธด้วย parameter_unknown

ส่ง header Idempotency-Key เพื่อให้การส่งซ้ำหลัง timeout ไม่สร้างคำขอถอนเงินซ้ำ ดูส่งคำขอสร้างรายการซ้ำอย่างปลอดภัย

{
  "amount": "10000.00",
  "channel": "bank_transfer",
  "bankName": "SCB",
  "bankAccountName": "Example Co., Ltd.",
  "bankAccountNumber": "123-4-56789-0",
  "note": "January settlement"
}

Object ของ withdrawal

response (201)

{
  "data": {
    "object": "withdrawal",
    "id": "wd_0a1b2c3d4e5f60718293a4b5c6d7e8f9",
    "status": "pending",
    "channel": "bank_transfer",
    "requestedAmount": "10000.00",
    "fee": "50.00",
    "netAmount": "9950.00",
    "currency": "THB",
    "payoutAmount": "9950.00",
    "exchangeRate": "1.000000",
    "bankAccount": {
      "bankName": "SCB",
      "accountName": "Example Co., Ltd.",
      "accountNumber": "123-4-56789-0"
    },
    "wallet": null,
    "note": "January settlement",
    "createdAt": "2026-01-01T00:00:00.000Z"
  },
  "requestId": "req_..."
}

ฟิลด์	คำอธิบาย
`requestedAmount`	ยอดที่ขอถอน (บาท)
`fee`	ค่าธรรมเนียม (บาท)
`netAmount`	ยอดหลังหักค่าธรรมเนียม (บาท)
`currency`, `payoutAmount`	สกุลเงินและยอดที่จะได้รับจริง
`exchangeRate`	อัตราแลกเปลี่ยนที่ใช้เมื่อถอนเป็น `USD` หรือ `USDT`
`bankAccount` / `wallet`	ปลายทาง ตาม `channel` อีกฟิลด์จะเป็น `null`

สถานะ

สถานะ	ความหมาย
`pending`	ส่งคำขอแล้ว รอทีมงานตรวจ
`processing`	กำลังโอน
`succeeded`	โอนสำเร็จ
`rejected`	ถูกปฏิเสธ

ข้อผิดพลาดที่พบบ่อย

HTTP	`code`	ความหมาย
400	`parameter_missing`	ขาดฟิลด์ปลายทางตาม `channel` ดู `error.param`
400	`parameter_invalid`	รูปแบบยอดหรือเลขบัญชีไม่ถูกต้อง
400	`unsupported_currency`	สกุลเงินที่ไม่รองรับ
409	`pending_withdrawal_exists`	มีคำขอถอนที่กำลังดำเนินการอยู่ ส่งได้ทีละรายการ
422	`amount_invalid`	ยอดต้องมากกว่า 0
422	`insufficient_balance`	ยอดคงเหลือที่ใช้ได้ไม่พอ
422	`daily_limit_exceeded`	เกิน `dailyWithdrawalLimit` ของวันนี้