Skip to content

แจ้งเตือนผลการโอนเงินกลับ (Pay-out Notification)

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


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

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