Skip to content

代付订单创建 ​

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


接口信息 ​

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

请求 Header 参数 ​

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

请求 Body 参数 ​

参数名示例值必选类型说明
timestamp1639466186292是Long毫秒时间戳
merchantOrderNo20211215114318859是string商户订单号(唯一,字母+数字,最大长度32)
amount220.00是string代付金额(最多保留两位小数)
payTypeBANK是string支付类型:目前固定为 BANK(银行卡转账)
bankCodeSCB是string收款银行编码(参见下方银行编码列表)
accountNo1234567890是string收款银行账户
accountNameSomchai是string收款人姓名
mobile0612345678是string收款人电话。格式:以 06, 08 或 09 开头
notifyUrlhttps://...是string异步通知回调地址
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) 列表 ​

进行代付转账时,bankCode 必须为以下列表中的其中之一:

支持时间段说明:

  • 全天: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ธ. เพื่อการเกษตรและสหกรณ์การเกษตร全天
BAYBANK OF AYUDHYA PUBLIC COMPANY LIMITEDธ. กรุงศรีอยุธยา จำกัด (มหาชน)全天
BBLBANGKOK BANK PUBLIC COMPANY LTD.ธ. กรุงเทพ จำกัด (มหาชน)全天
CIMBTCIMB THAI BANK PUPBLIC COMPANY LIMITEDธ. ซีไอเอ็มบี ไทย จำกัด (มหาชน)全天
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ธ. ซูมิโตโม มิตซุย แบงกิ้ง คอร์ปอเรชั่น白天
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ธนาคารเจพีมอร์แกน เชส สาขากรุงเทพฯ白天
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)ธนาคารแห่งประเทศจีน (ไทย) จำกัด白天