Create Withdraw

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

‼️‼️รายการถอน ห้ามตั้งเวลาหมดอายุรายการ ให้รีเช็คสถานะรายการด้วยการ Resend Callback เท่านั้น และห้ามยิง Retry โดยเด็ดขาด‼️‼️

รายละเอียด Endpoint

POST /api/v1/client/create_withdraw

Headers

Name	Value
Authorization	Bearer YOUR_SECRET_TOKEN
x-api-key	YOUR_API_KEY
x-signature	YOUR_BASE64_ENCODED_SIGNATURE

Body

JSON

{
  "amount":0,
  "dest_bank_acc_no": "",
  "dest_bank_acc_name": "",
  "dest_bank_code": "",
  "withdraw_code": "",
  "callback_url": "",
  "order_id": ""
}

Fields	Type	Required	Description
amount	number	Required	จำนวนเงินที่ต้องการฝาก มีรูปแบบเป็นตัวเลขพร้อมทศนิยม 2 ตำแหน่ง (ไม่มี comma) เช่น 1000.00 หมายเหตุ: ในบางกรณีระบบอาจปรับค่าเล็กน้อยเพื่อใช้จับคู่กับ QR Code
dest_bank_acc_no	string	Required	เลขบัญชีผู้ถอน
dest_bank_ac_name	string	Required	ชื่อบัญชีผู้ถอน
dest_bank_code	string	Required	รหัสธนาคารของผู้ถอน
withdraw_code	string	Optional	รหัส Pin Code ที่ใส่ยืนยันรายการเมื่อรายการถอนมียอดถอนมากกว่าขั้นต่ำ
callback_url	string	Optional	URL สำหรับรับ Callback หากต้องการเปลี่ยนเฉพาะคำสั่งนี้ หากไม่ระบุ ระบบจะใช้ค่าเริ่มต้นที่ตั้งไว้ในหน้า Profile ของร้านค้า
order_id	string	Optional	ของรายการร้านค้า

---

ตัวอย่างการเรียกใช้งาน (Request Example)​​

curl -X POST https://baseUrl/api/v1/client/create_withdraw
-H "Authorization: Bearer YOUR_SECRET_TOKEN" \
-H "x-api-key: YOUR_API_KEY" \
-H "x-signature: YOUR_BASE64_ENCODED_SIGNATURE" \
-H "Content-Type: application/json" \
-d '{
  "amount": 500,
  "dest_bank_acc_no": "9876543210",
  "dest_bank_acc_name": "John Doe",
  "dest_bank_code": "004",
  "withdraw_code": "635124",
  "callback_url": "https://yourcallbackurl.com",
  "order_id": "123e4567-426614174000"
}'

---

การตอบกลับจาก API (Response Example)

Successful Response (HTTP 200)

{
  "status": "string",
  "ref_id": "string",
  "dest_bank_code": "string",
  "dest_bank_acc_no": "string",
  "dest_bank_acc_name": "string",
  "amount": 0,
  "withdraw_time": "string"
}

Validation Error (HTTP 422)

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Callback Response

เมื่อทำการเรียก API เพื่อสร้างการถอนเงิน/client/create_withdrawระบบจะส่งข้อมูลการถอนกลับไปที่ URL callback ที่คุณได้ตั้งค่าไว้ในระบบ

เมื่อการทำรายการสำเร็จ ระบบจะส่ง callback กลับไปที่ URL ที่ได้ตั้งค่าไว้ในระบบ โดยมีโครงสร้างข้อมูลดังนี้

{
  "type": "WITHDRAW",
  "status": "", //AUTO_SUCCESS ,FAILED
  "status_desc": "",
  "amount": 0,
  "mdr_amount": 0,
  "stm_desc": "",
  "stm_ref_id": "",
  "stm_bank_code": "",
  "stm_bank_acc_no": "",
  "stm_bank_acc_name": "",
  "stm_timestamp": "",
  "txn_ref_id": "",
  "txn_ref_user_id": "",
  "txn_ref1": "",
  "txn_ref2": "",
  "txn_ref_order_id": "",
  "txn_ref_bank_code": "",
  "txn_ref_bank_acc_no": "",
  "txn_ref_bank_acc_name_en": "",
  "txn_ref_bank_acc_name_th": "",
  "txn_timestamp": "",
}  

