สร้างคำสั่งจ่ายเงิน (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	หมายเลขคำสั่งซื้อของร้านค้า (ห้ามซ้ำกัน, ตัวอักษร+ตัวเลข, ความยาวไม่เกิน 32 ตัวอักษร)
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	เลขประจำตัวผู้เสียภาษี / เลขบัตรประชาชน / เลขจดทะเบียนนิติบุคคล ของผู้รับเงิน
email	test@example.com	ไม่	string	อีเมลผู้รับเงิน
remark	payout remark	ไม่	string	หมายเหตุ

---

ตัวอย่างการตอบกลับ

ตอบกลับสำเร็จ

{
  "code": 1,
  "msg": "success",
  "data": {
    "merchantNo": "M1639466186292",
    "merchantOrderNo": "202112151143188593456",
    "platOrderNo": "876324486452871168",
    "amount": "220.00",
    "fee": "220.00",
    "status": "0"
  }
}

ตอบกลับล้มเหลว

{
  "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 LIMITED	ธ. ซีไอเอ็มบี ไทย จำกัด (มหาชน)	กลางวัน
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	ธ. ยูโอบี จำกัด (มหาชน)	กลางวัน