DOCS
Checkout•
InicioReferencia de la API Checkout REST API Crear un checkout

Crear un checkout

Explore los pares clave/valor implicados en la creación de un checkout.

Este endpoint de API se utiliza para enviar información del carrito y artículos desde el carrito del cliente a la API de Zonos.

Recibirá una respuesta JSON que contiene un tempCartUUID, un identificador único del carrito en el sistema de Zonos. Se utilizará para redirigir al cliente a Zonos Checkout y completar el pedido.

Atributos 

Pares clave/valor JSON en el cuerpo de la solicitud

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

field↕notes↕
boxCountValor de ejemplo: 22x15x15(1),8x8x4(2),32x22x14(1)
Formato: Lista separada por comas de dimensiones de caja y cantidad. En el ejemplo anterior, hay un total de 4 cajas. La primera caja de la lista tendrá 22 pulgadas de largo, 15 de ancho y 15 de alto. Solo se utilizará una caja de ese tamaño. Habrá dos cajas de tamaño 8x8x4 pulgadas. Es aceptable pasar la misma dimensión de caja varias veces si le resulta más sencillo, como: "22x15x15(1),22x15x15(1)", lo que significa 2 cajas de tamaño 22x15x15 pulgadas. Este campo describe las cajas que se utilizarán para enviar el pedido. No se espera que un comerciante conozca esto en el momento del pedido; sin embargo, si se conoce, puede pasarse en formato string.
contShoppingURLEste campo se utiliza para pasar una URL que anule el HREF del botón "Continue Shopping" dentro de Zonos Checkout. string
domesticShippingChargeEste campo se utiliza para pasar un cargo de envío nacional a Zonos Checkout, y el importe se añadirá al envío. Puede configurarse para añadir el total de envío o desglosarse como una línea independiente. positive floating point, two decimal places
externalConfirmationPageURLEste campo se utiliza para pasar la URL de su página de confirmación de pedido / agradecimiento. Después de que un cliente complete el pago en Zonos Checkout, se le redirigirá a esta URL para la confirmación del pedido. Esta URL se utiliza con frecuencia para activar una llamada al endpoint de servicio API "orderDetail" de Zonos para recuperar el detalle del pedido e importarlo al sistema. string
footerHTMLEste campo se utiliza para pasar una cadena HTML codificada en URL. Esta cadena HTML se decodificará y se colocará antes de la etiqueta de cierre del body en la página de checkout. Se utiliza habitualmente para pasar código de remarketing, analítica, etc. URL encoded string
items

OBLIGATORIO

Este campo es una lista de mapas de artículos. JSON string
items[index].countryOfOriginEste campo se utiliza para pasar el país de origen del artículo. El parámetro debe ser el código ISO de dos letras del país. string
items[index].description

OBLIGATORIO

Este campo se utiliza para pasar una descripción completa del artículo de la línea del carrito, incluidas opciones, colores, etc. string
items[index].heightEste campo se utiliza para pasar la altura del artículo y se recomienda encarecidamente para cotizaciones de envío precisas. Las unidades de altura son

OBLIGATORIO

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

OBLIGATORIO

Este campo se utiliza para pasar la URL de la imagen del producto. La URL debe ser HTTPS para mostrarse dentro de Zonos Checkout. string / HTTPS URL
items[index]itemBrandEste campo se utiliza para pasar la marca del artículostring
items[index]itemCategoryEste campo se utiliza para pasar la categoría del artículo y puede pasarse delimitada por barras verticales si el artículo tiene más de una categoría.
Valores de ejemplo: "shoes" o "shoes|sport-shoes|discount-shoes"string
items[index]itemCustomizationEste campo se utiliza para pasar detalles adicionales sobre el artículo que no se muestran en Zonos Checkout; sin embargo, pueden recuperarse a través del endpoint de servicio API "orderDetail".
items[index]itemHSCodeEste campo se utiliza para pasar el código HS del artículo, con o sin puntos.
Valores de ejemplo: "3926901000" o "3926.90.1000"string
items[index].itemURLEste campo se utiliza para pasar la URL de la página del producto. string / URL
items[index].lengthEste campo se utiliza para pasar la longitud del artículo y se recomienda encarecidamente para cotizaciones de envío precisas. Las unidades de longitud son

OBLIGATORIO

en pulgadas. string - positive floating point, two decimal places / integer (inches)
items[index].nonShippableEste campo se utiliza para indicar si el artículo debe incluirse en los cálculos de envío, aranceles e impuestos. Las descargas digitales, códigos de descuento, cargos de manipulación, etc. deben pasarse con un valor de "true". boolean: true or false
items[index].productIdEste campo se utiliza para pasar la cantidad de la línea de artículo. string
items[index].quantity

