Maak een checkout

Verken de sleutel/waarde-paren die betrokken zijn bij het maken van een checkout.

Dit API-eindpunt wordt gebruikt om winkelwagentinformatie en artikelen van de winkelwagent van de klant naar de Zonos API te verzenden.

U ontvangt een JSON-respons met een tempCartUUID, een unieke winkelwagentidentifier in het Zonos Systeem. Dit zal worden gebruikt om de klant om te leiden naar de Zonos Checkout om de bestelling te voltooien.

Attributen

JSON sleutel/waarde-paren in de aanvraagbody

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

veld	opmerkingen
`boxCount`	Voorbeeldwaarde: 22x15x15(1),8x8x4(2),32x22x14(1) Formaat: Komma-gescheiden lijst van doosafmetingen en aantallen. In het bovenstaande voorbeeld zijn er in totaal 4 dozen. De eerste doos in de lijst is 22 inch lang, 15 inch breed en 15 inch hoog. Er zal slechts één doos van die grootte worden gebruikt. Er zullen twee dozen van de grootte: 8x8x4 inch zijn. Het is acceptabel om dezelfde doosafmeting meerdere keren door te geven als dat voor u gemakkelijk is, zoals dit: “22x15x15(1),22x15x15(1)”, wat betekent 2 dozen van de grootte: 22x15x15 inch. Dit veld beschrijft de dozen die zullen worden gebruikt om de bestelling te verzenden. Het wordt niet verwacht dat een handelaar dit op het moment van bestelling weet; echter, als het bekend is, kan het in het `string` formaat worden doorgegeven.
`contShoppingURL`	Dit veld wordt gebruikt om een URL door te geven om de HREF van de “Doorgaan met winkelen” knop binnen de Zonos Checkout te overschrijven. `string`
`domesticShippingCharge`	Dit veld wordt gebruikt om een binnenlandse verzendkosten door te geven aan de Zonos Checkout, en het bedrag zal aan de verzendkosten worden toegevoegd. Dit kan worden geconfigureerd om het verzendtotaal toe te voegen of als een afzonderlijke regelitem te worden uitgesplitst. `positieve drijvende komma, twee decimalen`
`externalConfirmationPageURL`	Dit veld wordt gebruikt om een URL van uw bestelbevestiging / bedankpagina door te geven. Nadat een klant de betaling binnen de Zonos Checkout heeft voltooid, wordt hij omgeleid naar deze URL voor de bestelbevestiging. Deze URL wordt vaak gebruikt om een oproep naar de Zonos “orderDetail” API-service-eindpunt te activeren om de bestelgegevens op te halen en de bestelling in het systeem te importeren. `string`
`footerHTML`	Dit veld wordt gebruikt om een URL-gecodeerde HTML-string door te geven. Deze HTML-string zal worden gedecodeerd en vóór de sluitende body-tag op de checkout pagina worden geplaatst. Vaak gebruikt om code voor remarketing, analytics, enz. door te geven. `URL-gecodeerde string`
`items` VERPLICHT	Dit veld is een lijst van itemkaarten. `JSON string`
`items[index].countryOfOrigin`	Dit veld wordt gebruikt om het land van herkomst van het item door te geven. Parameter moet de land twee-letter ISO-code zijn. `string`
`items[index].description` VERPLICHT	Dit veld wordt gebruikt om een volledige itemomschrijving van het winkelwagentitem door te geven, inclusief eventuele itemopties, kleuren, enz. `string`
`items[index].height`	Dit veld wordt gebruikt om de hoogte van het item door te geven en wordt ten zeerste aanbevolen voor nauwkeurige verzendoffertes. Hoogte-eenheden zijn VERPLICHT in inches. `string - positieve drijvende komma, twee decimalen / geheel getal (inches)`
`items[index].imageURL` VERPLICHT	Dit veld wordt gebruikt om de URL naar de productafbeelding van het item door te geven. De URL moet HTTPS zijn om binnen de Zonos Checkout te worden weergegeven. `string / HTTPS URL`
`items[index]itemBrand`	Dit veld wordt gebruikt om het merk van het item door te geven `string`
`items[index]itemCategory`	Dit veld wordt gebruikt om de itemcategorie door te geven en kan pipe-gescheiden worden doorgegeven als het item meer dan één categorie heeft. Voorbeeldwaarden: “schoenen” of “schoenen\|sport-schoenen\|kortings-schoenen”`string`
`items[index]itemCustomization`	Dit veld wordt gebruikt om aanvullende details over het item door te geven die niet worden weergegeven in de Zonos Checkout; echter, deze kunnen worden opgehaald via de “orderDetail” API-service-eindpunt.
`items[index]itemHSCode`	Dit veld wordt gebruikt om de HS-code van het item door te geven en kan met of zonder punten zijn. Voorbeeldwaarden: “3926901000” of “3926.90.1000”`string`
`items[index].itemURL`	Dit veld wordt gebruikt om de URL naar de productpagina van het item door te geven. `string / URL`
`items[index].length`	Dit veld wordt gebruikt om de lengte van het item door te geven en wordt ten zeerste aanbevolen voor nauwkeurige verzendoffertes. Lengte-eenheden zijn VERPLICHT in inches. `string - positieve drijvende komma, twee decimalen / integer (inches)`
`items[index].nonShippable`	Dit veld wordt gebruikt om aan te geven of het item moet worden opgenomen in de verzend-, douane- en belastingberekeningen. Digitale downloads, kortingscodes, verwerkingskosten, enz. moeten worden doorgegeven met een waarde van “true”. `boolean: true of false`
`items[index].productId`	Dit veld wordt gebruikt om de hoeveelheid van het lijnitem door te geven. `string`
`items[index].quantity` VERPLICHT	Dit veld wordt gebruikt om de hoeveelheid van het lijnitem door te geven. `string`
`items[index].sku`	Dit veld wordt gebruikt om de SKU / UPC / enz. van het item door te geven. `string`
`items[index].unitPrice` VERPLICHT	Dit veld wordt gebruikt om de eenheidsprijs van het lijnitem door te geven. `positieve drijvende komma, twee decimalen / integer`
`items[index].weight`	Dit veld wordt gebruikt om het gewicht van het item door te geven en wordt ten zeerste aanbevolen voor nauwkeurige verzendoffertes. Gewichtseenheden zijn standaard ingesteld op “LBS” tenzij een andere gewichtseenheid wordt doorgegeven in items[index].itemWeightUnits``string - positieve drijvende komma, twee decimalen / integer
`items[index].weightUnits`	Dit veld wordt gebruikt om de standaard gewichtseenheden van het item te overschrijven. Gewichtseenheden zijn standaard ingesteld op “LBS” tenzij een andere gewichtseenheid in dit veld wordt doorgegeven. `string - "LB", "OZ", "KG", of "G”`
`items[index].width`	Dit veld wordt gebruikt om de breedte van het item door te geven en wordt ten zeerste aanbevolen voor nauwkeurige verzendoffertes. Breedte-eenheden zijn VERPLICHT in inches. `string - positieve drijvende komma, twee decimalen / integer (inches)`
`misc1 - misc6`	Dit veld wordt gebruikt om diverse gegevens die aan de bestelling zijn gekoppeld door te geven via de Zonos API om samen met de ordergegevens die worden geretourneerd van de Zonos “orderDetail” API-service-eindpunt te worden opgehaald. `string`
`referenceId`	Dit veld wordt gebruikt om een unieke referentie-identificatiewaarde voor de winkelwagentje/sessie/etc. in uw systeem door te geven. Dit kan worden gebruikt om de Zonos order-ID op te zoeken via de Zonos “orderDetail” API-service-eindpunt. `string`
`storeId` VERPLICHT	Winkel-ID verstrekt door Zonos. `integer`

