ส่งคำสั่งซื้อไปยัง Zapier, Make และแอปอื่น ๆ ด้วย Webhook

Webhook จะส่งเหตุการณ์ในร้านค้าของคุณไปยังแอปอื่นทันทีที่เกิดขึ้น เมื่อเพิ่ม Webhook แล้ว คำสั่งซื้อที่ชำระเงินแล้วทุกรายการจะส่งถึง Zapier หรือ Make ได้ และจากนั้นไปยัง Google Sheets, Slack, รายชื่ออีเมลของคุณ, แอปบัญชีของคุณ และแอปอื่นอีกนับพัน โดยไม่ต้องเขียนโค้ด

เพิ่ม Webhook

1. ในแดชบอร์ดเว็บไซต์ของคุณ คลิก การเชื่อมต่อ
2. ภายใต้ ระบบอัตโนมัติ เปิด Webhook ป๊อปอัปจะเปิดขึ้น

   

3. เลือก เหตุการณ์ วาง ที่อยู่ Webhook ที่แอปของคุณให้มา แล้วคลิก เพิ่ม Webhook
4. คลิก ส่งการทดสอบ เพื่อส่งคำสั่งซื้อตัวอย่าง แล้วคลิก เสร็จ

   

Webhook จะเริ่มทำงานทันทีที่คุณเพิ่ม ไม่ต้องเผยแพร่

เชื่อมต่อกับ Zapier

1. ใน Zapier สร้าง Zap โดยเลือก Webhooks by Zapier เป็นทริกเกอร์ แล้วเลือก Catch Hook
2. คัดลอก URL ของ Webhook ที่ Zapier แสดง
3. ใน Payly เพิ่ม Webhook สำหรับ ชำระเงินคำสั่งซื้อแล้ว แล้ววาง URL นั้น
4. คลิก ส่งการทดสอบ จากนั้นกลับไปที่ Zapier แล้วคลิก Test trigger คุณจะเห็นคำสั่งซื้อตัวอย่าง #9999 ของ John Smith
5. เพิ่มแอคชันที่ต้องการ เช่น เพิ่มแถวใหม่ใน Google Sheets แล้วจับคู่ฟิลด์ ได้แก่ Order Number, Order Total, Order Customer Email และอื่น ๆ
6. เผยแพร่ Zap ของคุณ จากนั้นทุกคำสั่งซื้อที่ชำระเงินแล้วจะเรียกใช้ Zap นี้

Webhooks by Zapier เป็นแอปพรีเมียมของ Zapier จึงต้องใช้แผน Zapier แบบเสียเงิน

เชื่อมต่อกับ Make

1. ใน Make สร้างซีนาริโอ เพิ่ม Webhooks แล้วเพิ่ม Custom webhook จากนั้นคลิก Add เพื่อสร้าง Webhook ใหม่
2. คัดลอกที่อยู่ที่ Make แสดง
3. ใน Payly เพิ่ม Webhook ด้วยที่อยู่นั้น แล้วคลิก ส่งการทดสอบ Make จะอ่านตัวอย่างและเรียนรู้ฟิลด์ต่าง ๆ
4. เพิ่มโมดูลที่ต้องการ จับคู่ฟิลด์ แล้วเปิดซีนาริโอ

เหตุการณ์

• ชำระเงินคำสั่งซื้อแล้ว: มีการชำระเงินคำสั่งซื้อ รวมถึงการชำระเงินครั้งแรกของการสมัครสมาชิก การต่ออายุทุกครั้ง และคำสั่งซื้อที่คุณเพิ่มเองโดยระบุว่าชำระเงินแล้ว
• จัดส่งคำสั่งซื้อแล้ว: คุณทำเครื่องหมายคำสั่งซื้อว่าจัดส่งแล้ว หากคุณจัดส่งคำสั่งซื้อเป็นหลายส่วน การจัดส่งแต่ละครั้งจะถูกส่งด้วย
• คืนเงินคำสั่งซื้อแล้ว: มีการคืนเงิน ไม่ว่าคุณจะคืนเงินใน Payly หรือใน Stripe หรือ PayPal การคืนเงินบางส่วนแต่ละครั้งก็ถูกส่งด้วย
• เริ่มการสมัครสมาชิกแล้ว: คำสั่งซื้อแรกของการสมัครสมาชิก
• ต่ออายุการสมัครสมาชิกแล้ว: การชำระเงินทุกครั้งหลังครั้งแรก
• สิ้นสุดการสมัครสมาชิกแล้ว: การสมัครสมาชิกถูกยกเลิกหรือหมดอายุ โดยจะส่งในวันที่สิ้นสุด

