Adding multiple products to the basket using a URL

Products are specified using the item parameter.

• SKU is the product SKU code
• quantity is the number of items to add

Example:

Multiple products can be added by separating parameters using &

Example:

item[TSHIRT-RED]=2&item[CAP-BLACK]=1

Extras can be applied to a specific SKU using the extras parameter.

• SKU must match the SKU used in the item parameter
• extra-ID is the unique ID of the product extra

Example:

extras[TSHIRT-RED]=10103

Multiple extras can be specified using commas

Example:

extras[TSHIRT-RED]=10103,10903

Choices can be applied to a specific SKU using the choices parameter.

• SKU must match the SKU used in the item parameter
• choice-ID is the unique ID of the product choice

Example:

choices[CAP-BLACK]=2045

Multiple choices can be specified using commas.

Example:

choices[CAP-BLACK]=2045,2046

A single voucher code can be applied using the voucher_code parameter

• The voucher code must be active
• CODE is the voucher code, e.g. FREE10

Example:

voucher_code=FREE10

Only a single voucher code can be specificed.

The following example adds two products to the basket and applies extras and choices

https://www.yourdomainname.com/checkout/basket?add_items=1&item[TSHIRT-RED]=2&extras[TSHIRT-RED]=10103&item[CAP-BLACK]=1&extras[CAP-BLACK]=10903,10904&choices[CAP-BLACK]=2045&voucher_code=FREE10

This would:

• add TSHIRT-RED with quantity 2 and extra 10103
• add CAP-BLACK with quantity 1
• apply extras 10903 and 10904
• apply choice 2045
• apply voucher code FREE10

When customers purchase products from your shop on Facebook or Instagram, the checkout process takes place on your website. Meta sends the selected products and quantities to your website using a special checkout URL.

ShopWired already supports this functionality automatically, so you do not need to build your own checkout endpoint.

When a customer selects products in your Facebook or Instagram shop and proceeds to checkout, Meta sends the selected items to your ShopWired checkout using URL parameters.

These parameters include:

• Product IDs
• Quantities
• Optional coupon codes
• Tracking parameters such as UTM tags and fbclid

ShopWired automatically reads these parameters, converts them to the necessary parameters for ShopWired, adds the products to the customer’s cart, and loads the checkout page with the correct items and quantities.

A typical Meta checkout request may look like this:

https://www.example.com/checkout/basket?products=12345%3A3%2C23456%3A1&coupon=SUMMERSALE20

Decoded, this represents:

• Product 12345 with quantity 3
• Product 23456 with quantity 1
• Coupon code SUMMERSALE20

ShopWired automatically converts this information into a cart and displays the checkout page.

Meta may also include tracking parameters such as:

• fbclid
• cart_origin
• utm_source
• utm_medium
• utm_campaign
• utm_content

These parameters are used for analytics and marketing attribution. ShopWired accepts and passes these parameters through the checkout process automatically.

To ensure a smooth checkout experience from Facebook or Instagram:

• The ShopWired checkout page must be accessible to visitors
• Guest checkout should be enabled
• Products in your Meta catalog must match the product IDs used on your ShopWired store
• Your checkout must correctly display products, quantities and final prices

Meta periodically reviews checkout URLs to confirm they work correctly.

In Step 3 of the process to configure your Facebook checkout URL in the setting Enter checkout URL in Facebook enter the URL in the format:

https://www.yourdomain.com/checkout/basket

• Replace yourdomain.com with your actual domain name
• Do not enter any additional parameters or characters after /basket

• a maximum of approximately 50 products per request is recommended
• SKU codes must be used (product IDs are not supported)
• the same SKU can only appear once in a request
• customisation fields and comments are not supported
• choice and extra IDs may change if products are edited or imported