ภาพรวมการชำระเงินแบบเนทีฟ

หากต้องการเปิดใช้การชำระเงินสำหรับผู้ใช้ คุณต้องติดตั้งใช้งานการผสานรวมการชำระเงินแบบเนทีฟ ซึ่งเกี่ยวข้องกับการสร้าง REST API แบบมาตรฐานที่ช่วยให้ Google จัดการขั้นตอนการชำระเงินกับเซิร์ฟเวอร์ของคุณแบบเป็นโปรแกรมได้ วิธีนี้มอบประสบการณ์การใช้งานที่ราบรื่นที่สุดแก่ผู้ใช้ ในขั้นต้น Google จะแสดงอินเทอร์เฟซผู้ใช้สำหรับผู้ซื้อ โดยมีแผนในอนาคตที่จะรองรับประสบการณ์การใช้งานที่เน้นการโต้ตอบมากขึ้น

ขั้นตอนการชำระเงิน

การผสานรวมแบบเนทีฟกำหนดให้คุณต้องสร้าง RESTful API ที่ Google สามารถเรียกเพื่อสร้างและจัดการเซสชันการชำระเงินได้

ขั้นตอนโดยรวมมีดังนี้

  1. สร้างเซสชันการชำระเงิน: ผู้ใช้และตัวแทน (ไม่บังคับ) จะอยู่ในลูปเพื่อเพิ่มสินค้าลงในเซสชัน
  2. ส่งต่อให้ UI ของ Google: เมื่อผู้ใช้ตัดสินใจชำระเงิน ตัวแทน (หากมีส่วนร่วม) จะส่งต่อการควบคุมไปยัง UI ของ Google (ส่งข้อมูลเซสชันการชำระเงิน)
  3. การชำระเงินด้วยตนเอง: ตอนนี้ผู้ใช้จะโต้ตอบกับ UI ของ Google เท่านั้นเพื่อกรอกรายละเอียดการดำเนินการตามคำสั่งซื้อและการชำระเงินที่ละเอียดอ่อน แล้วส่งคำสั่งซื้อ ตัวแทนจะไม่มีส่วนเกี่ยวข้องในส่วนนี้เพื่อให้มั่นใจถึงความแน่นอน
  4. การดำเนินการเสร็จสมบูรณ์และการกลับมา: UI ของ Google จะแสดงหน้า "ขอบคุณ" เพื่อยืนยันคำสั่งซื้อ ผู้ใช้สามารถเปลี่ยนเส้นทางกลับไปยังตัวแทนได้ (ไม่บังคับ) ซึ่งอาจได้รับการแจ้งเตือนการซื้อที่เสร็จสมบูรณ์แล้ว

วงจรสถานะของเซสชันการชำระเงิน

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

  • incomplete: สถานะเริ่มต้นเมื่อสร้างเซสชัน ซึ่งบ่งชี้ว่าข้อมูลที่บังคับ (เช่น วิธีการจัดส่ง ภาษี หรือรายละเอียดผู้ใช้) ขาดหายไปหรือยังไม่ได้คำนวณ
  • ready_for_payment: สถานะที่จะใช้หลังจากผู้ใช้อัปเดตที่อยู่สำหรับจัดส่ง และคุณคำนวณตัวเลือกการจัดส่งและยอดรวมแล้ว แต่ก่อนที่จะสรุปเครื่องมือการชำระเงิน
  • ready_for_complete: สถานะที่จะใช้ระหว่างการเติมข้อมูลออบเจ็กต์การชำระเงินทั้งหมด เมื่อเลือกเครื่องมือการชำระเงินและมีการตรวจสอบรายละเอียดคำสั่งซื้อทั้งหมดแล้ว
  • completed: สถานะสุดท้ายที่แสดงหลังจากคุณประมวลผลการชำระเงินและส่งคำสั่งซื้อเรียบร้อยแล้ว
  • canceled: สถานะที่แสดงหากมีการยกเลิกเซสชันการชำระเงิน
  • error: สถานะที่แสดงหากมีข้อผิดพลาดทางตรรกะทางธุรกิจที่กู้คืนไม่ได้ซึ่งป้องกันการชำระเงิน สถานะนี้พร้อมใช้งานใน UCP เวอร์ชัน 2026-04-08 ขึ้นไป

ขั้นตอนการชำระเงินสำหรับสินค้าหลายรายการ