OBLIGATORIO

Este campo se utiliza para pasar la cantidad de la línea de artículo. string
items[index].skuEste campo se utiliza para pasar el SKU / UPC / etc. del artículo. string
items[index].unitPrice

OBLIGATORIO

Este campo se utiliza para pasar el precio unitario de la línea de artículo. positive floating point, two decimal places / integer
items[index].weightEste campo se utiliza para pasar el peso del artículo y se recomienda encarecidamente para cotizaciones de envío precisas. Las unidades de peso se establecen por defecto en "LBS" a menos que se pase otra unidad de peso en items[index].itemWeightUnits``string - positive floating point, two decimal places / integer
items[index].weightUnitsEste campo se utiliza para anular las unidades de peso predeterminadas del artículo. Las unidades de peso del artículo se establecen por defecto en "LBS" a menos que se pase otra unidad de peso en este campo. string - "LB", "OZ", "KG", or "G”
items[index].widthEste campo se utiliza para pasar el ancho del artículo y se recomienda encarecidamente para cotizaciones de envío precisas. Las unidades de ancho son

OBLIGATORIO

en pulgadas. string - positive floating point, two decimal places / integer (inches)
misc1 - misc6Este campo se utiliza para pasar datos misceláneos asociados al pedido a través de la API de Zonos para recuperarlos junto con los datos del pedido devueltos por el endpoint de servicio API "orderDetail" de Zonos. string
referenceIdEste campo se utiliza para pasar un valor de identificación de referencia único para el carrito/sesión/etc. en su sistema. Puede utilizarse para buscar el ID de pedido de Zonos a través del endpoint de servicio API "orderDetail" de Zonos. string
storeId

OBLIGATORIO

ID de tienda proporcionado por Zonos. integer

Tipos de datos de cadena adicionales

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

Descuentos, cupones y códigos promocionales 

Para enviar descuentos, cupones y códigos promocionales a Zonos mediante el envío desde el servidor, deben pasarse como un artículo independiente con un valor negativo en los parámetros: "unitPrice" y "nonShippable":true.

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

Respuesta HTTPS

Respuesta HTTP de éxito

Formato del mensaje: JSON

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

Definiciones JSON de la respuesta

field↕notes↕
tempCartUUIDEste parámetro contendrá un GUID asignado al carrito internacional de su cliente y creado en el sistema de Zonos. Este campo se pasará como parámetro de consulta de URL string al redirigir el navegador del usuario a Zonos Checkout.

Respuestas HTTP de error

Error code↕meaning↕
400Carácter inesperado en el cuerpo de la solicitud.
406No aceptable. La cabecera HTTP "Accept" no es válida.
415Tipo de medio no compatible. La cabecera HTTP "Content-Type" no es válida.
422Entidad no procesable.
500"storeId" era incorrecto o no se pudo analizar el cuerpo JSON.
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

    Redirigir a Zonos Checkout 

    Después de recibir una respuesta correcta que contenga el tempCartUUID, su servidor enviará una redirección desde el navegador del cliente a Zonos Checkout con los parámetros de cadena de consulta de URL apropiados que se describen a continuación.

    URL de redirección de ejemplo: https://[yourassignedsubdomain].iglobalstores.com/?tempCartUUID=826b8f22-0de6-4717-90c7-366def7d0782&country=CA

    Nota: [yourassignedsubdomain] - Póngase en contacto con el miembro de su equipo de implementación de Zonos para recibir su subdominio de Zonos.com.

    Parámetros de solicitud de URL

    field↕notes↕
    tempCartUUID

    OBLIGATORIO

    		Este valor se obtiene llamando al endpoint de servicio API createTempCart de Zonos. string / GUID
    countryCódigo ISO de dos letras del país de destino. Recomendamos encarecidamente pasar este parámetro para la experiencia del usuario. El parámetro country preseleccionará el país de destino dentro de Zonos Checkout. Cuando utilice Zonos Hello JS (JavaScript) en el sitio, puede obtener este valor llamando al método JavaScript: zonos.country(). string (Length: 2)

    Tipos de datos de cadena adicionales

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

    ¿Fue útil esta página?

    Obtener soporte·Documentos legales·© 2026 Zonos
    En esta página:
  • Crear un checkout
  • Atributos
  • Descuentos, cupones y códigos promocionales
  • Redirigir a Zonos Checkout