DOCS
Checkout•
StartseiteAPI-Referenz Checkout REST API Checkout erstellen

Checkout erstellen

Die Schlüssel-Wert-Paare beim Erstellen eines Checkouts im Überblick.

Dieser API-Endpunkt sendet Warenkorbinformationen und Artikel aus dem Warenkorb des Kunden an die Zonos-API.

Sie erhalten eine JSON-Antwort mit tempCartUUID, einer eindeutigen Warenkorb-ID im Zonos-System. Damit leiten Sie den Kunden zum Zonos Checkout zur Bestellabwicklung weiter.

Attribute 

JSON-Schlüssel-Wert-Paare im Request-Body

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

Feld↕Hinweise↕
boxCountBeispielwert: 22x15x15(1),8x8x4(2),32x22x14(1)
Format: Kommagetrennte Liste von Kartonabmessungen und Anzahl. Im Beispiel oben gibt es insgesamt 4 Kartons. Der erste Karton in der Liste ist 22 Zoll lang, 15 Zoll breit und 15 Zoll hoch. Für diese Größe wird nur ein Karton verwendet. Es gibt zwei Kartons der Größe 8x8x4 Zoll. Es ist zulässig, dieselbe Kartonabmessung mehrfach zu übergeben, z. B. „22x15x15(1),22x15x15(1)“ – das bedeutet 2 Kartons der Größe 22x15x15 Zoll. Dieses Feld beschreibt die Kartons für den Versand der Bestellung. Es wird nicht erwartet, dass ein Händler dies zum Bestellzeitpunkt kennt; wenn bekannt, kann es im string-Format übergeben werden.
contShoppingURLDieses Feld übergibt eine URL, um den HREF der Schaltfläche „Continue Shopping“ im Zonos Checkout zu überschreiben. string
domesticShippingChargeDieses Feld übergibt eine inländische Versandgebühr an Zonos Checkout; der Betrag wird zum Versand addiert. Konfigurierbar als Gesamtversand oder als separate Position. positive floating point, two decimal places
externalConfirmationPageURLDieses Feld übergibt die URL Ihrer Bestellbestätigungs-/Danke-Seite. Nach Zahlungsabschluss im Zonos Checkout wird der Kunde dorthin weitergeleitet. Diese URL wird häufig genutzt, um den Zonos-„orderDetail“-API-Endpunkt aufzurufen, Bestelldetails abzurufen und die Bestellung zu importieren. string
footerHTMLDieses Feld übergibt eine URL-codierte HTML-Zeichenkette. Sie wird dekodiert und vor dem schließenden body-Tag der Checkout-Seite eingefügt. Häufig für Re-Marketing, Analytics usw. URL encoded string
items

REQUIRED

Liste von Artikel-Maps. JSON string
items[index].countryOfOriginHerkunftsland des Artikels. Parameter muss der zweistellige ISO-Ländercode sein. string
items[index].description

REQUIRED

Vollständige Artikelbeschreibung der Warenkorbposition inkl. Optionen, Farben usw. string
items[index].heightArtikelhöhe; dringend empfohlen für genaue Versandangebote. Höheneinheit

REQUIRED

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

REQUIRED

URL zum Produktbild. Die URL muss HTTPS sein, um im Zonos Checkout angezeigt zu werden. string / HTTPS URL
items[index]itemBrandArtikelmarke string
items[index]itemCategoryArtikelkategorie; bei mehreren Kategorien pipe-getrennt übergeben.
Beispielwerte: „shoes“ oder „shoes|sport-shoes|discount-shoes“string
items[index]itemCustomizationZusätzliche Artikeldetails, die im Zonos Checkout nicht angezeigt werden; abrufbar über den „orderDetail“-API-Endpunkt.
items[index]itemHSCodeHS-Code des Artikels, mit oder ohne Punkte.
Beispielwerte: „3926901000“ oder „3926.90.1000“string
items[index].itemURLURL zur Produktseite. string / URL
items[index].lengthArtikellänge; dringend empfohlen für genaue Versandangebote. Längeneinheit

REQUIRED

