Skip to content

แจ้งเตือนผลการชำระเงินกลับ (Pay-in Notification)

เมื่อรายการรับชำระเงินเสร็จสิ้นหรือล้มเหลว แพลตฟอร์มจะส่งผลแจ้งเตือนแบบอะซิงโครนัสไปยัง notifyUrl ที่ร้านค้าระบุไว้ตอนสร้างคำสั่งซื้อ


ข้อกำหนดการแจ้งเตือน

  • ที่อยู่รับข้อมูล (URL): notifyUrl ที่ร้านค้าส่งมาตอนสร้างคำสั่งซื้อ
  • วิธีการส่งข้อมูล: POST
  • Content-Type: application/json; charset=utf-8
  • นโยบายการลองใหม่ (Retry Strategy): หลังจากระบบของร้านค้าได้รับและตรวจสอบข้อมูลการแจ้งเตือนเรียบร้อยแล้ว ต้อง ตอบกลับด้วยสตริง SUCCESS (ไม่แยกแยะอักษรพิมพ์เล็กพิมพ์ใหญ่ หรือตอบกลับด้วย HTTP Status 200) เพื่อยืนยันการรับข้อมูล หากแพลตฟอร์มไม่ได้รับการตอบกลับ แพลตฟอร์มจะส่งข้อมูลแจ้งเตือนซ้ำทุกๆ 20 นาที สูงสุด 5 ครั้ง

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

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

ตัวอย่างข้อมูลส่วนเนื้อหา (Request Body)

json
{
  "timestamp": "1639466186292",
  "merchantOrderNo": "ORDER_123456789",
  "platOrderNo": "876324486452871168",
  "amount": "100.00",
  "fee": "1.00",
  "status": "3",
  "msg": "success",
  "remark": "custom_data"
}

คำอธิบายฟิลด์ข้อมูลส่วนเนื้อหา

ฟิลด์ข้อมูลจำเป็นประเภทคำอธิบาย
timestampใช่stringประทับเวลา (Timestamp)
merchantOrderNoใช่stringหมายเลขคำสั่งซื้อของร้านค้า
platOrderNoใช่stringหมายเลขคำสั่งซื้อของแพลตฟอร์ม
amountใช่stringจำนวนเงินคำสั่งซื้อ
feeใช่stringค่าธรรมเนียมบริการ
msgใช่stringข้อความอธิบายสถานะ
statusใช่stringสถานะ: 0 คำสั่งเริ่มต้น, 1 อยู่ระหว่างชำระเงิน, 2 ชำระเงินล้มเหลว, 3 ชำระเงินสำเร็จ
remarkใช่stringหมายเหตุพารามิเตอร์ที่ร้านค้าส่งตอนสร้างคำสั่งซื้อ (แพลตฟอร์มส่งกลับค่าเดิม)