Skip to content

สร้างคำสั่งจ่ายเงิน (Pay-out) ​

ร้านค้าสามารถส่งคำสั่งขอโอนเงินหรือจ่ายเงินไปยังบัญชีธนาคารปลายทางที่ระบุผ่านช่องทางนี้


ข้อมูลอินเทอร์เฟซ ​

  • ที่อยู่เชื่อมต่อ (URL): /payout/create
  • วิธีการร้องขอ: POST
  • Content-Type: application/json; charset=utf-8

พารามิเตอร์ส่วนหัว (Header) ​

พารามิเตอร์จำเป็นประเภทคำอธิบาย
merchantNoใช่stringหมายเลขร้านค้า (Merchant Number)
signใช่stringลายมือชื่อดิจิทัล RSA (โปรดอ้างอิงหน้า "คำอธิบายทั่วไป")

พารามิเตอร์ส่วนเนื้อหา (Request Body) ​

พารามิเตอร์ค่าตัวอย่างจำเป็นประเภทคำอธิบาย
timestamp1639466186292ใช่Longประทับเวลาเป็นมิลลิวินาที (Millisecond timestamp)
merchantOrderNo20211215114318859ใช่stringหมายเลขคำสั่งซื้อของร้านค้า (ห้ามซ้ำกัน, ตัวอักษร+ตัวเลข, ความยาวไม่เกิน 32 ตัวอักษร)
amount220.00ใช่stringจำนวนเงินโอน (ทศนิยมไม่เกิน 2 ตำแหน่ง)
payTypeBANKใช่stringประเภทการจ่ายเงิน: ปัจจุบันกำหนดเป็น BANK (โอนผ่านธนาคาร) เท่านั้น
bankCodeSCBใช่stringรหัสธนาคารปลายทาง (โปรดดูตารางรหัสธนาคารด้านล่าง)
accountNo1234567890ใช่stringหมายเลขบัญชีธนาคารผู้รับเงิน
accountNameSomchaiใช่stringชื่อบัญชีผู้รับเงิน
mobile0612345678ใช่stringเบอร์โทรศัพท์ของผู้รับเงิน (ต้องขึ้นต้นด้วย 06, 08 หรือ 09)
notifyUrlhttps://...ใช่stringURL สำหรับแจ้งผลการโอนเงินกลับไปยังร้านค้าแบบอะซิงโครนัส
accountTypeINDIVIDUALไม่stringประเภทผู้รับเงิน: INDIVIDUAL (บุคคลธรรมดา), ORGANIZATION (นิติบุคคล)
accountTaxId1234567890123ไม่stringเลขประจำตัวผู้เสียภาษี / เลขบัตรประชาชน / เลขจดทะเบียนนิติบุคคล ของผู้รับเงิน
emailtest@example.comไม่stringอีเมลผู้รับเงิน
remarkpayout 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"
}

คำอธิบายพารามิเตอร์ส่งกลับ ​

พารามิเตอร์ประเภทคำอธิบาย
codenumber1 สำเร็จ, 0 ล้มเหลว
msgstringคำอธิบายผลลัพธ์
dataobjectข้อมูลรายการที่ส่งคืนเมื่อโอนเงินสำเร็จ
└ merchantNostringหมายเลขร้านค้า
└ merchantOrderNostringหมายเลขคำสั่งซื้อของร้านค้า
└ platOrderNostringหมายเลขคำสั่งซื้อของแพลตฟอร์ม
└ amountstringจำนวนเงินโอน
└ feestringค่าธรรมเนียมบริการ
└ statusstringสถานะรายการจ่ายเงิน: 0 สร้างคำสั่งแล้ว, 1 อยู่ระหว่างโอนเงิน, 2 ล้มเหลว, 3 สำเร็จ

รายการรหัสธนาคาร (Bank Code List) ​

เมื่อทำการโอนเงิน (Pay-out) จำเป็นต้องระบุรหัสธนาคารปลายทาง bankCode ให้ตรงกับข้อมูลธนาคารดังต่อไปนี้:

ช่วงเวลาที่รองรับ:

  • ตลอด 24 ชั่วโมง: 00:00:00 - 23:59:59
  • กลางวัน: 07:00:00 - 23:59:59
  • กลางคืน: 00:00:00 - 06:59:59
