Webhook และการแจ้งเตือนเหตุการณ์

หากต้องการส่งการแจ้งเตือนไปยังระบบภายนอกโดยอัตโนมัติเมื่อมีเหตุการณ์เกิดขึ้นในฝั่ง Receipt Roller ให้ใช้ Webhook ไม่จำเป็นต้องทำการ Polling และสามารถรับเหตุการณ์ได้แบบเรียลไทม์

การลงทะเบียน Webhook

• เปิดหน้าจอจัดการองค์กร ไปที่ "นักพัฒนา" → "Webhook"
• เลือก "ลงทะเบียนใหม่" แล้วระบุ URL ปลายทางที่ใช้รับข้อมูล (ต้องเป็น HTTPS) และเหตุการณ์ที่ต้องการรับ
• จะมีการออก Secret Key สำหรับตรวจสอบลายเซ็น กรุณาบันทึกเก็บไว้

เหตุการณ์หลัก

• เหตุการณ์ยอดขาย/คำสั่งซื้อ (ยอดขายใหม่ การคืนเงิน การยกเลิก)
• เหตุการณ์ใบเสร็จ (ออกใบเสร็จอิเล็กทรอนิกส์ การดาวน์โหลด)
• เหตุการณ์สินค้า/สต๊อก (เปลี่ยนแปลงราคา การเปลี่ยนแปลงสต๊อก)
• เหตุการณ์ร้านค้า/พนักงาน (เพิ่มร้านค้า เพิ่ม/ลาออกของพนักงาน)

จุดสำคัญในการติดตั้งฝั่งผู้รับ

• กรุณาตรวจสอบ Header ลายเซ็นที่ส่งมาด้วย (เพื่อป้องกันการปลอมแปลง)
• กรุณาตอบกลับด้วยสถานะ 2xx โดยเร็วที่สุด แนะนำให้ประมวลผลแบบ Asynchronous
• หากล้มเหลวจะมีการส่งซ้ำโดยอัตโนมัติ กรุณาออกแบบให้รองรับการประมวลผลซ้ำ (Idempotent)

ข้อมูลรายละเอียดสำหรับนักพัฒนา

กรุณาดูข้อมูล Payload ของแต่ละเหตุการณ์ ตัวอย่างโค้ดสำหรับตรวจสอบลายเซ็น และช่วงเวลาของการส่งซ้ำ ได้ที่ Developer Help

https://receiptroller.io/th-TH/developer/help

บทความที่เกี่ยวข้อง

• ภาพรวมของ Developer API
• เอกสารอ้างอิง API Reference