DOCS
Checkout•
BerandaReferensi API API REST Checkout Buat checkout

Buat checkout

Jelajahi pasangan kunci/nilai yang terlibat dalam membuat checkout.

Endpoint API ini digunakan untuk mengirim informasi keranjang dan item dari keranjang pelanggan ke API Zonos.

Anda akan menerima respons JSON yang berisi tempCartUUID, pengidentifikasi keranjang unik dalam Sistem Zonos. Ini akan digunakan untuk mengarahkan pelanggan ke Zonos Checkout untuk menyelesaikan pesanan.

Atribut 

Pasangan kunci/nilai JSON dalam badan permintaan

POST https://api.iglobalstores.com/v1/createTempCart

field↕notes↕
boxCountContoh nilai: 22x15x15(1),8x8x4(2),32x22x14(1)
Format: Daftar dimensi kotak dan jumlah yang dipisahkan dengan koma. Dalam contoh di atas, ada total 4 kotak. Kotak pertama dalam daftar akan berukuran 22 inci panjang, 15 inci lebar, 15 inci tinggi. Hanya akan ada satu kotak yang digunakan untuk ukuran tersebut. Akan ada dua kotak berukuran: 8x8x4 inci. Dapat diterima untuk meneruskan dimensi kotak yang sama beberapa kali jika itu mudah bagi Anda, seperti ini: "22x15x15(1),22x15x15(1)", yang berarti 2 kotak berukuran: 22x15x15 inci. Bidang ini menggambarkan kotak yang akan digunakan untuk mengirim pesanan. Tidak diharapkan bahwa pedagang mengetahui ini pada saat pesanan; namun, jika diketahui, dapat diteruskan dalam format string.
contShoppingURLBidang ini digunakan untuk meneruskan URL untuk menimpa HREF tombol "Lanjutkan Belanja" di dalam Zonos Checkout. string
domesticShippingChargeBidang ini digunakan untuk meneruskan biaya pengiriman domestik ke Zonos Checkout, dan jumlahnya akan ditambahkan ke pengiriman. Ini dapat dikonfigurasi untuk menambahkan total pengiriman atau dipecah sebagai item baris terpisah. positive floating point, two decimal places
externalConfirmationPageURLBidang ini digunakan untuk meneruskan URL halaman konfirmasi pesanan / halaman terima kasih Anda. Setelah pelanggan menyelesaikan pembayaran di dalam Zonos Checkout, mereka akan dialihkan ke URL ini untuk konfirmasi pesanan. URL ini sering digunakan untuk memicu panggilan ke endpoint layanan API "orderDetail" Zonos untuk mengambil detail pesanan dan mengimpor pesanan ke dalam sistem. string
footerHTMLBidang ini digunakan untuk meneruskan string HTML yang dikodekan URL. String HTML ini akan didekodekan dan ditempatkan sebelum tag penutup body pada halaman checkout. Biasanya digunakan untuk meneruskan kode untuk pemasaran ulang, analitik, dll. URL encoded string
items

REQUIRED

Bidang ini adalah daftar peta item. JSON string
items[index].countryOfOriginBidang ini digunakan untuk meneruskan negara asal item. Parameter harus berupa kode ISO dua huruf negara. string
items[index].description

REQUIRED

Bidang ini digunakan untuk meneruskan deskripsi item lengkap dari item baris keranjang, termasuk opsi item, warna, dll. string
items[index].heightBidang ini digunakan untuk meneruskan ketinggian item dan sangat disarankan untuk penawaran pengiriman yang akurat. Unit ketinggian adalah

REQUIRED

dalam inci. string - positive floating point, two decimal places / integer (inches)
items[index].imageURL

REQUIRED

Bidang ini digunakan untuk meneruskan URL ke gambar produk item. URL harus HTTPS untuk ditampilkan di dalam Zonos Checkout. string / HTTPS URL
items[index]itemBrandBidang ini digunakan untuk meneruskan merek item string
items[index]itemCategoryBidang ini digunakan untuk meneruskan kategori item dan dapat diteruskan dipisahkan pipa jika item memiliki lebih dari satu kategori.
Contoh nilai: "shoes" atau "shoes|sport-shoes|discount-shoes"string
items[index]itemCustomizationBidang ini digunakan untuk meneruskan detail tambahan tentang item yang tidak ditampilkan di Zonos Checkout; namun, ini dapat diambil melalui endpoint layanan API "orderDetail".
items[index]itemHSCodeBidang ini digunakan untuk meneruskan kode HS item dan mungkin dengan atau tanpa periode.
Contoh nilai: "3926901000" atau "3926.90.1000"string
items[index].itemURLBidang ini digunakan untuk meneruskan URL ke halaman produk item. string / URL
items[index].lengthBidang ini digunakan untuk meneruskan panjang item dan sangat disarankan untuk penawaran pengiriman yang akurat. Unit panjang adalah

REQUIRED

dalam inci. string - positive floating point, two decimal places / integer (inches)
items[index].nonShippableBidang ini digunakan untuk menunjukkan apakah item harus disertakan dalam perhitungan pengiriman, bea, dan pajak. Unduhan digital, kode diskon, biaya penanganan, dll harus diteruskan dengan nilai "true". boolean: true or false
items[index].productIdBidang ini digunakan untuk meneruskan kuantitas item baris. string
items[index].quantity

REQUIRED

Bidang ini digunakan untuk meneruskan kuantitas item baris. string
items[index].skuBidang ini digunakan untuk meneruskan SKU / UPC / dll item. string
items[index].unitPrice

