Skip to content

ตรวจสอบสถานะรายการรับชำระเงิน (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หมายเลขคำสั่งซื้อของร้านค้า (ห้ามซ้ำกัน, ตัวอักษร+ตัวเลข, ความยาวไม่เกิน 32 ตัวอักษร)

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

json
{
  "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"
  }
}
json
{
  "code": 0,
  "msg": "param merchant error"
}

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

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