bankCodeชื่อธนาคาร (EN)ชื่อธนาคาร (TH)ช่วงเวลาที่รองรับ
BAACBANK FOR AGRICULTURE AND AGRICULTURAL COOPERATIVESธ. เพื่อการเกษตรและสหกรณ์การเกษตรตลอด 24 ชม.
BAYBANK OF AYUDHYA PUBLIC COMPANY LIMITEDธ. กรุงศรีอยุธยา จำกัด (มหาชน)ตลอด 24 ชม.
BBLBANGKOK BANK PUBLIC COMPANY LTD.ธ. กรุงเทพ จำกัด (มหาชน)ตลอด 24 ชม.
CIMBTCIMB THAI BANK PUPBLIC COMPANY LIMITEDธ. ซีไอเอ็มบี ไทย จำกัด (มหาชน)ตลอด 24 ชม.
CITICITIBANK, N.A.ธ. ซิตี้แบงก์กลางวัน
GHBTHE GOVERNMENT HOUSING BANKธ. อาคารสงเคราะห์ตลอด 24 ชม.
GSBTHE GOVERNMENT SAVINGS BANKธ. ออมสินตลอด 24 ชม.
ISBTISLAMIC BANK OF THAILANDธ. อิสลามแห่งประเทศไทยกลางวัน
ICBCTINDUSTRIAL AND COMMERCIAL BANK OF CHINA (THAI) PUBLIC COMPANY LIMITEDธ. ไอซีบีซี (ไทย) จำกัด (มหาชน)กลางวัน
KBANKKASIKORNBANK PUBLIC COMPANY LTD.ธ. กสิกรไทย จำกัด (มหาชน)ตลอด 24 ชม.
KKKIATNAKIN BANK PUBLIC COMPANY LIMITEDธ. เกียรตินาคิน จำกัด (มหาชน)กลางวัน
KTBKRUNG THAI BANK PUBLIC COMPANY LTD.ธ. กรุงไทย จำกัด (มหาชน)ตลอด 24 ชม.
LHBANKLAND AND HOUSES BANK PUBLIC COMPANY LIMITEDธ. แลนด์แอนด์เฮ้าส์ จำกัด (มหาชน)กลางวัน
MIZUHOMIZUHO CORPORATE BANK, LTD.ธ. มิซูโฮ คอร์ปอเรต จำกัดกลางวัน
SCBSIAM COMMERCIAL BANK PUBLIC COMPANY LTDธ. ไทยพาณิชย์ จำกัด (มหาชน)ตลอด 24 ชม.
SCBTSTANDARD CHARTERED BANK (THAI) PUBLIC COMPANY LIMITEDธ. สแตนดาร์ดชาร์เตอร์ด (ไทย) จำกัด (มหาชน)กลางวัน
SMBCSUMITOMO MITSUI BANKING CORPORATIONธ. ซูมิโตโม มิตซุย แบงกิ้ง คอร์ปอเรชั่นกลางวัน
TCRTHE THAI CREDIT RETAIL BANK PUBLIC COMPANY LIMITEDธ. ไทยเครดิต เพื่อรายย่อย จำกัด (มหาชน)กลางวัน
TISCOTISCO BANK PUBLIC COMPANY LIMITEDธ. ทิสโก้ จำกัด (มหาชน)กลางวัน
TMBTMB BANK PUBLIC COMPANY LIMITEDธ. ทหารไทย จำกัด (มหาชน)กลางวัน
TTBTMBTHANACHART BANK PUBLIC COMPANY LIMITEDธ. ทหารไทยธนชาต จำกัด (มหาชน)ตลอด 24 ชม.
UOBTUNITED OVERSEAS BANK (THAI) PUBLIC COMPANY LIMITEDธ. ยูโอบี จำกัด (มหาชน)ตลอด 24 ชม.
BOTBANK OF THAILANDธนาคารแห่งประเทศไทยกลางวัน
JPMCJPMORGAN CHASE BANK, BANGKOK BRANCHธนาคารเจพีมอร์แกน เชส สาขากรุงเทพฯกลางวัน
AMERICABANK OF AMERICA NATIONAL ASSOCIATIONธนาคารออฟอเมริกา เนชั่นแนล แอสโซซิเอชันกลางวัน
HSBCTHE HONGKONG AND SHANGHAI BANKING CORPORATION LIMITEDธนาคารฮ่องกงและเซี่ยงไฮ้แบงกิ้งคอร์ปอเรชั่น จำกัดกลางวัน
DBDEUTSCHE BANK AKTIENGESELLSCHAFTธนาคารดอยซ์แบงก์กลางวัน
ANZANZ BANK (THAI) PUBLIC COMPANY LIMITEDธนาคารเอเอ็นแซด (ไทย) จำกัด (มหาชน)กลางวัน
SMTBSUMITOMO MITSUI TRUST BANK (THAI) PCLธนาคารซูมิโตโม มิตซุย ทรัสต์ (ไทย) จำกัด (มหาชน)กลางวัน
KTCKRUNGTHAI CARD PUBLIC COMPANY LIMITEDบริษัท บัตรกรุงไทย จำกัด (มหาชน)กลางวัน
AEONAEON Thana Sinsap (Thailand) Public Company Limitedบริษัท อิออน ธนสินทรัพย์ (ประเทศไทย) จำกัด (มหาชน)กลางวัน
BOCBANK OF CHINA (THAI)ธนาคารแห่งประเทศจีน (ไทย) จำกัดกลางวัน