Skip to content

สร้างคำสั่งรับชำระเงิน (Pay-in) ​

ร้านค้าสามารถสร้างคำสั่งรับชำระเงิน (เก็บเงิน) ผ่านช่องทางนี้ แพลตฟอร์มจะส่งคืนลิงก์การชำระเงินหรือพารามิเตอร์เพื่อให้ผู้ใช้งานสแกนจ่ายหรือโอนเงินเพื่อทำรายการต่อไป


ข้อมูลอินเทอร์เฟซ ​

  • ที่อยู่เชื่อมต่อ (URL): /payin/create
  • วิธีการร้องขอ: POST
  • Content-Type: application/json; charset=utf-8

พารามิเตอร์ส่วนหัว (Header) ​

พารามิเตอร์จำเป็นประเภทคำอธิบาย
merchantNoใช่stringหมายเลขร้านค้า (Merchant Number)
signใช่stringลายมือชื่อดิจิทัล RSA (โปรดอ้างอิงหน้า "คำอธิบายทั่วไป")

พารามิเตอร์ส่วนเนื้อหา (Request Body) ​

พารามิเตอร์จำเป็นประเภทคำอธิบาย
timestampใช่Longประทับเวลาเป็นมิลลิวินาที (Millisecond timestamp)
merchantOrderNoใช่stringหมายเลขคำสั่งซื้อของร้านค้า (ห้ามซ้ำกัน, ตัวอักษร+ตัวเลข, ความยาวไม่เกิน 32 ตัวอักษร)
amountใช่stringจำนวนเงินที่ต้องการรับชำระ (ทศนิยมไม่เกิน 2 ตำแหน่ง)
payTypeใช่stringประเภทการชำระเงิน: QR (สแกนคิวอาร์โค้ด),
bankCodeไม่stringรหัสธนาคาร (จำเป็นเมื่อ payType เป็น BANK)
accountNoไม่stringหมายเลขบัญชีธนาคาร (จำเป็นเมื่อ payType เป็น BANK)
accountNameใช่stringชื่อบัญชีผู้รับเงิน / ชื่อผู้ชำระเงิน
mobileใช่stringเบอร์โทรศัพท์ของผู้ชำระเงิน (ต้องขึ้นต้นด้วย 06, 08 หรือ 09)
notifyUrlใช่stringURL สำหรับแจ้งผลการชำระเงินกลับไปยังร้านค้าแบบอะซิงโครนัส
emailไม่stringอีเมลผู้ชำระเงิน
remarkไม่stringหมายเหตุพารามิเตอร์เพิ่มเติม
expireSecondsไม่stringเวลาหมดอายุ (หน่วยเป็นวินาที, ช่วง 30–3600), หากไม่ระบุจะใช้ค่าเริ่มต้นของระบบ

ตัวอย่างการตอบกลับ ​

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

คำอธิบายพารามิเตอร์ส่งกลับ ​

พารามิเตอร์ประเภทคำอธิบาย
codenumber1 สำเร็จ, 0 ล้มเหลว
msgstringคำอธิบายผลลัพธ์
dataobjectข้อมูลรายการที่ส่งคืนเมื่อการร้องขอสำเร็จ
└ merchantNostringหมายเลขร้านค้า
└ merchantOrderNostringหมายเลขคำสั่งซื้อของร้านค้า
└ platOrderNostringหมายเลขคำสั่งซื้อของแพลตฟอร์ม
└ amountstringจำนวนเงิน
└ feestringค่าธรรมเนียมบริการ
└ payTypestringประเภทช่องทางชำระเงิน: THAI_DYNAMIC_QR, BANK
└ payUrlstringลิงก์สำหรับชำระเงิน / ข้อมูลเรียกชำระเงิน
└ qrcodestringข้อมูลคิวอาร์โค้ด (หากไม่มีการส่งคืนฟิลด์นี้ กรุณาใช้ payUrl)
└ expireTimestringเวลาหมดอายุของคำสั่งซื้อ (รูปแบบ: yyyy-MM-dd HH:mm:ss)
└ statusstringสถานะคำสั่งซื้อ: 0 สร้างสำเร็จ, 1 อยู่ระหว่างดำเนินการ, 2 ล้มเหลว, 3 สำเร็จ

รายการรหัสธนาคาร (Bank Code List) ​

เมื่อกำหนด payType เป็น BANK จำเป็นต้องระบุค่า bankCode ให้ตรงกับธนาคารดังต่อไปนี้:

ช่วงเวลาที่รองรับ:

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