Aanvullende string datatypes

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

Kortingen, coupons en promotiecodes

Om kortingen, coupons en promotiecodes naar Zonos te verzenden via de serverpost, moeten ze als een afzonderlijk item met een negatieve waarde voor de parameters: “unitPrice” en “nonShippable”:true worden doorgegeven.

VOORBEELD KORTING ITEM KAART

{
  "description": "Discount (10OFF) - 10% OFF",
  "unitPrice": -15.5,
  "quantity": 1,
  "nonShippable": true
}

HTTPS-respons

Succes HTTP-respons

Berichtformaat: JSON

VOORBEELD SUCCESRESPONS

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

Response JSON-definities

veld	opmerkingen
`tempCartUUID`	Deze parameter bevat een GUID die is toegewezen aan de internationale winkelwagentje van uw klant en is aangemaakt in het Zonos-systeem. Dit veld wordt doorgegeven via een URL-query `string`-parameter tijdens het omleiden van de browser van de gebruiker naar de Zonos Checkout.

Fout HTTP-responses

Foutcode	betekenis
400	Onverwacht teken in het aanvraaglichaam.
406	Niet acceptabel. HTTP-header voor “Accept” is ongeldig.
415	Ongeldig mediatype. HTTP-header voor “Content-Type” is ongeldig.
422	Onverwerkbare entiteit.
500	“storeId” was onjuist of JSON-lichaam kon niet worden geparsed.

VOORBEELD FOUTRESPONS

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

Omleiden naar de Zonos Checkout

Na het ontvangen van een succesvolle reactie met de tempCartUUID, zal uw server een omleiding van de browser van de klant naar de Zonos Checkout sturen met de juiste URL-querystringparameters die hieronder worden behandeld.

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

Opmerking: [yourassignedsubdomain] - Neem contact op met uw Zonos implementatieteamlid om uw Zonos.com-subdomein te ontvangen.

URL-aanvraagparameters

veld opmerkingen

veld	opmerkingen
`tempCartUUID` VERPLICHT	Deze waarde wordt verkregen door de Zonos `createTempCart` API-service-eindpunt aan te roepen. `string / GUID`
`country`	Tweeletterige ISO-code van het bestemmingsland two-letter ISO code. We raden ten zeerste aan om deze parameter door te geven voor de gebruikerservaring. De `country` parameter zal het bestemmingsland vooraf selecteren in de Zonos Checkout. Wanneer u de Zonos Hello JS (JavaScript) op de site gebruikt, kunt u deze waarde verkrijgen door de JavaScript-methode aan te roepen: `zonos.country()`. `string` (Lengte: 2)

tempCartUUID

VERPLICHT

Deze waarde wordt verkregen door de Zonos createTempCart API-service-eindpunt aan te roepen. string / GUID

country Tweeletterige ISO-code van het bestemmingsland two-letter ISO code. We raden ten zeerste aan om deze parameter door te geven voor de gebruikerservaring. De country parameter zal het bestemmingsland vooraf selecteren in de Zonos Checkout. Wanneer u de Zonos Hello JS (JavaScript) op de site gebruikt, kunt u deze waarde verkrijgen door de JavaScript-methode aan te roepen: zonos.country(). string (Lengte: 2)

Aanvullende stringgegevens typen

customerName
customerCompany
customerEmail
customerPhone
customerAltPhone
customerAddress1
customerAddress2
customerCity
customerState
customerZip

Was deze pagina nuttig?

Vragen?

Neem contact met ons op.

Zie Zonos

beleid en overeenkomsten