ภาพรวม

ภาพรวมนี้สรุปขั้นตอนการ "สั่งซื้อผ่าน Google" และการโต้ตอบกับบริการการดําเนินการตามคําสั่งซื้อของคุณ

การเรียงลำดับ

อินเทอร์เฟซผู้ใช้ของ "สั่งซื้อผ่าน Google" จะจัดการการโต้ตอบทั้งหมดกับผู้ใช้ เนื่องจากผู้ใช้เพิ่มรายการในเมนูลงในคําสั่งซื้อ และตัดสินใจเกี่ยวกับการไปรับที่ร้านหรือการจัดส่ง ขึ้นอยู่กับบริการที่นําเสนอโดยร้านอาหาร ประสบการณ์การใช้งานนี้ขับเคลื่อนโดยเอนทิตี Restaurant, Service และ Menu ที่อยู่ในฟีดข้อมูล

ขั้นตอนถัดไปคือการตรวจสอบความถูกต้องของรถเข็น ซึ่งประมวลผลโดยบริการเว็บที่ Cart สร้างโดยผู้ใช้

การดําเนินการชําระเงิน

การดําเนินการกับการชําระเงินเป็นการเรียกครั้งแรกโดย Google ไปยังปลายทางบริการบนเว็บของคุณ บริการเว็บของคุณมีหน้าที่รับผิดชอบการตรวจสอบความถูกต้องของ Cart คุณต้องยืนยันความพร้อมจําหน่ายสินค้าและราคาของสินค้า คํานวณและคืนภาษี ส่วนลด และค่าธรรมเนียม รวมถึงตรวจสอบที่อยู่สําหรับนําส่งคําสั่งซื้อ

ขั้นตอนการชําระเงินจะแสดงตามลําดับดังนี้

  1. บริการ "สั่งซื้อผ่าน Google" จะส่ง CheckoutRequestMessage ที่มี Cart ไปยังปลายทางบริการการดําเนินการคําสั่งซื้อของคุณ
  2. บริการเว็บของคุณต้องตรวจสอบความถูกต้องของรายการใน Cart โดยอิงตามราคา ความพร้อมให้บริการ และผู้ให้บริการในปัจจุบัน จากนั้นจะคํานวณ ราคารวมที่รวมส่วนลด ภาษี และค่าจัดส่ง
  3. ปลายทางตอบกลับด้วย CheckoutResponseMessage ที่มี Cart ที่ไม่ได้แก้ไขสําหรับคําขอที่สําเร็จ คุณรวม FoodErrorExtension ไว้ใน CheckoutResponseMessage เพื่อเพิ่มข้อผิดพลาดในการประมวลผลหรือเสนอการเปลี่ยนแปลงเล็กๆ น้อยๆ ได้หากจําเป็น

หลังจากตรวจสอบ Cart แล้ว ผู้ใช้อาจเลือกดําเนินการต่อไปยังขั้นตอนการส่งคําสั่งซื้อของขั้นตอนได้

ส่งการดําเนินการเกี่ยวกับคําสั่งซื้อ

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

ขั้นตอนการส่งคําสั่งซื้อจะเรียงตามลําดับต่อไปนี้

  1. บริการ "สั่งซื้อผ่าน Google" จะส่ง SubmitOrderRequestMessage ที่มี Order ไปยังปลายทางบริการการดําเนินการคําสั่งซื้อของคุณ แบ็กเอนด์ของคุณต้องดําเนินการตรวจสอบ Cart อีกครั้งก่อนดําเนินการต่อ

  2. บริการเว็บจะประมวลผลรายละเอียดการชําระเงินที่พบใน Order โดยทั่วไปจะดําเนินการต่อไปนี้

    1. ยืนยันโทเค็น ฉ้อโกง และตรวจสอบสิทธิ์อื่นๆ
    2. ให้สิทธิ์และเรียกเก็บเงินจากบัตรหากต้องการ

  3. ปลายทางตอบกลับด้วย SubmitOrderResponseMessage ที่มี OrderUpdate ที่มีสถานะ CREATED ("เรียงลําดับแล้ว&; สถานะการซื้อ), CONFIRMED ("ยอมรับ" สถานะการซื้อ) หรือ REJECTED ("ปฏิเสธที่ถูกปฏิเสธ&; สถานะการซื้อ)

