Skip to content

Create Pay-in Order ​

Merchants initiate pay-in (collection) orders via this interface. The platform generates a corresponding payment URL or parameters for the user to complete the payment.


Interface Info ​

  • Endpoint: /payin/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 ​

ParameterRequiredTypeDescription
timestampYesLongMillisecond timestamp
merchantOrderNoYesstringMerchant order number (Unique, letters + numbers, max length 32)
amountYesstringOrder amount (up to 2 decimal places)
payTypeYesstringPayment Type: QR (Aggregate QR Code),
bankCodeNostringBank Code. Required when payType is BANK
accountNoNostringBank Account Number. Required when payType is BANK
accountNameYesstringAccount Name / Payer Name
mobileYesstringPayer's mobile number. Format: must start with 06, 08, or 09
notifyUrlYesstringAsynchronous callback notification URL
emailNostringPayer Email
remarkNostringRemarks
expireSecondsNostringExpiration time in seconds, range 30–3600. Defaults to system configuration if not provided

Response Examples ​

json
{
  "code": 1,
  "msg": "success",
  "data": {
    "merchantNo": "M1639466186292",
    "merchantOrderNo": "202112151143188593456",
    "platOrderNo": "876324486452871168",
    "amount": "220.00",
    "fee": "0",
    "payType": "payType",
    "payUrl": "payUrl",
    "qrcode": "qrcode",
    "expireTime": "2026-05-05 11:11:11",
    "status": "1"
  }
}
json
{
  "code": 0,
  "msg": "param merchant error"
}

Response Parameter Description ​

ParameterTypeDescription
codenumber1 for Success, 0 for Failure
msgstringMessage explanation
dataobjectReturned data payload upon success
└ merchantNostringMerchant Number
└ merchantOrderNostringMerchant Order Number
└ platOrderNostringPlatform Order Number
└ amountstringAmount
└ feestringService Fee
└ payTypestringPayment Type: THAI_DYNAMIC_QR, BANK
└ payUrlstringPayment URL / Invocation parameter
└ qrcodestringQR code content (use payUrl if this field is not returned)
└ expireTimestringExpiration Time (Format: yyyy-MM-dd HH:mm:ss)
└ statusstringStatus: 0 Created, 1 Processing, 2 Failed, 3 Success

Bank Code List ​

When payType is BANK, 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 LTD.ธ. ซีไอเอ็มบี ไทย จำกัด (มหาชน)24/7
CLICXCLICX BANKCLICX BANK24/7
EXIMEXIM BANKธนาคารเพื่อการส่งออกและนำเข้าแห่งประเทศไทย24/7
GHBTHE GOVERNMENT HOUSING BANKธ. อาคารสงเคราะห์24/7
GSBTHE GOVERNMENT SAVINGS BANKธ. ออมสิน24/7
ISLAMICISLAMIC BANKธนาคารอิสลามแห่งประเทศไทย24/7
KBANKKASIKORNBANK PUBLIC COMPANY LTD.ธ. กสิกรไทย จำกัด (มหาชน)24/7
KTBKRUNG THAI BANK PUBLIC COMPANY LTD.ธ. กรุงไทย จำกัด (มหาชน)24/7
LHBANKLAND AND HOUSES BANK PUBLIC COMPANY LIMITEDธ. แลนด์แอนด์เฮ้าส์ จำกัด (มหาชน)24/7
SCBSIAM COMMERCIAL BANK PUBLIC COMPANY LTDธ. ไทยพาณิชย์ จำกัด (มหาชน)24/7
SCBTSTANDARD CHARTERED BANK (THAI) PUBLIC COMPANY LIMITEDธ. สแตนดาร์ดชาร์เตอร์ด (ไทย) จำกัด (มหาชน)24/7
SMESME BANKธ. พัฒนาวิสาหกิจขนาดกลางและขนาดย่อม24/7
TCRTHE THAI CREDIT RETAIL BANK PUBLIC COMPANY LIMITEDธ. ไทยเครดิต เพื่อรายย่อย จำกัด (มหาชน)24/7
TISCOTISCO BANK PUBLIC COMPANY LIMITEDธ. ทิสโก้ จำกัด (มหาชน)24/7
TTBTMBTHANACHART BANK PUBLIC COMPANY LIMITEDธ. ทหารไทยธนชาต จำกัด (มหาชน)24/7
UOBTUNITED OVERSEAS BANK (THAI) PUBLIC COMPANY LIMITEDธ. ยูโอบี จำกัด (มหาชน)24/7