Penerapan Cart API

Panduan ini menyediakan referensi API teknis dan skema payload untuk mengintegrasikan Cart API Universal Commerce Protocol (UCP) dalam versi 2026-04-08.

Sebelum membuat endpoint, pastikan Anda telah meninjau ringkasan Cart API untuk mengetahui konsep dan prasyarat tingkat tinggi.

Membuat keranjang

Endpoint ini memungkinkan pembuatan sesi keranjang baru. Untuk mengintegrasikan, terapkan endpoint CreateCart (POST /carts). Saat pengguna memilih untuk mentransfer keranjangnya, Google akan memanggil endpoint ini dengan detail item baris. Sistem Anda harus merespons dengan continue_url yang mengarahkan pengguna ke keranjang yang telah diisi sebelumnya di situs Anda.

  • Endpoint: POST /carts
  • Pemicu: Pengguna mengklik "Tambahkan ke keranjang" pada produk dan menambahkan item pertama ke keranjang untuk penjual.

Permintaan: Google mengirimkan array line_items yang akan ditambahkan ke keranjang.

Contoh permintaan:

{
  "line_items": [
    {
      "item": {
        "id": "item_123"
      },
      "quantity": 2
    }
  ]
}

Respons: Anda menampilkan sesi keranjang yang diinisialisasi, termasuk detail item baris, total, dan continue_url. Kolom continue_url dalam respons harus mengarahkan pengguna kembali ke halaman di situs Anda tempat mereka dapat terus mengelola keranjang. Ini biasanya ditautkan ke halaman keranjang atau halaman checkout Anda dengan sesi yang diidentifikasi oleh id yang telah dimuat sebelumnya.

Contoh respons:

{
  "ucp": {
    "version": "2026-04-08",
    "capabilities": {
      "dev.ucp.shopping.cart": [{"version": "2026-04-08"}]
    }
  },
  "id": "cart_abc123",
  "line_items": [
    {
      "id": "li_1",
      "item": {
        "id": "item_123",
        "title": "Red T-Shirt",
        "price": 2500
      },
      "quantity": 2,
      "totals": [
        {"type": "subtotal", "amount": 5000},
        {"type": "total", "amount": 5000}
      ]
    }
  ],
  "currency": "USD",
  "totals": [
    {
      "type": "subtotal",
      "amount": 5000
    },
    {
      "type": "total",
      "amount": 5000,
      "display_text": "Estimated total (taxes calculated at checkout)"
    }
  ],
  // Used for redirecting the user back to the merchant's cart experience from Google surfaces.
  "continue_url": "https://business.example.com/checkout?cart=cart_abc123",
  // Indicate the timestamp at which the cart session will expire and become invalid.
  "expires_at": "2026-01-16T12:00:00Z"
}

Penanganan error

Untuk mengetahui panduan lengkap tentang cara memformat pesan error dan perbedaan antara error protokol dan logika bisnis, lihat Kode error.

Berikutnya
Kode promo dan diskon