Skip to content

Create Pay-out Order ​

Merchants initiate pay-out (remittance/transfer) requests to specified bank accounts via this interface.


Interface Info ​

  • Endpoint: /payout/create
  • HTTP Method: POST
  • Content-Type: application/json; charset=utf-8

Request Header Parameters ​

ParameterRequiredTypeDescription
merchantNoYesstringMerchant Number
signYesstringRSA Signature (Refer to Global Specification)

Request Body Parameters ​

ParameterExample ValueRequiredTypeDescription
timestamp1639466186292YesLongMillisecond timestamp
merchantOrderNo20211215114318859YesstringMerchant order number (Unique, letters + numbers, max length 32)
amount220.00YesstringPay-out amount (up to 2 decimal places)
payTypeBANKYesstringPayment Type: Currently fixed to BANK (Bank Transfer)
bankCodeSCBYesstringPayer's destination Bank Code (Refer to Bank Code List below)
accountNo1234567890YesstringRecipient Bank Account Number
accountNameSomchaiYesstringRecipient Account Name
mobile0612345678YesstringRecipient mobile number. Format: must start with 06, 08, or 09
notifyUrlhttps://...YesstringAsynchronous callback notification URL
accountTypeINDIVIDUALNostringRecipient Type: INDIVIDUAL, ORGANIZATION
accountTaxId1234567890123NostringRecipient ID / Tax ID or Corporate Registration Number
emailtest@example.comNostringRecipient Email
remarkpayout remarkNostringRemarks

Response Examples ​

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"
}

Response Parameter Description ​

ParameterTypeDescription
codenumber1 for Success, 0 for Failure
msgstringMessage explanation
dataobjectReturned data payload
└ merchantNostringMerchant Number
└ merchantOrderNostringMerchant Order Number
└ platOrderNostringPlatform Order Number
└ amountstringTransaction Amount
└ feestringService Fee
└ statusstringStatus: 0 Created, 1 Processing, 2 Failed, 3 Success

Bank Code List ​

When initiating a pay-out transfer, the bankCode must be chosen from the following list:

Supported Time Slots:

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