代付订单创建

商户通过此接口向指定的银行账户发起下发（代付/转账）请求。

---

接口信息

• 接口地址: /payout/create
• 请求方法: POST
• Content-Type: application/json; charset=utf-8

---

请求 Header 参数

参数名	必填	类型	说明
merchantNo	是	string	商户号
sign	是	string	签名（参见全局说明）

---

请求 Body 参数

参数名	示例值	必选	类型	说明
timestamp	1639466186292	是	Long	毫秒时间戳
merchantOrderNo	20211215114318859	是	string	商户订单号（唯一）
amount	220.00	是	string	代付金额（最多保留两位小数）
payType	BANK	是	string	支付类型：目前固定为 BANK（银行卡转账）
bankCode	SCB	是	string	收款银行编码（参见下方银行编码列表）
accountNo	1234567890	是	string	收款银行账户
accountName	Somchai	是	string	收款人姓名
mobile	0612345678	是	string	收款人电话。格式：以 06, 08 或 09 开头
notifyUrl	https://...	是	string	异步通知回调地址
accountType	INDIVIDUAL	否	string	收款人类别：INDIVIDUAL（个人），ORGANIZATION（企业）
accountTaxId	1234567890123	否	string	收款人身份证件号 / 企业注册编号
email	test@example.com	否	string	邮箱
remark	payout remark	否	string	备注

---

返回示例

成功返回

{
  "code": 1,
  "msg": "ok",
  "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) 列表

进行代付转账时，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)	ธนาคารแห่งประเทศจีน (ไทย) จำกัด