DOCS

Utwórz checkout

Utwórz checkout

Zbadaj pary klucz/wartość zaangażowane w tworzeniu checkout.

Ten punkt końcowy API służy do przesyłania informacji o koszyku i przedmiotach z koszyka klienta do API Zonos.

Otrzymasz odpowiedź JSON zawierającą tempCartUUID, unikalny identyfikator koszyka w Systemie Zonos. Będzie to używane do przekierowania klienta do Zonos Checkout w celu finalizacji zamówienia.

Atrybuty 

Pary klucz/wartość JSON w ciele żądania

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

polenotatki
boxCountPrzykładowa wartość: 22x15x15(1),8x8x4(2),32x22x14(1)
Format: Lista rozmiarów pudełek i ilości oddzielonych przecinkami. W powyższym przykładzie jest łącznie 4 pudełka. Pierwsze pudełko na liście będzie miało wymiary 22 cali długości, 15 cali szerokości i 15 cali wysokości. Będzie użyte tylko jedno pudełko o takich wymiarach. Będzie dwie pudełka o wymiarach: 8x8x4 cale. Można przekazać ten sam wymiar pudełka wielokrotnie, jeśli jest to dla Ciebie łatwe, np. "22x15x15(1),22x15x15(1)", co oznacza 2 pudełka o wymiarach: 22x15x15 cali. To pole opisuje pudełka, które zostaną użyte do wysyłki zamówienia. Nie oczekuje się, że sprzedawca będzie to znał w momencie zamówienia; jednak jeśli jest to znane, może być przekazane w formacie string.
contShoppingURLTo pole służy do przekazania adresu URL w celu zastąpienia HREF przycisku "Kontynuuj zakupy" wewnątrz Zonos Checkout. string
domesticShippingChargeTo pole służy do przekazania opłaty za krajową wysyłkę do Zonos Checkout, a kwota zostanie dodana do kosztów wysyłki. Można skonfigurować to tak, aby dodać łączny koszt wysyłki lub rozbić go na osobny pozycje. dodatnia liczba zmiennoprzecinkowa, dwie cyfry po przecinku
externalConfirmationPageURLTo pole służy do przekazania adresu URL strony potwierdzenia zamówienia / podziękowania. Po dokonaniu płatności wewnątrz Zonos Checkout, klient zostanie przekierowany pod ten adres URL w celu potwierdzenia zamówienia. Ten adres URL jest często używany do wywołania usługi punktu końcowego API "orderDetail" Zonos w celu pobrania szczegółów zamówienia i importu zamówienia do systemu. string
footerHTMLTo pole służy do przekazania zakodowanego adresu URL HTML. Ten ciąg HTML zostanie zdekodowany i umieszczony przed zamykającym tagiem body na stronie checkout. Zazwyczaj używane do przekazywania kodu do remarketingu, analizy itp. zakodowany adres URL
items

WYMAGANE

To pole jest listą map przedmiotów. ciąg JSON
items[index].countryOfOriginTo pole służy do przekazania kraju pochodzenia przedmiotu. Parametr musi być krajem kod ISO z dwiema literami. string
items[index].description

WYMAGANE

To pole służy do przekazania pełnego opisu przedmiotu z linii koszyka, w tym wszelkich opcji przedmiotu, kolorów itp. string
items[index].heightTo pole służy do przekazania wysokości przedmiotu i jest bardzo zalecane dla dokładnych wycen wysyłki. Jednostki wysokości są

WYMAGANE

w calach. string - dodatnia liczba zmiennoprzecinkowa, dwie cyfry po przecinku / liczba całkowita (cale)
items[index].imageURL

WYMAGANE

To pole służy do przekazania adresu URL obrazu produktu. URL musi być protokołu HTTPS, aby wyświetlić go wewnątrz Zonos Checkout. string / adres URL HTTPS
items[index]itemBrandTo pole służy do przekazania marki przedmiotu string
items[index]itemCategoryTo pole jest używane do przekazywania kategorii przedmiotu i może być przekazywane oddzielone pionową kreską, jeśli przedmiot ma więcej niż jedną kategorię.
Przykładowe wartości: “buty” lub “buty|buty-sportowe|buty-przecenione”string
items[index]itemCustomizationTo pole jest używane do przekazywania dodatkowych szczegółów dotyczących przedmiotu, które nie są wyświetlane w Zonos Checkout; jednak można je uzyskać za pośrednictwem punktu końcowego usługi API “orderDetail”.
items[index]itemHSCodeTo pole jest używane do przekazywania kodu HS przedmiotu i może być z kropkami lub bez.
Przykładowe wartości: “3926901000” lub “3926.90.1000”string
items[index].itemURLTo pole jest używane do przekazywania URL do strony produktu przedmiotu. string / URL
items[index].lengthTo pole jest używane do przekazywania długości przedmiotu i jest wysoce zalecane dla dokładnych wycen wysyłki. Jednostki długości są

WYMAGANE

w calach. string - dodatnia liczba zmiennoprzecinkowa, dwa miejsca po przecinku / całkowita (cale)
items[index].nonShippableTo pole jest używane do wskazania, czy przedmiot powinien być uwzględniony w obliczeniach wysyłki, cła i podatków. Cyfrowe pobrania, kody rabatowe, opłaty manipulacyjne itp. powinny być przekazywane z wartością “true”. boolean: true lub false
items[index].productIdTo pole jest używane do przekazywania ilości pozycji zamówienia. string
items[index].quantity

