สร้างคำสั่งถอนเงิน

ร้านค้าสามารถใช้ 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 ความยาวสูงสุด = 40ORDER0123456789789445566
amountจำนวนเงิน ทศนิยม 2 ตำแหน่ง ไม่ใส่ตัวคั่นหลักพัน1000.00
bankรหัสธนาคารKBANK
account_noเลขที่บัญชี1234567890
account_nameชื่อบัญชีสมชาย นามสมมุติ
notify_urlURL สำหรับรับ 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ธนาคารคลิกซ์