Status	Description
PROCESSING	กำลังดำเนินการ
AUTO_SUCCESS	ถอนสำเร็จ
PENDING_CONFIRM	รอร้านค้ายืนยันรายการด้วย Withdraw Code(Pin)
FAILED	ถอนล้มเหลว รหัสธนาคารของผู้ถอน

Callback สำหรับรายการสำเร็จและไม่สำเร็จมีข้อมูลเหมือนกัน ต่างกันที่ Status เท่านั้น

---

JaveScript Example

JaveScript Example

const axios = require('axios')

try {
  const { data } = await axios.post(
    `${baseUrl}/api/v1/client/create_withdraw`,
    {
      amount: 500, // จำนวนเงินที่ต้องการถอน
      dest_bank_acc_no: "9876543210", // หมายเลขบัญชีธนาคารปลายทาง
      dest_bank_acc_name: "John Doe", // ชื่อเจ้าของบัญชีปลายทาง
      dest_bank_code: "004", // รหัสธนาคารปลายทาง (ตัวอย่างคือรหัสธนาคารกรุงเทพ)
      withdraw_code: "635124", // รหัสการถอน (ที่ระบบจะใช้ตรวจสอบ)
      callback_url: "https://yourcallbackurl.com", // URL ที่จะรับข้อมูลเมื่อการทำรายการเสร็จสิ้น
      order_id: "123e4567-426614174000" // รหัสคำสั่งถอนที่ไม่ซ้ำ
    },
    {
      headers: { // การตั้งค่าหัวข้อต่างๆ ที่จำเป็นในการส่งคำขอ
        Authorization: 'Bearer YOUR_ACCESS_TOKEN', // ใส่ Access Token ของคุณที่ได้รับ
        'x-api-key': 'YOUR_API_KEY', // ใส่ API Key ของคุณที่ได้รับ
        'x-signature': 'YOUR_BASE64_ENCODED_SIGNATURE', // ใส่ลายเซ็นที่เข้ารหัส
        'Content-Type': 'application/json' // ระบุว่า Content-Type เป็น JSON
      },
    }
  )
} 

PHP Example

<?php
$baseUrl = "https://yourapi.com"; // ใส่ URL ของ API ที่ต้องการเรียก
$accessToken = "YOUR_ACCESS_TOKEN"; // ใส่ Access Token ของคุณ
$apiKey = "YOUR_API_KEY"; // ใส่ API Key ของคุณ
$signature = "YOUR_BASE64_ENCODED_SIGNATURE"; // ใส่ลายเซ็นที่เข้ารหัส

// ข้อมูลที่ต้องการส่งไปใน body ของ request
$data = [
    'amount' => 500,
    'dest_bank_acc_no' => '9876543210',
    'dest_bank_acc_name' => 'John Doe',
    'dest_bank_code' => '004',
    'withdraw_code' => '635124',
    'callback_url' => 'https://yourcallbackurl.com',
    'order_id' => '123e4567-426614174000'
];

// ใช้ cURL ในการส่ง HTTP POST request
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "$baseUrl/api/v1/client/create_withdraw");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data)); // ส่งข้อมูลในรูปแบบ JSON
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer $accessToken",
    "x-api-key: $apiKey",
    "x-signature: $signature",
    "Content-Type: application/json"
]);

// รับค่าผลลัพธ์จากการเรียก API
$response = curl_exec($ch);

// ปิดการเชื่อมต่อ cURL
curl_close($ch);

// สามารถทำงานกับ response ได้ตามที่ต้องการ
echo $response;
?>

---