ตอนนี้ Google รองรับรายการบรรทัดที่แตกต่างกันหลายรายการในเซสชันการชำระเงินเดียว ขั้นตอนทั่วไปมีดังนี้

  1. ผู้ใช้เริ่มการชำระเงินจากอินเทอร์เฟซที่เปิดใช้ UCP (เช่น โดยคลิก "ซื้อเลย" ในผลิตภัณฑ์)
  2. มีการเรียก POST /checkout-sessions ซึ่งรวมถึงสินค้าที่แตกต่างกันทั้งหมดในอาร์เรย์ line_items อาร์เรย์ line_items จะมีออบเจ็กต์แยกต่างหากสำหรับสินค้าที่ไม่ซ้ำกันแต่ละรายการที่กำลังชำระเงิน
  3. ผู้ใช้สามารถอัปเดตเครื่องมือการชำระเงิน รายละเอียดการดำเนินการตามคำสั่งซื้อ หรือใช้ส่วนลดได้โดยใช้การเรียก PUT /checkout-sessions/{id}
  4. เมื่อผู้ใช้คลิกปุ่ม "ชำระเงินด้วย GPay" ระบบจะทำการเรียก POST /checkout-sessions/{id}/complete

การตรวจสอบสิทธิ์

ดูรายละเอียดเกี่ยวกับการรักษาความปลอดภัยของปลายทาง Native Checkout API ซึ่งรวมถึงวิธีการตรวจสอบสิทธิ์ที่รองรับ เช่น คีย์ API และ OAuth 2.0 ได้ที่คู่มือการตรวจสอบสิทธิ์และ การรักษาความปลอดภัย

เครื่องมือสำหรับนักพัฒนาซอฟต์แวร์

หากต้องการความช่วยเหลือในการติดตั้งใช้งาน Native Checkout API คุณสามารถดูแหล่งข้อมูลต่อไปนี้ในที่เก็บ Universal Commerce Protocol GitHub

  • ที่เก็บ UCP GitHub: สำรวจที่เก็บหลัก เพื่อดูเอกสารประกอบ ข้อกำหนด และแหล่งข้อมูลของชุมชนที่ครอบคลุม
  • SDK: ใช้ชุดพัฒนาซอฟต์แวร์เพื่อเร่งการผสานรวม SDK เฉพาะภาษาพร้อมให้บริการแล้ว ซึ่งรวมถึง

  • การทดสอบความสอดคล้อง: ตรวจสอบปลายทาง API กับข้อกำหนด UCP โดยใช้ ชุดการทดสอบความสอดคล้อง

    ซึ่งจะช่วยให้มั่นใจว่าการติดตั้งใช้งานเป็นไปตามมาตรฐานและลักษณะการทำงานที่กำหนด

เราขอแนะนำอย่างยิ่งให้ใช้เครื่องมือเหล่านี้เพื่อปรับปรุงกระบวนการพัฒนาและการทดสอบ

เป้าหมายระดับการให้บริการ

เป้าหมายระดับการให้บริการ (SLO) ต่อไปนี้ใช้กับปลายทาง Native Checkout REST API ธุรกิจที่ผสานรวมกับ Google คาดว่าจะบรรลุเป้าหมายเหล่านี้สำหรับประสิทธิภาพและความพร้อมใช้งานของ API

ปลายทาง ความพร้อมใช้งาน เวลาในการตอบสนอง (เปอร์เซ็นไทล์ที่ 50) เวลาในการตอบสนอง (เปอร์เซ็นไทล์ที่ 95)
POST /checkout-sessions (สร้าง) >= 95% <= 1 วินาที <= 4 วินาที
PUT /checkout-sessions/{id} (อัปเดต) >= 95% <= 1 วินาที <= 5 วินาที
POST /checkout-sessions/{id}/complete (เสร็จสมบูรณ์) >= 95% <= 6 วินาที <= 10 วินาที

เวลาในการตอบสนองของเปอร์เซ็นไทล์ที่ 50 หมายความว่าคำขออย่างน้อย 50% คาดว่าจะดำเนินการเสร็จสิ้นภายในเวลานี้ เวลาในการตอบสนองของเปอร์เซ็นไทล์ที่ 95 หมายความว่าคำขออย่างน้อย 95% คาดว่าจะดำเนินการเสร็จสิ้นภายในเวลานี้

ขั้นตอนถัดไป

ดูเพย์โหลดของ Checkout API และรายละเอียดการติดตั้งใช้งานทางเทคนิคสำหรับ UCP เวอร์ชันของคุณ

ก่อนหน้า
Authentication
ถัดไป
วงจรการสั่งซื้อ (หลังการซื้อ)