Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Ringkasan checkout native

Untuk mengaktifkan checkout pengguna, Anda harus menerapkan integrasi checkout Native. Hal ini melibatkan pembuatan REST API standar yang memungkinkan Google mengelola alur checkout secara terprogram dengan server Anda. Metode ini memberikan pengalaman yang paling lancar bagi pengguna. Awalnya, Google akan merender antarmuka pengguna untuk pembeli, dengan rencana mendatang untuk mendukung pengalaman yang lebih agentik.

Alur checkout

Integrasi Native mengharuskan Anda membuat RESTful API yang dapat dipanggil Google untuk membuat dan mengelola sesi checkout.

Alur keseluruhannya adalah sebagai berikut:

Membuat sesi checkout: Pengguna dan Agen (opsional) berada dalam loop yang menambahkan item ke sesi.
Penyerahan ke UI Google: Setelah pengguna memutuskan untuk melakukan checkout, Agen (jika terlibat) akan meneruskan kontrol ke UI Google (meneruskan data sesi checkout)
Checkout manual: Pengguna kini hanya berinteraksi dengan UI Google untuk mengisi detail pemenuhan dan pembayaran sensitif serta mengirimkan pesanan. Agen tidak terlibat dalam bagian ini, sehingga memastikan determinisme.
Penyelesaian & pengembalian: UI Google menampilkan halaman "Terima Kasih" untuk mengonfirmasi pesanan. Secara opsional, pengguna dapat dialihkan kembali ke Agen, yang mungkin telah diberi tahu tentang pembelian yang telah selesai.

Siklus proses status sesi checkout

Saat pengguna melanjutkan alur checkout, Anda harus memperbarui status sesi checkout untuk mencerminkan statusnya saat ini. Sesi akan berpindah melalui siklus proses berikut:

incomplete: Status awal saat sesi dibuat. Hal ini menunjukkan bahwa informasi wajib (seperti metode pengiriman, pajak, atau detail pengguna) tidak ada atau tidak dihitung.
ready_for_payment: Status yang akan digunakan setelah pengguna memperbarui alamat pengiriman dan Anda menghitung opsi dan total pengiriman, tetapi sebelum instrumen pembayaran diselesaikan.
ready_for_complete: Status yang akan digunakan selama hidrasi objek checkout lengkap, setelah instrumen pembayaran dipilih dan semua detail pesanan divalidasi.
completed: Status akhir yang ditampilkan setelah Anda berhasil memproses pembayaran dan melakukan pemesanan.
canceled: Status yang ditampilkan jika sesi checkout dibatalkan.
error: Status yang ditampilkan jika error logika bisnis yang tidak dapat dipulihkan mencegah checkout. Status ini tersedia di UCP versi 2026-04-08 dan yang lebih baru.

Alur Checkout Multi-Item:

Google kini mendukung beberapa item baris yang berbeda dalam satu sesi checkout. Alur umumnya adalah sebagai berikut:

Pengguna memulai checkout dari antarmuka yang mendukung UCP (mis., dengan mengklik "Beli sekarang" pada produk).
Panggilan POST /checkout-sessions dilakukan, termasuk semua item yang berbeda dalam array line_items. Array line_items akan berisi objek terpisah untuk setiap item unik yang di-checkout.
Pengguna dapat memperbarui instrumen pembayaran, detail pemenuhan, atau menerapkan diskon menggunakan panggilan PUT /checkout-sessions/{id}.
Saat pengguna mengklik tombol "Bayar dengan GPay", panggilan POST /checkout-sessions/{id}/complete akan dilakukan.

Autentikasi

Untuk mengetahui detail tentang cara mengamankan endpoint Native Checkout API, termasuk metode autentikasi yang didukung seperti kunci API dan OAuth 2.0, lihat panduan Autentikasi & Keamanan.

Developer tools

Untuk membantu penerapan Native Checkout API, Anda dapat menemukan referensi berikut di repositori GitHub Universal Commerce Protocol:

Repositori GitHub UCP: Jelajahi repositori utama untuk mendapatkan dokumentasi, spesifikasi, dan referensi komunitas yang komprehensif.
SDK: Gunakan Software Development Kit untuk mempercepat integrasi Anda. SDK khusus bahasa tersedia, termasuk:
- SDK Python
- SDK JavaScript
Pengujian kesesuaian: Validasi endpoint API Anda terhadap spesifikasi UCP menggunakan rangkaian pengujian kesesuaian

Hal ini membantu memastikan penerapan Anda memenuhi standar dan perilaku yang diperlukan.

Sebaiknya gunakan alat ini untuk menyederhanakan proses pengembangan dan pengujian Anda.

Tujuan tingkat layanan

Tujuan tingkat layanan (SLO) berikut berlaku untuk endpoint REST API Checkout Native. Bisnis yang terintegrasi dengan Google diharapkan dapat memenuhi target ini untuk performa dan ketersediaan API.

Endpoint	Ketersediaan	Latensi (Persentil ke-50)	Latensi (Persentil ke-95)
`POST /checkout-sessions` (Buat)	>= 95%	<= 1 detik	<= 4 detik
`PUT /checkout-sessions/{id}` (Perbarui)	>= 95%	<= 1 detik	<= 5 detik
`POST /checkout-sessions/{id}/complete` (Selesaikan)	>= 95%	<= 6 detik	<= 10 detik

Latensi persentil ke-50 menunjukkan bahwa setidaknya 50% permintaan diharapkan selesai dalam waktu ini. Latensi persentil ke-95 menunjukkan bahwa setidaknya 95% permintaan diharapkan selesai dalam waktu ini.