Checkout oluşturmada yer alan anahtar/değer çiftlerini keşfedin.
Bu API uç noktası, müşterinin sepetinden sepet bilgilerini ve öğeleri Zonos API'sına göndermek için kullanılır.
tempCartUUID içeren bir JSON yanıtı alacaksınız; Zonos Sistemi'nde benzersiz bir sepet tanımlayıcısı. Bu, müşteri siparişi tamamlamak için Zonos Checkout'a yönlendirilecektir.
POST https://api.iglobalstores.com/v1/createTempCart
Alan↕
Notlar↕
boxCount
Örnek değer: 22x15x15(1),8x8x4(2),32x22x14(1) Format: Kutu boyutları ve sayının virgülle ayrılmış listesi. Yukarıdaki örnekte toplam 4 kutu vardır. Listedeki ilk kutu 22 inç uzunluğunda, 15 inç genişliğinde, 15 inç yüksekliğinde olacaktır. Bu boyut için yalnızca bir kutu kullanılacaktır. 8x8x4 inç boyutunda iki kutu olacaktır. Sizin için kolay olması durumunda aynı kutu boyutunu birden çok kez geçmek kabul edilebilir, şöyle: "22x15x15(1),22x15x15(1)", bu da 22x15x15 inç boyutunda 2 kutunun olduğu anlamına gelir. Bu alan, siparişi göndermek için kullanılacak kutuları açıklar. Bir tüccarın sipariş zamanında bunu bilmesi beklenmez; ancak biliniyorsa, string biçiminde geçirilebilir.
contShoppingURL
Bu alan, Zonos Checkout içindeki "Alışverişe Devam" düğmesinin HREF'ini geçersiz kılmak için bir URL'yi geçmek için kullanılır. string
domesticShippingCharge
Bu alan, Zonos Checkout'a yurtiçi kargo ücreti geçmek için kullanılır ve tutar kargoya eklenecektir. Bunu kargo toplamını eklemek için yapılandırabilir veya ayrı bir satır öğesi olarak bölümlendirilebilir. positive floating point, two decimal places
externalConfirmationPageURL
Bu alan, sipariş onayı / teşekkür sayfanızın URL'sini geçmek için kullanılır. Müşteri Zonos Checkout içinde ödeme tamamladıktan sonra, sipariş onayı için bu URL'ye yönlendirilecektir. Bu URL, sipariş ayrıntısını almak ve siparişi sisteme aktarmak için Zonos "orderDetail" API hizmeti uç noktasına bir çağrı tetiklemek için sıklıkla kullanılır. string
footerHTML
Bu alan, URL kodlamalı bir HTML dizesi geçmek için kullanılır. Bu HTML dizesi çözülecek ve kasa sayfasındaki kapanış gövde etiketinden önce yerleştirilecektir. Genellikle yeniden pazarlama, analitik vb. için kod geçmek için kullanılır. URL encoded string
items
REQUIRED
Bu alan, öğe haritalarının bir listesidir. JSON string
items[index].countryOfOrigin
Bu alan, öğenin menşei ülkesini geçmek için kullanılır. Parametre ülke iki harfli ISO kodu olmalıdır. string
items[index].description
REQUIRED
Bu alan, herhangi bir öğe seçeneği, rengi vb. dahil olmak üzere sepet satırı öğesinin tam açıklamasını geçmek için kullanılır. string
items[index].height
Bu alan, öğe yüksekliğini geçmek için kullanılır ve doğru kargo teklifleri için oldukça önerilir. Yükseklik birimleri
REQUIRED
inç cinsinden. string - positive floating point, two decimal places / integer (inches)
items[index].imageURL
REQUIRED
Bu alan, öğe ürün görüntüsüne URL'yi geçmek için kullanılır. URL, Zonos Checkout içinde görüntülemek için HTTPS olmalıdır. string / HTTPS URL
items[index]itemBrand
Bu alan, öğe markasını geçmek için kullanılır. string
items[index]itemCategory
Bu alan, öğe kategorisini geçmek için kullanılır ve öğenin birden fazla kategorisi varsa boru sınırlandırılmış geçirilebilir. Örnek değerler: "ayakkabılar" veya "ayakkabılar|spor-ayakkabılar|indirimli-ayakkabılar"string
items[index]itemCustomization
Bu alan, Zonos Checkout'ta gösterilmeyen öğe hakkında ek ayrıntılar geçmek için kullanılır; ancak bu, "orderDetail" API hizmeti uç noktası aracılığıyla alınabilir.
items[index]itemHSCode
Bu alan, öğe HS kodunu geçmek için kullanılır ve nokta ile veya nokta olmadan olabilir. Örnek değerler: "3926901000" veya "3926.90.1000"string
items[index].itemURL
Bu alan, öğe ürün sayfasına URL'yi geçmek için kullanılır. string / URL
items[index].length
Bu alan, öğe uzunluğunu geçmek için kullanılır ve doğru kargo teklifleri için oldukça önerilir. Uzunluk birimleri
REQUIRED
inç cinsinden. string - positive floating point, two decimal places / integer (inches)
items[index].nonShippable
Bu alan, öğenin kargo, vergi ve vergi hesaplamalarına dahil edilip edilmeyeceğini belirtmek için kullanılır. Dijital indirmeler, indirim kodları, işlem ücretleri vb. "true" değeriyle geçirilmelidir. boolean: true or false
items[index].productId
Bu alan, satır öğesi miktarını geçmek için kullanılır. string
items[index].quantity
REQUIRED
Bu alan, satır öğesi miktarını geçmek için kullanılır. string
items[index].sku
Bu alan, öğe SKU / UPC / vb. geçmek için kullanılır. string
items[index].unitPrice
REQUIRED
Bu alan, satır öğesi birim fiyatını geçmek için kullanılır. positive floating point, two decimal places / integer
items[index].weight
Bu alan, öğe ağırlığını geçmek için kullanılır ve doğru kargo teklifleri için oldukça önerilir. Ağırlık birimleri, items[index].itemWeightUnits'da başka bir ağırlık birimi geçilmedikçe varsayılan olarak "LBS"dir string - positive floating point, two decimal places / integer
items[index].weightUnits
Bu alan, varsayılan öğe ağırlığı birimlerini geçersiz kılmak için kullanılır. Öğe ağırlığı birimleri "LBS" olarak varsayılan olarak ayarlanır; bu alan içinde başka bir ağırlık birimi geçilmedikçe. string - "LB", "OZ", "KG", or "G"
items[index].width
Bu alan, öğe genişliğini geçmek için kullanılır ve doğru kargo teklifleri için oldukça önerilir. Genişlik birimleri
REQUIRED
inç cinsinden. string - positive floating point, two decimal places / integer (inches)
misc1 - misc6
Bu alan, Zonos API aracılığıyla siparişle ilişkili çeşitli verileri geçmek için kullanılır ve Zonos "orderDetail" API hizmeti uç noktasından döndürülen sipariş verileriyle birlikte alınacaktır. string
referenceId
Bu alan, sisteminizde sepet/oturum/vb. için benzersiz bir referans kimlik değeri geçmek için kullanılır. Bu, Zonos "orderDetail" API hizmeti uç noktası aracılığıyla Zonos sipariş kimliğini aramak için kullanılabilir. string
İndirimler, kuponlar ve promosyon kodlarını sunucu POST aracılığıyla Zonos'a göndermek için, bunları aşağıdaki parametreler için negatif bir değer içeren ayrı bir öğe olarak geçirilmelidir: "unitPrice" ve "nonShippable":true.
Bu parametre müşterinizin uluslararası sepetine atanan bir GUID içerecek ve Zonos sisteminde oluşturulacaktır. Bu dosya, kullanıcı tarayıcısı Zonos Checkout'a yönlendirilirken URL sorgusu string parametresi aracılığıyla geçirilecektir.
Hata HTTP yanıtları
Hata kodu↕
Anlam↕
400
İstek gövdesinde beklenmeyen karakter.
406
Kabul edilemez. "Accept" için HTTP başlığı geçersiz.
415
Desteklenmeyen medya türü. "Content-Type" için HTTP başlığı geçersiz.
422
İşlenemeyen varlık.
500
"storeId" yanlış veya JSON gövdesi ayrıştırılamadı.
tempCartUUID'i içeren başarılı bir yanıt aldıktan sonra, sunucunuz müşterinin tarayıcısından aşağıda kapsanan uygun URL sorgusu dize parametreleriyle Zonos Checkout'a bir yeniden yönlendirme gönderecektir.
Örnek Yönlendirme URL'si: https://[yourassignedsubdomain].iglobalstores.com/?tempCartUUID=826b8f22-0de6-4717-90c7-366def7d0782&country=CA
Not: [yourassignedsubdomain] - Zonos.com alt etki alanınızı almak için Zonos uygulama takımı üyesi ile iletişime geçin.
URL istek parametreleri
Alan↕
Notlar↕
tempCartUUID
REQUIRED
Bu değer, Zonos createTempCart API hizmeti uç noktası çağrılarak elde edilir. string / GUID
country
Hedef ülkenin iki harfli ISO kodu. Kullanıcı deneyimi için bu parametreyi geçmenizi şiddetle tavsiye ederiz. country parametresi, Zonos Checkout içindeki hedef ülkeyi önceden seçecektir. Sitede Zonos Hello JS (JavaScript) kullanırken, bu değeri JavaScript yöntemini çağırarak elde edebilirsiniz: zonos.country(). string (Length: 2)
Checkout oluşturma
Checkout oluşturma
Checkout oluşturmada yer alan anahtar/değer çiftlerini keşfedin.
Bu API uç noktası, müşterinin sepetinden sepet bilgilerini ve öğeleri Zonos API'sına göndermek için kullanılır.
tempCartUUIDiçeren bir JSON yanıtı alacaksınız; Zonos Sistemi'nde benzersiz bir sepet tanımlayıcısı. Bu, müşteri siparişi tamamlamak için Zonos Checkout'a yönlendirilecektir.Öznitelikler
İstek gövdesindeki JSON anahtar/değer çiftleri
POST
https://api.iglobalstores.com/v1/createTempCartboxCountFormat: Kutu boyutları ve sayının virgülle ayrılmış listesi. Yukarıdaki örnekte toplam 4 kutu vardır. Listedeki ilk kutu 22 inç uzunluğunda, 15 inç genişliğinde, 15 inç yüksekliğinde olacaktır. Bu boyut için yalnızca bir kutu kullanılacaktır. 8x8x4 inç boyutunda iki kutu olacaktır. Sizin için kolay olması durumunda aynı kutu boyutunu birden çok kez geçmek kabul edilebilir, şöyle: "22x15x15(1),22x15x15(1)", bu da 22x15x15 inç boyutunda 2 kutunun olduğu anlamına gelir. Bu alan, siparişi göndermek için kullanılacak kutuları açıklar. Bir tüccarın sipariş zamanında bunu bilmesi beklenmez; ancak biliniyorsa,
stringbiçiminde geçirilebilir.contShoppingURLstringdomesticShippingChargepositive floating point, two decimal placesexternalConfirmationPageURLstringfooterHTMLURL encoded stringitemsREQUIRED
JSON stringitems[index].countryOfOriginstringitems[index].descriptionREQUIRED
stringitems[index].heightREQUIRED
string - positive floating point, two decimal places / integer (inches)items[index].imageURLREQUIRED
string / HTTPS URLitems[index]itemBrandstringitems[index]itemCategoryÖrnek değerler: "ayakkabılar" veya "ayakkabılar|spor-ayakkabılar|indirimli-ayakkabılar"
stringitems[index]itemCustomizationitems[index]itemHSCodeÖrnek değerler: "3926901000" veya "3926.90.1000"
stringitems[index].itemURLstring / URLitems[index].lengthREQUIRED
string - positive floating point, two decimal places / integer (inches)items[index].nonShippableboolean: true or falseitems[index].productIdstringitems[index].quantityREQUIRED
stringitems[index].skustringitems[index].unitPriceREQUIRED
positive floating point, two decimal places / integeritems[index].weightitems[index].itemWeightUnits'da başka bir ağırlık birimi geçilmedikçe varsayılan olarak "LBS"dirstring - positive floating point, two decimal places / integeritems[index].weightUnitsstring - "LB", "OZ", "KG", or "G"items[index].widthREQUIRED
string - positive floating point, two decimal places / integer (inches)misc1 - misc6stringreferenceIdstringstoreIdREQUIRED
integerEk dize veri türleri
items[index].itemDescriptionLongitems[index].itemDescriptionDetaileditems[index].itemFabricContentitems[index].itemColoritems[index].itemLtlClassitems[index].statusitems[index].itemMaterialİndirimler, kuponlar ve promosyon kodları
İndirimler, kuponlar ve promosyon kodlarını sunucu POST aracılığıyla Zonos'a göndermek için, bunları aşağıdaki parametreler için negatif bir değer içeren ayrı bir öğe olarak geçirilmelidir:
"unitPrice"ve"nonShippable":true.{"description": "Discount (10OFF) - 10% OFF","unitPrice": -15.5,"quantity": 1,"nonShippable": true}HTTPS yanıtı
Başarılı HTTP yanıtı
İleti biçimi: JSON
{"tempCartUUID": "826b8f22-0de6-4717-90c7-366def7d0782"}Yanıt JSON tanımları
tempCartUUIDstringparametresi aracılığıyla geçirilecektir.Hata HTTP yanıtları
HTTP ERROR 422
Problem accessing /v2/createTempCart. Reason:The request entity had the following errors:
Zonos Checkout'a Yönlendirme
tempCartUUID'i içeren başarılı bir yanıt aldıktan sonra, sunucunuz müşterinin tarayıcısından aşağıda kapsanan uygun URL sorgusu dize parametreleriyle Zonos Checkout'a bir yeniden yönlendirme gönderecektir.URL istek parametreleri
tempCartUUIDREQUIRED
createTempCartAPI hizmeti uç noktası çağrılarak elde edilir.string / GUIDcountrycountryparametresi, Zonos Checkout içindeki hedef ülkeyi önceden seçecektir. Sitede Zonos Hello JS (JavaScript) kullanırken, bu değeri JavaScript yöntemini çağırarak elde edebilirsiniz:zonos.country().string(Length: 2)Ek dize veri türleri
customerNamecustomerCompanycustomerEmailcustomerPhonecustomerAltPhonecustomerAddress1customerAddress2customerCitycustomerStatecustomerZipBu sayfa faydalı mıydı?