เมื่อมีการสั่งซื้อ ผู้ใช้คาดว่าจะได้รับการอัปเดตสถานะการสั่งซื้อจากทั้งคุณและอินเทอร์เฟซผู้ใช้ของ Order with Google คุณจะต้องส่งอีเมลยืนยัน คําสั่งซื้อให้กับผู้ใช้ นอกจากนี้ คุณยังสามารถใช้ API การอัปเดตข้อมูลแบบอะซิงโครนัสสําหรับส่งการอัปเดตคําสั่งซื้อที่เกี่ยวข้องไปยัง Google ได้

การดําเนินการอัปเดตคําสั่งซื้อแบบไม่พร้อมกัน

คุณต้องส่งการอัปเดตสถานะการสั่งซื้อไปยัง Google สําหรับเหตุการณ์ต่อไปนี้ ทั้งนี้ขึ้นอยู่กับการแจ้งเตือนใดๆ ของผู้ใช้

  1. การเปลี่ยนแปลง OrderState เช่น การเปลี่ยนจาก CREATED เป็น CONFIRMED และ CONFIRMED เป็น IN_TRANSIT
  2. การเปลี่ยนแปลงสินค้าในรายการสั่งซื้อ เช่น ราคาหรือความพร้อมจําหน่ายสินค้า
  3. เมื่อใดก็ตามที่ผู้ใช้เรียกคําขอการสนับสนุนจากช่องการสนับสนุนลูกค้าช่องใดช่องหนึ่งของคุณ

ระบบจะส่งการอัปเดตจากบริการเว็บของคุณในฐานะ AsyncOrderUpdateRequestMessage ที่มี OrderUpdate Google ตอบสนองด้วย AsyncOrderUpdateResponseMessage

แผนภาพลําดับ

ภาพประกอบต่อไปนี้แสดงให้เห็นว่าการดําเนินการตามคําสั่งซื้อมีผลกับบริการบนเว็บของคุณอย่างไร คลิกเพื่อขยาย

ขั้นตอนการดําเนินการตามคําสั่งซื้อกับ Google

ตั้งค่าปลายทางของการดําเนินการตามคําสั่งซื้อ

การดําเนินการ "สั่งซื้อผ่าน Google" จะใช้ข้อความ JSON เพื่อสื่อสารกับบริการเว็บของคุณ รวมถึงประมวลผลการประมวลผล การยืนยัน และการอัปเดตคําสั่งซื้ออาหาร เมื่อออกแบบบริการบนเว็บสําหรับ "สั่งซื้อผ่าน Google" คุณต้องกําหนดปลายทาง URL ที่รับข้อความคําขอจากบริการ "สั่งซื้อผ่าน Google" และจะส่งคืนข้อความกลับไปยังบริการของ Google ได้ การติดตั้งใช้งานต้องเป็นไปตามข้อกําหนดต่อไปนี้

  • บริการเว็บของคุณต้องสามารถรับข้อความ JSON เป็นคําขอ POST จากบริการ "สั่งซื้อผ่าน Google"
  • บริการเว็บต้องระบุปลายทาง URL ที่เข้าถึงได้แบบสาธารณะ ซึ่งเรียกว่า URL การดําเนินการตามคําสั่งซื้อ ซึ่งคุณระบุในพอร์ทัลของพาร์ทเนอร์ URL การดําเนินการตามคําสั่งซื้อจะใช้เพื่อชําระเงินและส่งคําสั่งซื้อ การใช้งานของคุณต้องจัดการกับคําขอทั้ง 2 ประเภท
  • บริการเว็บของคุณต้องยืนยันข้อความจาก Google ได้โดยใช้วิธีการยืนยันข้อความ
  • การใช้งานปลายทาง URL ของคุณต้องสามารถจัดการทั้งจุดชําระเงินและดําเนินการตามคําสั่งซื้อด้วยปลายทางเดียว คุณมีปลายทาง URL 1 รายการ สําหรับการชําระเงินและปลายทางแยกต่างหากสําหรับการส่งคําสั่งซื้อไม่ได้

ไลบรารีไคลเอ็นต์

โปรแกรมสร้างรหัสไคลเอ็นต์ในส่วนเครื่องมือพร้อมให้ใช้งานเพื่อตรวจสอบบริการเว็บของคุณกับข้อกําหนดของ API การดําเนินการตามคําสั่งซื้อ