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

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

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

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

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

  1. สร้างเซสชันการชำระเงิน: ผู้ใช้และ Agent (ไม่บังคับ) จะอยู่ในลูป เพิ่มสินค้าลงในเซสชัน
  2. ส่งต่อให้ UI ของ Google: เมื่อผู้ใช้ตัดสินใจที่จะชำระเงิน Agent (หากมีส่วนร่วม) จะส่งต่อการควบคุมไปยัง UI ของ Google (ส่งข้อมูลเซสชันการชำระเงิน)
  3. การชำระเงินด้วยตนเอง: ตอนนี้ผู้ใช้จะโต้ตอบกับ UI ของ Google เท่านั้นเพื่อกรอก รายละเอียดการปฏิบัติตามข้อกำหนดและการชำระเงินที่ละเอียดอ่อน และส่งคำสั่งซื้อ Agent จะไม่เกี่ยวข้องในส่วนนี้เพื่อให้มั่นใจว่าการทำงานจะเป็นไปอย่างแน่นอน
  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

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

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

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

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

วัตถุประสงค์ระดับการให้บริการ

เป้าหมายระดับการให้บริการ (SLO) ต่อไปนี้มีผลกับปลายทาง 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% จะดำเนินการเสร็จสิ้นภายในเวลานี้

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

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

หากคุณผสานรวมในฐานะผู้ให้บริการบุคคลที่สาม ให้ไปที่ การตั้งค่าบริการชำระเงิน UCP เพื่อโฮสต์ โปรไฟล์ผู้ขายและกำหนดค่าการแฮนด์เชคความสัมพันธ์ของบัญชี

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