สร้างคำสั่งจ่ายเงิน (Pay-out)
ร้านค้าสามารถส่งคำสั่งขอโอนเงินหรือจ่ายเงินไปยังบัญชีธนาคารปลายทางที่ระบุผ่านช่องทางนี้
ข้อมูลอินเทอร์เฟซ
- ที่อยู่เชื่อมต่อ (URL):
/payout/create - วิธีการร้องขอ:
POST - Content-Type:
application/json; charset=utf-8
พารามิเตอร์ส่วนหัว (Header)
| พารามิเตอร์ | จำเป็น | ประเภท | คำอธิบาย |
|---|---|---|---|
| merchantNo | ใช่ | string | หมายเลขร้านค้า (Merchant Number) |
| sign | ใช่ | string | ลายมือชื่อดิจิทัล RSA (โปรดอ้างอิงหน้า "คำอธิบายทั่วไป") |
พารามิเตอร์ส่วนเนื้อหา (Request Body)
| พารามิเตอร์ | ค่าตัวอย่าง | จำเป็น | ประเภท | คำอธิบาย |
|---|---|---|---|---|
| timestamp | 1639466186292 | ใช่ | Long | ประทับเวลาเป็นมิลลิวินาที (Millisecond timestamp) |
| merchantOrderNo | 20211215114318859 | ใช่ | string | หมายเลขคำสั่งซื้อของร้านค้า (ห้ามซ้ำกัน) |
| amount | 220.00 | ใช่ | string | จำนวนเงินโอน (ทศนิยมไม่เกิน 2 ตำแหน่ง) |
| payType | BANK | ใช่ | string | ประเภทการจ่ายเงิน: ปัจจุบันกำหนดเป็น BANK (โอนผ่านธนาคาร) เท่านั้น |
| bankCode | SCB | ใช่ | string | รหัสธนาคารปลายทาง (โปรดดูตารางรหัสธนาคารด้านล่าง) |
| accountNo | 1234567890 | ใช่ | string | หมายเลขบัญชีธนาคารผู้รับเงิน |
| accountName | Somchai | ใช่ | string | ชื่อบัญชีผู้รับเงิน |
| mobile | 0612345678 | ใช่ | string | เบอร์โทรศัพท์ของผู้รับเงิน (ต้องขึ้นต้นด้วย 06, 08 หรือ 09) |
| notifyUrl | https://... | ใช่ | string | URL สำหรับแจ้งผลการโอนเงินกลับไปยังร้านค้าแบบอะซิงโครนัส |
| accountType | INDIVIDUAL | ไม่ | string | ประเภทผู้รับเงิน: INDIVIDUAL (บุคคลธรรมดา), ORGANIZATION (นิติบุคคล) |
| accountTaxId | 1234567890123 | ไม่ | string | เลขประจำตัวผู้เสียภาษี / เลขบัตรประชาชน / เลขจดทะเบียนนิติบุคคล ของผู้รับเงิน |
test@example.com | ไม่ | string | อีเมลผู้รับเงิน | |
| remark | payout remark | ไม่ | string | หมายเหตุ |
ตัวอย่างการตอบกลับ
json
{
"code": 1,
"msg": "ok",
"data": {
"merchantNo": "M1639466186292",
"merchantOrderNo": "202112151143188593456",
"platOrderNo": "876324486452871168",
"amount": "220.00",
"fee": "220.00",
"status": "0"
}
}json
{
"code": 0,
"msg": "param merchant error"
}คำอธิบายพารามิเตอร์ส่งกลับ
| พารามิเตอร์ | ประเภท | คำอธิบาย |
|---|---|---|
| code | number | 1 สำเร็จ, 0 ล้มเหลว |
| msg | string | คำอธิบายผลลัพธ์ |
| data | object | ข้อมูลรายการที่ส่งคืนเมื่อโอนเงินสำเร็จ |
| └ merchantNo | string | หมายเลขร้านค้า |
| └ merchantOrderNo | string | หมายเลขคำสั่งซื้อของร้านค้า |
| └ platOrderNo | string | หมายเลขคำสั่งซื้อของแพลตฟอร์ม |
| └ amount | string | จำนวนเงินโอน |
| └ fee | string | ค่าธรรมเนียมบริการ |
| └ status | string | สถานะรายการจ่ายเงิน: 0 สร้างคำสั่งแล้ว, 1 อยู่ระหว่างโอนเงิน, 2 ล้มเหลว, 3 สำเร็จ |
รายการรหัสธนาคาร (Bank Code List)
เมื่อทำการโอนเงิน (Pay-out) จำเป็นต้องระบุรหัสธนาคารปลายทาง bankCode ให้ตรงกับข้อมูลธนาคารดังต่อไปนี้:
| bankCode | ชื่อธนาคาร (EN) | ชื่อธนาคาร (TH) |
|---|---|---|
| BAAC | BANK FOR AGRICULTURE AND AGRICULTURAL COOPERATIVES | ธ. เพื่อการเกษตรและสหกรณ์การเกษตร |
| BAY | BANK OF AYUDHYA PUBLIC COMPANY LIMITED | ธ. กรุงศรีอยุธยา จำกัด (มหาชน) |
| BBL | BANGKOK BANK PUBLIC COMPANY LTD. | ธ. กรุงเทพ จำกัด (มหาชน) |
| CIMBT | CIMB THAI BANK PUPBLIC COMPANY LTD. | ธ. ซีไอเอ็มบี ไทย จำกัด (มหาชน) |
| CITI | CITIBANK, N.A. | ธ. ซิตี้แบงก์ |
| GHB | THE GOVERNMENT HOUSING BANK | ธ. อาคารสงเคราะห์ |
| GSB | THE GOVERNMENT SAVINGS BANK | ธ. ออมสิน |
| ISBT | ISLAMIC BANK OF THAILAND | ธ. อิสลามแห่งประเทศไทย |
| ICBCT | INDUSTRIAL AND COMMERCIAL BANK OF CHINA (THAI) PUBLIC COMPANY LIMITED | ธ. ไอซีบีซี (ไทย) จำกัด (มหาชน) |
| KBANK | KASIKORNBANK PUBLIC COMPANY LTD. | ธ. กสิกรไทย จำกัด (มหาชน) |
| KK | KIATNAKIN BANK PUBLIC COMPANY LIMITED | ธ. เกียรตินาคิน จำกัด (มหาชน) |
| KTB | KRUNG THAI BANK PUBLIC COMPANY LTD. | ธ. กรุงไทย จำกัด (มหาชน) |
| LHBANK | LAND AND HOUSES BANK PUBLIC COMPANY LIMITED | ธ. แลนด์แอนด์เฮ้าส์ จำกัด (มหาชน) |
| MIZUHO | MIZUHO CORPORATE BANK, LTD. | ธ. มิซูโฮ คอร์ปอเรต จำกัด |
| SCB | SIAM COMMERCIAL BANK PUBLIC COMPANY LTD | ธ. ไทยพาณิชย์ จำกัด (มหาชน) |
| SCBT | STANDARD CHARTERED BANK (THAI) PUBLIC COMPANY LIMITED | ธ. สแตนดาร์ดชาร์เตอร์ด (ไทย) จำกัด (มหาชน) |
| SMBC | SUMITOMO MITSUI BANKING CORPORATION | ธ. ซูมิโตโม มิตซุย แบงกิ้ง คอร์ปอเรชั่น |
| TBANK | THANACHART BANK PUBLIC COMPANY LTD. | ธ. ธนชาต จำกัด (มหาชน) |
| TCR | THE THAI CREDIT RETAIL BANK PUBLIC COMPANY LIMITED | ธ. ไทยเครดิต เพื่อรายย่อย จำกัด (มหาชน) |
| TISCO | TISCO BANK PUBLIC COMPANY LIMITED | ธ. ทิสโก้ จำกัด (มหาชน) |
| TMB | TMB BANK PUBLIC COMPANY LIMITED | ธ. ทหารไทย จำกัด (มหาชน) |
| TTB | TMBTHANACHART BANK PUBLIC COMPANY LIMITED | ธ. ทหารไทยธนชาต จำกัด (มหาชน) |
| UOBT | UNITED OVERSEAS BANK (THAI) PUBLIC COMPANY LIMITED | ธ. ยูโอบี จำกัด (มหาชน) |
| BOT | BANK OF THAILAND | ธนาคารแห่งประเทศไทย |
| JPMC | JPMORGAN CHASE BANK, BANGKOK BRANCH | ธนาคารเจพีมอร์แกน เชส สาขากรุงเทพฯ |
| MEGA ICBC | MEGA INTERNATIONAL COMMERCIAL BANK PUBLIC COMPANY LIMITED | ธนาคารเมกะ สากลพาณิชย์ จำกัด (มหาชน) |
| AMERICA | BANK OF AMERICA NATIONAL ASSOCIATION | ธนาคารออฟอเมริกา เนชั่นแนล แอสโซซิเอชัน |
| HSBC | THE HONGKONG AND SHANGHAI BANKING CORPORATION LIMITED | ธนาคารฮ่องกงและเซี่ยงไฮ้แบงกิ้งคอร์ปอเรชั่น จำกัด |
| DB | DEUTSCHE BANK AKTIENGESELLSCHAFT | ธนาคารดอยซ์แบงก์ |
| ANZ | ANZ BANK (THAI) PUBLIC COMPANY LIMITED | ธนาคารเอเอ็นแซด (ไทย) จำกัด (มหาชน) |
| SMTB | SUMITOMO MITSUI TRUST BANK (THAI) PCL | ธนาคารซูมิโตโม มิตซุย ทรัสต์ (ไทย) จำกัด (มหาชน) |
| KTC | KRUNGTHAI CARD PUBLIC COMPANY LIMITED | บริษัท บัตรกรุงไทย จำกัด (มหาชน) |
| AEON | AEON Thana Sinsap (Thailand) Public Company Limited | บริษัท อิออน ธนสินทรัพย์ (ประเทศไทย) จำกัด (มหาชน) |
| BOC | BANK OF CHINA (THAI) | ธนาคารแห่งประเทศจีน (ไทย) จำกัด |