REQUIRED

Bidang ini digunakan untuk meneruskan harga satuan item baris. positive floating point, two decimal places / integer
items[index].weightBidang ini digunakan untuk meneruskan berat item dan sangat disarankan untuk penawaran pengiriman yang akurat. Unit berat defaultnya adalah "LBS" kecuali unit berat lain diteruskan dalam items[index].itemWeightUnits``string - positive floating point, two decimal places / integer
items[index].weightUnitsBidang ini digunakan untuk menimpa unit berat item default. Unit berat item defaultnya adalah "LBS" kecuali unit berat lain diteruskan di bidang ini. string - "LB", "OZ", "KG", atau "G"
items[index].widthBidang ini digunakan untuk meneruskan lebar item dan sangat disarankan untuk penawaran pengiriman yang akurat. Unit lebar adalah

REQUIRED

dalam inci. string - positive floating point, two decimal places / integer (inches)
misc1 - misc6Bidang ini digunakan untuk meneruskan data miscellaneous yang terkait dengan pesanan melalui API Zonos untuk diambil bersama dengan data pesanan yang dikembalikan dari endpoint layanan API "orderDetail" Zonos. string
referenceIdBidang ini digunakan untuk meneruskan nilai identifikasi referensi unik untuk keranjang/sesi/dll di sistem Anda. Ini dapat digunakan untuk mencari ID pesanan Zonos melalui endpoint layanan API "orderDetail" Zonos. string
storeId

REQUIRED

ID Toko yang disediakan oleh Zonos. integer

Tipe data string tambahan

  • items[index].itemDescriptionLong
  • items[index].itemDescriptionDetailed
  • items[index].itemFabricContent
  • items[index].itemColor
  • items[index].itemLtlClass
  • items[index].status
  • items[index].itemMaterial

Diskon, kupon, dan kode promo 

Untuk mengirim diskon, kupon, dan kode promo ke Zonos melalui kiriman server, mereka harus diteruskan sebagai item terpisah dengan nilai negatif untuk parameter: "unitPrice" dan "nonShippable":true.

1{
2 "description": "Discount (10OFF) - 10% OFF",
3 "unitPrice": -15.5,
4 "quantity": 1,
5 "nonShippable": true
6}

Respons HTTPS

Respons HTTP yang berhasil

Format pesan: JSON

1{
2 "tempCartUUID": "826b8f22-0de6-4717-90c7-366def7d0782"
3}

Definisi JSON respons

field↕notes↕
tempCartUUIDParameter ini akan berisi GUID yang ditetapkan ke keranjang internasional pelanggan Anda dan dibuat dalam sistem Zonos. Bidang ini akan diteruskan melalui parameter string kueri URL sambil mengarahkan browser pengguna ke Zonos Checkout.

Respons HTTP kesalahan

Error code↕meaning↕
400Karakter yang tidak terduga dalam badan permintaan.
406Tidak Dapat Diterima. Header HTTP untuk "Accept" tidak valid.
415Jenis media yang tidak didukung. Header HTTP untuk "Content-Type" tidak valid.
422Entitas yang tidak dapat diproses.
500"storeId" salah atau badan JSON tidak dapat diuraikan.
1
2 
3
4 
5
6 
7Error 422 Unprocessable Entity
8 
9
10 
11
12 
13

HTTP ERROR 422

14 
15

16 Problem accessing /v2/createTempCart. Reason:
17 
Unprocessable Entity
18 
19

20 
21

The request entity had the following errors:

22 
23
24 
25
  • items may not be empty (was null)
    • 26 
    27
  • items may not be null (was null)
    • 28 
    29
    30 
    31
    32 
    33

    Mengarahkan ke Zonos Checkout 

    Setelah menerima respons yang berhasil yang berisi tempCartUUID, server Anda akan mengirim pengalihan dari browser pelanggan ke Zonos Checkout dengan parameter string kueri URL yang sesuai yang dijelaskan di bawah ini.

    Contoh URL Pengalihan: https://[yourassignedsubdomain].iglobalstores.com/?tempCartUUID=826b8f22-0de6-4717-90c7-366def7d0782&country=CA

    Catatan: [yourassignedsubdomain] - Hubungi anggota tim implementasi Zonos Anda untuk menerima subdomain Zonos.com Anda.

    Parameter permintaan URL

    field↕notes↕
    tempCartUUID

    REQUIRED

    		Nilai ini diperoleh dengan memanggil endpoint layanan API Zonos createTempCart. string / GUID
    countryKode ISO dua huruf negara tujuan. Kami sangat merekomendasikan untuk meneruskan parameter ini untuk pengalaman pengguna. Parameter country akan memilih sebelumnya negara tujuan di dalam Zonos Checkout. Saat menggunakan Zonos Hello JS (JavaScript) di situs, Anda dapat memperoleh nilai ini dengan memanggil metode JavaScript: zonos.country(). string (Length: 2)

    Tipe data string tambahan

    • customerName
    • customerCompany
    • customerEmail
    • customerPhone
    • customerAltPhone
    • customerAddress1
    • customerAddress2
    • customerCity
    • customerState
    • customerZip

    Apakah halaman ini bermanfaat?

    Dapatkan dukungan·Dokumen hukum·© 2026 Zonos
    Di halaman ini:
  • Buat checkout
  • Atribut
  • Diskon, kupon, dan kode promo
  • Mengarahkan ke Zonos Checkout