How to add a Limio Offer to Basket via a URL (purchase links)

It is possible to add a Limio Offer via a direct URL to Basket or Checkout, sometimes referred as purchase links or deep links. This allows for pages outside of Limio Landing Pages such as external pages, Paywalls and Abandoned Basket journeys to interact with the composition of the Basket.

The URL

To add a Limio Offer to the basket you will first need to find the desired Offer. You will then need to find its Path, this is found in Limio Catalog URL when you are on the Offer:

Alternatively it can be found in the JSON view on the Limio Offer Object, by selecting the Switch View option:

The Path can be found under the "path" key:

To add then add this Offer to the basket you will need to add this path as "purchase" query parameter when navigating to the Checkout or Basket page of your Limio Shop. For example:

Offers v1 (legacy)	Offers v2
https://sandbox-dev.shop.limio.com/basket?purchase=/offers/Limio%20Subscription%20-%20UK/Bundle%20Annual	https://sandbox-shop.prod.limio.com/checkout?purchase=/offers2/Digital%20%C2%A33%20for%203%20months

This URL will navigate to page stored at https://sandbox-dev.shop.limio.com/basket and add Offer located at "/offers/Limio Subscription - UK/Bundle Annual" to the Basket once there.

Using Labels

If you are using Limio Offers v2, you are able to add a Limio Offer to the basket via an Offer Label. You will need the Offer Label ID. Once again, the Label ID it can be found in the JSON view on the Limio Offer Object, by selecting the Switch View option, it can be found under "label__limio" key:

You can then use the URL as follows:
https://sandbox-dev.shop.limio.com/basket?purchase=true&label=physical