Ringkasan checkout native

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

Alur checkout

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

Alur keseluruhannya adalah sebagai berikut:

  1. Buat sesi checkout: Pengguna dan Agen secara opsional berada dalam loop menambahkan item ke sesi.
  2. Pengalihan ke UI Google: Setelah pengguna memutuskan untuk melihat Agen (jika berinteraksi), kontrol akan dialihkan ke UI Google (dengan meneruskan data sesi checkout)
  3. Checkout manual: Pengguna kini hanya berinteraksi dengan UI Google untuk mengisi detail pembayaran dan pemenuhan pesanan yang sensitif serta mengirimkan pesanan. Agen tidak terlibat dalam bagian ini, sehingga memastikan determinisme.
  4. 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 sesi checkout status untuk mencerminkan statusnya saat ini. Sesi akan 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 penggabungan 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:

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

Autentikasi

Untuk mengetahui detail tentang 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:

  • Uji kepatuhan: Validasi endpoint API Anda terhadap spesifikasi UCP menggunakan rangkaian uji kepatuhan

    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 Native Checkout REST API. Bisnis yang terintegrasi dengan Google diharapkan 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} (Pembaruan) >= 95% <= 1 detik <= 5 detik
POST /checkout-sessions/{id}/complete (Selesai) >= 95% <= 6 detik <= 10 detik

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

Langkah berikutnya

Lihat payload API checkout dan detail penerapan teknis untuk versi UCP Anda:

Jika Anda melakukan integrasi sebagai penyedia layanan pihak ketiga, lanjutkan ke Penyiapan layanan Checkout UCP untuk menghosting profil penjual dan mengonfigurasi handshake hubungan akun.

Sebelumnya
Siklus proses pesanan (setelah pembelian)
Berikutnya
Kode error