What is the Checkout API?

This API endpoint is used to send cart information and items from the customer’s cart to the Zonos API. You will receive a JSON response containing a `tempCartUUID`, a unique cart identifier in the Zonos System. This will be used to redirect the customer to the Zonos Checkout to complete the order.

What is the `tempCartUUID`?

This parameter will contain a GUID assigned to your customer’s international cart and created in the Zonos system. This filed will be passed via a URL query `string` parameter while redirecting the user’s browser to the Zonos Checkout.

How to redirect to the Zonos Checkout?

After receiving a successful response containing the `tempCartUUID`, your server will send a redirect from the customer's browser to the Zonos Checkout with the appropriate URL query string parameters.

What are the URL request parameters?

`tempCartUUID` is a required value obtained by calling the Zonos `createTempCart` API service endpoint. `country` is the destination country’s two-letter ISO code. We highly recommend passing this parameter for user experience. The `country` parameter will preselect the destination country inside the Zonos Checkout.

Checkout•

DomReferencja API Checkout REST API 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

pole	notatki
`boxCount`	Przykł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`.
`contShoppingURL`	To pole służy do przekazania adresu URL w celu zastąpienia HREF przycisku "Kontynuuj zakupy" wewnątrz Zonos Checkout. `string`
`domesticShippingCharge`	To 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`
`externalConfirmationPageURL`	To 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`
`footerHTML`	To 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].countryOfOrigin`	To 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].height`	To 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]itemBrand`	To pole służy do przekazania marki przedmiotu `string`
`items[index]itemCategory`	To 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]itemCustomization`	To 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]itemHSCode`	To 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].itemURL`	To pole jest używane do przekazywania URL do strony produktu przedmiotu. `string / URL`
`items[index].length`	To 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].nonShippable`	To 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].productId`	To 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].sku`	To 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].weight`	To 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].weightUnits`	To 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].width`	To 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 - misc6`	To 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`
`referenceId`	To 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

{
  "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

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

Definicje odpowiedzi JSON

pole	uwagi
`tempCartUUID`	Ten 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łędu	znaczenie
400	Nieoczekiwany znak w ciele żądania.
406	Nieakceptowalne. Nagłówek HTTP dla „Accept” jest nieprawidłowy.
415	Nieobsługiwany typ mediów. Nagłówek HTTP dla „Content-Type” jest nieprawidłowy.
422	Nieprzetwarzalny byt.
500	„storeId” był nieprawidłowy lub ciało JSON nie mogło zostać sparsowane.

PRZYKŁAD ODPOWIEDZI BŁĘDU

<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

pole	uwagi
`tempCartUUID` WYMAGANE	Ta wartość jest uzyskiwana poprzez wywołanie punktu końcowego usługi API Zonos `createTempCart`. `string / GUID`
`country`	Dwu-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?

Zarezerwuj demonstrację

Pytania?

Uzyskaj wsparcie

Zobacz Zonos

polityki i umowy