สร้างคำสั่งถอนเงิน
ร้านค้าสามารถใช้ API endpoint นี้เพื่อถอนเงินจากยอดคงเหลือของร้านค้าไปยังผู้เล่น
URL : /withdraw/create
Method : POST
ข้อกำหนดข้อมูล
{
"merchant_id" : "[Merchant id]",
"token" : "[Auth Token]",
"time" : "[Time Stamp]",
"merchant_order_id" : "[unique merchant order id]",
"amount" : "[amount]",
"bank" : "[bank code]",
"account_no" : "[account number]",
"account_name" : "[account name]" ,
"notify_url" : "[notify url]"
}
คำอธิบาย
| ชื่อพารามิเตอร์ | คำอธิบาย | ตัวอย่าง |
|---|---|---|
| merchant_order_id | หมายเลขอ้างอิงที่ไม่ซ้ำกันในระบบของร้านค้า อนุญาตตัวอักษร: 0-9 a-z A-Z ความยาวสูงสุด = 40 | ORDER0123456789789445566 |
| amount | จำนวนเงิน ทศนิยม 2 ตำแหน่ง ไม่ใส่ตัวคั่นหลักพัน | 1000.00 |
| bank | รหัสธนาคาร | KBANK |
| account_no | เลขที่บัญชี | 1234567890 |
| account_name | ชื่อบัญชี | สมชาย นามสมมุติ |
| notify_url | URL สำหรับรับ Webhook แจ้งเตือน URL นี้จะถูกเรียกเมื่อสถานะการถอนเงินมีการอัปเดต | https://merchant.com/callback/withdraw |
ตัวอย่างข้อมูล
{
"merchant_id": "AA12345678",
"token": "testtokentesttokentesttokentesttokentesttoken",
"time": 1656272222,
"merchant_order_id" : "ORDER112233445566",
"amount" : "1000.00",
"bank" : "KBANK",
"account_no" : "1234567890",
"account_name" : "สมชาย นามสมมุติ" ,
"notify_url" : "https://merchant.com/callback/withdraw"
}
Response
พารามิเตอร์ใน response มีดังนี้
| พารามิเตอร์ | คำอธิบาย |
|---|---|
| platform_order_id | รหัสคำสั่งซื้อเฉพาะของระบบ ใช้สำหรับระบุคำสั่งซื้อ |
| merchant_order_id | รหัสคำสั่งซื้อของร้านค้า |
| order_datetime | วันเวลาสร้างคำสั่งซื้อ |
| bank | รหัสธนาคาร ดูรหัสธนาคารด้านล่าง |
| account_no | เลขที่บัญชี |
| account_name | ชื่อบัญชี |
| amount | จำนวนเงิน |
Response สำเร็จ
Code : 200 OK
ตัวอย่างข้อมูล
{
"success": 200,
"data": {
"platform_order_id": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"merchant_order_id": "ORDER112233445566",
"order_datetime": "2024-04-28 21:49:39",
"bank": "KBANK",
"account_no": "1234567890",
"account_name": "สมชาย นามสมมุติ",
"amount": "1000.00"
}
}
Response ข้อผิดพลาด
เงื่อนไข : กรณี merchant id, token หรือ signature ไม่ถูกต้อง
Code : 403 BAD REQUEST
ข้อมูล :
{
"error": {
"code": 403,
"message": "authentication failed"
}
}
เงื่อนไข : กรณีเกิดข้อผิดพลาดอื่นๆ
Code : 500 ERROR
ข้อมูล :
{
"error": {
"code": 500,
"message": "amount must be greater than 20"
}
}
รหัสธนาคาร
| รหัสธนาคาร | ธนาคาร |
|---|---|
| KBANK | ธนาคารกสิกรไทย |
| BBL | ธนาคารกรุงเทพ |
| KTB | ธนาคารกรุงไทย |
| TTB | ธนาคารทีทีบี |
| SCB | ธนาคารไทยพาณิชย์ |
| UOB | ธนาคารยูโอบี |
| BAY | ธนาคารกรุงศรีอยุธยา |
| CIMB | ธนาคารซีไอเอ็มบี ไทย |
| LH | ธนาคารแลนด์ แอนด์ เฮ้าส์ |
| GSB | ธนาคารออมสิน |
| KK | ธนาคารเกียรตินาคินภัทร |
| CITI | ธนาคารซิตี้แบงก์ |
| GHB | ธนาคารอาคารสงเคราะห์ |
| BAAC | ธนาคารเพื่อการเกษตรและสหกรณ์การเกษตร |
| TISCO | ธนาคารทิสโก้ |
| CLICX | ธนาคารคลิกซ์ |