สิ่งที่ Payly ส่ง

แต่ละเหตุการณ์จะส่งในรูปแบบ JSON เหตุการณ์คำสั่งซื้อทุกรายการมีข้อมูลต่อไปนี้:

• หมายเลขคำสั่งซื้อ เช่น #1000 สถานะ และเวลาที่ชำระเงิน
• ยอดรวมย่อย ส่วนลดและรหัสส่วนลด ค่าจัดส่ง ภาษี ยอดรวม และจำนวนเงินที่คืน พร้อมสกุลเงิน
• ชื่อ SKU จำนวน ราคา และยอดรวมของสินค้าแต่ละรายการ
• ชื่อ อีเมล และเบอร์โทรของลูกค้า รวมถึงที่อยู่จัดส่ง
• วิธีชำระเงิน เช่น Stripe หรือ PayPal
• test_mode ซึ่งเป็น true สำหรับคำสั่งซื้อที่สั่งในโหมดทดสอบ

การจัดส่งจะเพิ่มบริษัทขนส่งและหมายเลขติดตามพัสดุ การคืนเงินจะเพิ่มยอดที่คืนไปแล้วทั้งหมด เหตุการณ์การสมัครสมาชิกจะเพิ่มแผน ราคา ความถี่ในการเรียกเก็บเงิน และวันต่ออายุครั้งถัดไป ตัวอย่างจาก ส่งการทดสอบ มี "test": true หมายเลขบัตรอยู่กับ Stripe และ PayPal เท่านั้น จึงไม่มีอยู่ใน Webhook เลย

หาก Webhook ล้มเหลว

แอปมีเวลา 5 วินาทีในการตอบกลับ หากไม่ตอบกลับ หรือตอบกลับเป็นข้อผิดพลาด Payly จะลองส่งอีกไม่เกิน 7 ครั้งในเวลาประมาณสี่ชั่วโมงครึ่ง ป๊อปอัปจะแสดงรายการส่งล่าสุดของแต่ละ Webhook เพื่อให้คุณดูได้ว่าเกิดอะไรขึ้น

หากเหตุการณ์ติดต่อกันสามรายการล้มเหลวทุกครั้งที่ลองส่ง Webhook จะถูกหยุดชั่วคราว และหน้าการเชื่อมต่อจะแจ้งไว้ ตรวจสอบที่อยู่ แล้วคลิก เปิดใช้อีกครั้ง

ตรวจสอบว่า Webhook มาจากร้านค้าของคุณ

Zapier และ Make ไม่จำเป็นต้องทำขั้นตอนนี้ หากคุณสร้างแอปเอง ทุกคำขอจะมีเฮดเดอร์ X-Payly-Hmac-Sha256 ซึ่งเป็นเนื้อหาของคำขอที่ลงนามด้วย HMAC-SHA256 โดยใช้รหัสลับสำหรับลงนามของร้านค้าคุณ ในรูปแบบ base64 รหัสลับนี้อยู่ในป๊อปอัป Webhook ให้คำนวณลายเซ็นเดียวกันจากเนื้อหาดิบ แล้วเปรียบเทียบทั้งสองค่า

เฮดเดอร์ X-Payly-Webhook-Id จะมีค่าเดิมเมื่อมีการลองส่งซ้ำ แอปของคุณจึงข้ามรายการที่จัดการไปแล้วได้