in Zoll. string - positive floating point, two decimal places / integer (inches)
items[index].nonShippableGibt an, ob der Artikel in Versand-, Zoll- und Steuerberechnungen einbezogen wird. Digitale Downloads, Rabattcodes, Bearbeitungsgebühren usw. sollten mit dem Wert „true“ übergeben werden. boolean: true or false
items[index].productIdProdukt-ID der Position. string
items[index].quantity

REQUIRED

Mengenangabe der Position. string
items[index].skuSKU / UPC / etc. des Artikels. string
items[index].unitPrice

REQUIRED

Stückpreis der Position. positive floating point, two decimal places / integer
items[index].weightArtikelgewicht; dringend empfohlen für genaue Versandangebote. Gewichtseinheit standardmäßig „LBS“, sofern nicht in items[index].itemWeightUnits anders angegeben.string - positive floating point, two decimal places / integer
items[index].weightUnitsÜberschreibt die Standard-Gewichtseinheit. Standard „LBS“, sofern hier nicht anders gesetzt. string - "LB", "OZ", "KG", or "G”
items[index].widthArtikelbreite; dringend empfohlen für genaue Versandangebote. Breiteneinheit

REQUIRED

in Zoll. string - positive floating point, two decimal places / integer (inches)
misc1 - misc6Verschiedene Bestelldaten über die Zonos-API; abrufbar mit den von „orderDetail“ zurückgegebenen Bestelldaten. string
referenceIdEindeutige Referenz-ID für Warenkorb/Sitzung/etc. in Ihrem System. Ermöglicht Nachschlagen der Zonos-Bestell-ID über „orderDetail“. string
storeId

REQUIRED

Von Zonos bereitgestellte Store-ID. integer

Zusätzliche String-Datentypen

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

Rabatte, Gutscheine und Promo-Codes 

Rabatte, Gutscheine und Promo-Codes müssen als separater Artikel mit negativem Wert für unitPrice und nonShippable: true im Server-POST übergeben werden.

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

HTTPS-Antwort

Erfolgreiche HTTP-Antwort

Nachrichtenformat: JSON

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

Definitionen der Antwort-JSON

Feld↕Hinweise↕
tempCartUUIDEnthält eine GUID für den internationalen Warenkorb des Kunden im Zonos-System. Wird als URL-Query-string-Parameter beim Weiterleiten des Browsers zum Zonos Checkout übergeben.

Fehler-HTTP-Antworten

Fehlercode↕Bedeutung↕
400Unerwartetes Zeichen im Request-Body.
406Not Acceptable. HTTP-Header „Accept“ ist ungültig.
415Unsupported media type. HTTP-Header „Content-Type“ ist ungültig.
422Unprocessable entity.
500„storeId“ war falsch oder JSON-Body konnte nicht geparst werden.
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

    Weiterleitung zum Zonos Checkout 

    Nach erfolgreicher Antwort mit tempCartUUID leitet Ihr Server den Browser des Kunden zum Zonos Checkout mit den unten beschriebenen URL-Query-Parametern weiter.

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

    Hinweis: [yourassignedsubdomain] – Wenden Sie sich an Ihr Zonos-Implementierungsteam, um Ihre Zonos.com-Subdomain zu erhalten.

    URL-Anfrageparameter

    Feld↕Hinweise↕
    tempCartUUID

    REQUIRED

    		Wert aus dem Zonos-createTempCart-API-Endpunkt. string / GUID
    countryZweistelliger ISO-Ländercode des Ziellands. Wir empfehlen dringend diesen Parameter für die Nutzererfahrung. country wählt das Zielland im Zonos Checkout vorab. Mit Zonos Hello JS auf der Website erhalten Sie den Wert über zonos.country(). string (Length: 2)

    Zusätzliche String-Datentypen

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

    War diese Seite hilfreich?

    Holen Sie sich Unterstützung·Rechtsdokumente·© 2026 Zonos
    Auf dieser Seite:
  • Checkout erstellen
  • Attribute
  • Rabatte, Gutscheine und Promo-Codes
  • Weiterleitung zum Zonos Checkout