Add multiple products to basket using a URL

A new feature has been added that allows multiple products to be added to a visitor’s shopping basket using a single URL.

This feature works by sending a request to the /checkout/basket endpoint with query parameters that specify the SKUs and quantities of the products that should be added.

The feature was introduced primarily to support external platforms that require checkout URLs which add multiple products to a basket, such as Facebook's checkout link system.

For more information about Facebook checkout URLs, see:
https://developers.facebook.com/docs/commerce-platform/setup-checkout-url.

How the feature works

Multiple products can now be added to the basket by sending a request to /checkout/basket.

The request must include the add_items parameter and one or more item parameters specifying SKU codes and quantities.

e.g.

/checkout/basket?add_items=1&item[SKU1]=2&item[SKU2]=1

This request would:

add the product with SKU SKU1 with a quantity of 2
add the product with SKU SKU2 with a quantity of 1

Up to approximately 50 products can be added in a single request.

Supporting extras and choices

The URL also supports attaching product extras and product choices to specific SKUs.

Extras and choices are specified using their unique IDs and must reference the same SKU used in the item parameter.

Example:

/checkout/basket?add_items=1&item[SKU1]=2&extras[SKU1]=11&item[SKU2]=1&extras[SKU2]=22,33&choices[SKU2]=44

In this example:

SKU1 is added with quantity 2 and extra 11
SKU2 is added with quantity 1
extras 22 and 33 are applied to SKU2
choice 44 is applied to SKU2

Invalid values are ignored during processing.

Intended use

This feature is designed primarily for integrations where products need to be preloaded into a visitor’s basket from an external platform.

A common use case is when platforms such as Facebook redirect users to a store with predefined products ready to purchase.

What's new at ShopWired?