WYMAGANE

To pole jest używane do przekazywania ilości pozycji zamówienia. string
items[index].skuTo pole jest używane do przekazywania SKU / UPC / itp. przedmiotu. string
items[index].unitPrice

WYMAGANE

To pole jest używane do przekazywania jednostkowej ceny pozycji zamówienia. dodatnia liczba zmiennoprzecinkowa, dwa miejsca po przecinku / całkowita
items[index].weightTo pole jest używane do przekazywania wagi przedmiotu i jest wysoce zalecane dla dokładnych wycen wysyłki. Jednostki wagi domyślnie są ustawione na “LBS”, chyba że inna jednostka wagi zostanie przekazana w items[index].itemWeightUnits``string - dodatnia liczba zmiennoprzecinkowa, dwa miejsca po przecinku / całkowita
items[index].weightUnitsTo pole jest używane do nadpisania domyślnych jednostek wagi przedmiotu. Jednostki wagi przedmiotu domyślnie są ustawione na “LBS”, chyba że inna jednostka wagi zostanie przekazana w tym polu. string - "LB", "OZ", "KG" lub "G”
items[index].widthTo pole jest używane do przekazywania szerokości przedmiotu i jest wysoce zalecane dla dokładnych wycen wysyłki. Jednostki szerokości są

WYMAGANE

w calach. string - dodatnia liczba zmiennoprzecinkowa, dwa miejsca po przecinku / całkowita (cale)
misc1 - misc6To pole jest używane do przekazywania danych różnorodnych związanych z zamówieniem za pośrednictwem API Zonos, aby mogły być pobrane wraz z danymi zamówienia zwróconymi z punktu końcowego usługi API Zonos “orderDetail”. string
referenceIdTo pole jest używane do przekazywania unikalnej wartości identyfikacyjnej dla koszyka/sesji/itd. w Twoim systemie. Może być używane do wyszukiwania identyfikatora zamówienia Zonos za pośrednictwem punktu końcowego usługi API Zonos “orderDetail”. string
storeId

WYMAGANE

Identyfikator sklepu dostarczony przez Zonos. integer

Dodatkowe typy danych string

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

Zniżki, kupony i kody promocyjne 

Aby wysłać zniżki, kupony i kody promocyjne do Zonos za pośrednictwem postu serwera, muszą być przekazywane jako osobny przedmiot z ujemną wartością dla parametrów: “unitPrice” i “nonShippable”:true.

PRZYKŁAD MAPY ZNIŻKI

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

Odpowiedź HTTPS

Sukces odpowiedzi HTTP

Format wiadomości: JSON

PRZYKŁADOWA ODPOWIEDŹ SUKCESU

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

Definicje odpowiedzi JSON

poleuwagi
tempCartUUIDTen parametr będzie zawierał GUID przypisany do międzynarodowego koszyka Twojego klienta, utworzonego w systemie Zonos. To pole będzie przekazywane za pomocą parametru zapytania string w URL podczas przekierowywania przeglądarki użytkownika do Zonos Checkout.

Odpowiedzi HTTP błędów

Kod błęduznaczenie
400Nieoczekiwany znak w ciele żądania.
406Nieakceptowalne. Nagłówek HTTP dla „Accept” jest nieprawidłowy.
415Nieobsługiwany typ mediów. Nagłówek HTTP dla „Content-Type” jest nieprawidłowy.
422Nieprzetwarzalny byt.
500„storeId” był nieprawidłowy lub ciało JSON nie mogło zostać sparsowane.

PRZYKŁAD ODPOWIEDZI BŁĘDU

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
    <title>Error 422 Unprocessable Entity</title>
  </head>
  <body>
    <h2>HTTP ERROR 422</h2>
    <p>
      Problem accessing /v2/createTempCart. Reason:
      <pre>Unprocessable Entity</pre>
    </p>
    <h2>The request entity had the following errors:</h2>
    <ul>
      <li>items may not be empty (was null)</li>
      <li>items may not be null (was null)</li>
    </ul>
  </body>
</html>

Przekierowanie do Zonos Checkout 

Po otrzymaniu pomyślnej odpowiedzi zawierającej tempCartUUID, twój serwer wyśle przekierowanie z przeglądarki klienta do Zonos Checkout z odpowiednimi parametrami ciągu zapytania opisanymi poniżej.

Przykładowy adres URL przekierowania: https://[yourassignedsubdomain].iglobalstores.com/?tempCartUUID=826b8f22-0de6-4717-90c7-366def7d0782&country=CA

Uwaga: [yourassignedsubdomain] - Skontaktuj się z członkiem zespołu wdrożeniowego Zonos, aby otrzymać swój subdomenę Zonos.com.

Parametry żądania URL

poleuwagi
tempCartUUID

WYMAGANE

Ta wartość jest uzyskiwana poprzez wywołanie punktu końcowego usługi API Zonos createTempCart. string / GUID
countryDwu-literowy kod ISO kraju docelowego two-letter ISO code. Zdecydowanie zalecamy przekazanie tego parametru dla lepszego doświadczenia użytkownika. Parametr country automatycznie wybierze kraj docelowy w Zonos Checkout. Korzystając z Zonos Hello JS (JavaScript) na stronie, możesz uzyskać tę wartość, wywołując metodę JavaScript: zonos.country(). string (Długość: 2)

Dodatkowe typy danych string

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

Czy ta strona była pomocna?