DOCS
Checkout•
HjemAPI reference Checkout REST API Opret en checkout

Opret en checkout

Udforsk nøgle/værdi-parne, der er involveret i oprettelse af en checkout.

Dette API-endpoint bruges til at sende kurvoplysninger og varer fra kundens kurv til Zonos API.

Du modtager et JSON-svar, der indeholder en tempCartUUID, en unik kurvidentifikator i Zonos-systemet. Denne bruges til at omdirigere kunden til Zonos Checkout for at gennemføre ordren.

Attributter 

JSON-nøgle/værdi-par i request body

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

felt↕noter↕
boxCountEksempelværdi: 22x15x15(1),8x8x4(2),32x22x14(1)
Format: Kommasepareret liste over kassestørrelser og antal. I eksemplet ovenfor er der i alt 4 kasser. Den første kasse på listen er 22 tommer lang, 15 tommer bred og 15 tommer høj. Der bruges kun én kasse i den størrelse. Der vil være to kasser i størrelsen: 8x8x4 tommer. Det er acceptabelt at sende samme kassestørrelse flere gange, hvis det er nemmere for dig, f.eks.: "22x15x15(1),22x15x15(1)", hvilket betyder 2 kasser i størrelsen: 22x15x15 tommer. Dette felt beskriver de kasser, der bruges til at sende ordren. Det forventes ikke, at en merchant kender dette på ordretidspunktet; hvis det er kendt, kan det dog sendes i string-format.
contShoppingURLDette felt bruges til at sende en URL, der tilsidesætter HREF for knappen "Continue Shopping" i Zonos Checkout. string
domesticShippingChargeDette felt bruges til at sende et indenlandsk forsendelsesgebyr til Zonos Checkout, og beløbet tilføjes til forsendelsen. Dette kan konfigureres til at tilføje forsendelsestotalen eller opdeles som en separat linjepost. positive floating point, two decimal places
externalConfirmationPageURLDette felt bruges til at sende en URL til din ordrebekræftelses-/tak-side. Når en kunde gennemfører betaling i Zonos Checkout, omdirigeres de til denne URL for ordrebekræftelse. Denne URL bruges ofte til at udløse et kald til Zonos "orderDetail" API service endpoint for at hente ordredetaljerne og importere ordren i systemet. string
footerHTMLDette felt bruges til at sende en URL-kodet HTML-streng. Denne HTML-streng dekodes og placeres før det afsluttende body-tag på checkout-siden. Bruges almindeligvis til at sende kode til remarketing, analytics osv. URL encoded string
items

REQUIRED

Dette felt er en liste over item maps. JSON string
items[index].countryOfOriginDette felt bruges til at sende varens oprindelsesland. Parameteren skal være landets to-bogstavs ISO-kode. string
items[index].description

REQUIRED

Dette felt bruges til at sende en fuld varebeskrivelse af kurvlinjen, inklusive eventuelle varevalg, farver osv. string
items[index].heightDette felt bruges til at sende varens højde og anbefales stærkt for præcise forsendelsestilbud. Højdeenheder er

REQUIRED

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

REQUIRED

Dette felt bruges til at sende URL'en til varens produktbillede. URL'en skal være HTTPS for at blive vist i Zonos Checkout. string / HTTPS URL
items[index]itemBrandDette felt bruges til at sende varemærketstring
items[index]itemCategoryDette felt bruges til at sende varekategorien og kan sendes pipe-separeret, hvis varen har mere end én kategori.
Eksempelværdier: "shoes" eller "shoes|sport-shoes|discount-shoes"string
items[index]itemCustomizationDette felt bruges til at sende yderligere oplysninger om varen, der ikke vises i Zonos Checkout; disse kan dog hentes via "orderDetail" API service endpoint.
items[index]itemHSCodeDette felt bruges til at sende varens HS-kode og kan være med eller uden punktummer.
Eksempelværdier: "3926901000" eller "3926.90.1000"string
items[index].itemURLDette felt bruges til at sende URL'en til varens produktside. string / URL
items[index].lengthDette felt bruges til at sende varens længde og anbefales stærkt for præcise forsendelsestilbud. Længdeenheder er

REQUIRED

