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หมายเลขคำสั่งซื้อของร้านค้า (ห้ามซ้ำกัน)
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 ให้ตรงกับข้อมูลธนาคารดังต่อไปนี้:

bankCodeชื่อธนาคาร (EN)ชื่อธนาคาร (TH)
BAACBANK FOR AGRICULTURE AND AGRICULTURAL COOPERATIVESธ. เพื่อการเกษตรและสหกรณ์การเกษตร
BAYBANK OF AYUDHYA PUBLIC COMPANY LIMITEDธ. กรุงศรีอยุธยา จำกัด (มหาชน)
BBLBANGKOK BANK PUBLIC COMPANY LTD.ธ. กรุงเทพ จำกัด (มหาชน)
CIMBTCIMB THAI BANK PUPBLIC COMPANY LTD.ธ. ซีไอเอ็มบี ไทย จำกัด (มหาชน)
CITICITIBANK, N.A.ธ. ซิตี้แบงก์
GHBTHE GOVERNMENT HOUSING BANKธ. อาคารสงเคราะห์
GSBTHE GOVERNMENT SAVINGS BANKธ. ออมสิน
ISBTISLAMIC BANK OF THAILANDธ. อิสลามแห่งประเทศไทย
ICBCTINDUSTRIAL AND COMMERCIAL BANK OF CHINA (THAI) PUBLIC COMPANY LIMITEDธ. ไอซีบีซี (ไทย) จำกัด (มหาชน)
KBANKKASIKORNBANK PUBLIC COMPANY LTD.ธ. กสิกรไทย จำกัด (มหาชน)
KKKIATNAKIN BANK PUBLIC COMPANY LIMITEDธ. เกียรตินาคิน จำกัด (มหาชน)
KTBKRUNG THAI BANK PUBLIC COMPANY LTD.ธ. กรุงไทย จำกัด (มหาชน)
LHBANKLAND AND HOUSES BANK PUBLIC COMPANY LIMITEDธ. แลนด์แอนด์เฮ้าส์ จำกัด (มหาชน)
MIZUHOMIZUHO CORPORATE BANK, LTD.ธ. มิซูโฮ คอร์ปอเรต จำกัด
SCBSIAM COMMERCIAL BANK PUBLIC COMPANY LTDธ. ไทยพาณิชย์ จำกัด (มหาชน)
SCBTSTANDARD CHARTERED BANK (THAI) PUBLIC COMPANY LIMITEDธ. สแตนดาร์ดชาร์เตอร์ด (ไทย) จำกัด (มหาชน)
SMBCSUMITOMO MITSUI BANKING CORPORATIONธ. ซูมิโตโม มิตซุย แบงกิ้ง คอร์ปอเรชั่น
TBANKTHANACHART BANK PUBLIC COMPANY LTD.ธ. ธนชาต จำกัด (มหาชน)
TCRTHE THAI CREDIT RETAIL BANK PUBLIC COMPANY LIMITEDธ. ไทยเครดิต เพื่อรายย่อย จำกัด (มหาชน)
TISCOTISCO BANK PUBLIC COMPANY LIMITEDธ. ทิสโก้ จำกัด (มหาชน)
TMBTMB BANK PUBLIC COMPANY LIMITEDธ. ทหารไทย จำกัด (มหาชน)
TTBTMBTHANACHART BANK PUBLIC COMPANY LIMITEDธ. ทหารไทยธนชาต จำกัด (มหาชน)
UOBTUNITED OVERSEAS BANK (THAI) PUBLIC COMPANY LIMITEDธ. ยูโอบี จำกัด (มหาชน)
BOTBANK OF THAILANDธนาคารแห่งประเทศไทย
JPMCJPMORGAN CHASE BANK, BANGKOK BRANCHธนาคารเจพีมอร์แกน เชส สาขากรุงเทพฯ
MEGA ICBCMEGA INTERNATIONAL COMMERCIAL BANK PUBLIC COMPANY LIMITEDธนาคารเมกะ สากลพาณิชย์ จำกัด (มหาชน)
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)ธนาคารแห่งประเทศจีน (ไทย) จำกัด