แจ้งเตือนผลการชำระเงินกลับ (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 | หมายเหตุพารามิเตอร์ที่ร้านค้าส่งตอนสร้างคำสั่งซื้อ (แพลตฟอร์มส่งกลับค่าเดิม) |
