ตรวจสอบสถานะรายการรับชำระเงิน (Pay-in)

ร้านค้าสามารถตรวจสอบสถานะและข้อมูลโดยละเอียดของรายการรับชำระเงินผ่านช่องทางนี้

---

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

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

---

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

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

---

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

พารามิเตอร์	จำเป็น	ประเภท	คำอธิบาย
timestamp	ใช่	Long	ประทับเวลาเป็นมิลลิวินาที (Millisecond timestamp)
merchantOrderNo	ใช่	string	หมายเลขคำสั่งซื้อของร้านค้า (ห้ามซ้ำกัน)

---

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

ตอบกลับสำเร็จ

{
  "code": 1,
  "msg": "success",
  "data": {
    "merchantNo": "M1639466186292",
    "merchantOrderNo": "202112151143188593456",
    "platOrderNo": "876324486452871168",
    "amount": "220.00",
    "fee": "2.20",
    "payType": "payType",
    "payUrl": "payUrl",
    "expireTime": "2026-05-05 11:11:11",
    "status": "1"
  }
}

ตอบกลับล้มเหลว

{
  "code": 0,
  "msg": "param merchant error"
}

---

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

พารามิเตอร์	ประเภท	คำอธิบาย
code	string / number	1 สำเร็จ, 0 ล้มเหลว
msg	string	คำอธิบายผลลัพธ์
data	object	ข้อมูลรายการที่ส่งคืนเมื่อการร้องขอสำเร็จ
└ merchantNo	string	หมายเลขร้านค้า
└ merchantOrderNo	string	หมายเลขคำสั่งซื้อของร้านค้า
└ platOrderNo	string	หมายเลขคำสั่งซื้อของแพลตฟอร์ม
└ amount	string	จำนวนเงิน
└ fee	string	ค่าธรรมเนียมบริการ
└ payType	string	ประเภทช่องทางชำระเงิน: THAI_DYNAMIC_QR, BANK
└ payUrl	string	ลิงก์สำหรับชำระเงิน
└ expireTime	string	เวลาหมดอายุของคำสั่งซื้อ (รูปแบบ: yyyy-MM-dd HH:mm:ss)
└ status	string	สถานะคำสั่งซื้อ: 0 สร้างสำเร็จ, 1 อยู่ระหว่างดำเนินการ, 2 ล้มเหลว, 3 สำเร็จ