i tommer. string - positive floating point, two decimal places / integer (inches)
items[index].nonShippableDette felt bruges til at angive, om varen skal inkluderes i forsendelses-, told- og skatteberegninger. Digitale downloads, rabatkoder, håndteringsgebyrer osv. skal sendes med værdien "true". boolean: true or false
items[index].productIdDette felt bruges til at sende linjevaremængden. string
items[index].quantity

REQUIRED

Dette felt bruges til at sende linjevaremængden. string
items[index].skuDette felt bruges til at sende varens SKU / UPC / osv. string
items[index].unitPrice

REQUIRED

Dette felt bruges til at sende linjevarens enhedspris. positive floating point, two decimal places / integer
items[index].weightDette felt bruges til at sende varens vægt og anbefales stærkt for præcise forsendelsestilbud. Vægtenheder er som standard "LBS", medmindre en anden vægtenhed sendes i items[index].itemWeightUnits``string - positive floating point, two decimal places / integer
items[index].weightUnitsDette felt bruges til at tilsidesætte standard vægtenheder for varen. Vægtenheder for varer er som standard "LBS", medmindre en anden vægtenhed sendes i dette felt. string - "LB", "OZ", "KG", or "G"
items[index].widthDette felt bruges til at sende varens bredde og anbefales stærkt for præcise forsendelsestilbud. Breddeenheder er

REQUIRED

i tommer. string - positive floating point, two decimal places / integer (inches)
misc1 - misc6Dette felt bruges til at sende diverse data knyttet til ordren gennem Zonos API, som kan hentes sammen med ordredata returneret fra Zonos "orderDetail" API service endpoint. string
referenceIdDette felt bruges til at sende en unik referenceidentifikationsværdi for kurven/sessionen/osv. i dit system. Dette kan bruges til at slå Zonos ordre-ID op via Zonos "orderDetail" API service endpoint. string
storeId

REQUIRED

Store ID leveret af Zonos. integer

Yderligere string-datatyper

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

Rabatter, kuponer og promokoder 

For at sende rabatter, kuponer og promokoder til Zonos via server post skal de sendes som en separat vare med en negativ værdi for parametrene: "unitPrice" og "nonShippable":true.

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

HTTPS-svar

Succesfuldt HTTP-svar

Meddelelsesformat: JSON

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

Definitioner af response JSON

felt↕noter↕
tempCartUUIDDenne parameter indeholder en GUID, der er tildelt kundens internationale kurv og oprettet i Zonos-systemet. Denne værdi sendes via en URL-query string-parameter, når brugerens browser omdirigeres til Zonos Checkout.

Fejl-HTTP-svar

Fejlkode↕betydning↕
400Uventet tegn i request body.
406Not Acceptable. HTTP-header for "Accept" er ugyldig.
415Unsupported media type. HTTP-header for "Content-Type" er ugyldig.
422Unprocessable entity.
500"storeId" var forkert, eller JSON body kunne ikke parses.
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

    Omdirigering til Zonos Checkout 

    Efter at have modtaget et succesfuldt svar, der indeholder tempCartUUID, sender din server en omdirigering fra kundens browser til Zonos Checkout med de relevante URL-query string-parametre beskrevet nedenfor.

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

    Bemærk: [yourassignedsubdomain] - Kontakt dit Zonos-implementeringsteammedlem for at modtage dit Zonos.com-subdomæne.

    URL-requestparametre

    felt↕noter↕
    tempCartUUID

    REQUIRED

    		Denne værdi hentes ved at kalde Zonos createTempCart API service endpoint. string / GUID
    countryDestinationslandets to-bogstavs ISO-kode. Vi anbefaler stærkt at sende denne parameter for brugeroplevelsen. country-parameteren forudvælger destinationslandet i Zonos Checkout. Når du bruger Zonos Hello JS (JavaScript) på sitet, kan du hente denne værdi ved at kalde JavaScript-metoden: zonos.country(). string (Length: 2)

    Yderligere string-datatyper

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

    Var denne side nyttig?

    Få support·Juridiske dokumenter·© 2026 Zonos
    På denne side:
  • Opret en checkout
  • Attributter
  • Rabatter, kuponer og promokoder
  • Omdirigering til Zonos Checkout