Area: Episerver Product Recommendations
Applies to versions: 1.4 and higher (Server-to-Server API)
Other versions:

Checkout page tracking request

Recommendations [hide]

The checkout page is similar to the basket page tracking request with additional properties including  subtotal, shipping, and total value of the basket. These values should match what the user sees. That is, if any discounts or surcharges are applied at the order level, include them in the relevant values in the tracking data provided.

Name Description Usage
checkout Element containing checkout-specific sub-elements.  
      items List of checkout items.  



Product reference code.

The refCode must exactly match the refCode (guid) specified in the product catalog feed. Also, if you have a custom feed, contact Episerver to find out which field from the feed is used as a product identifier.

    qty Quantity. [Number]
    price Unit price. [Number]
    variant The product variant’s SKU code. Alternatively, you can supply the product variant’s attributes colour and size. By arrangement with Episerver, these can be replaced with another product attribute.


Sub-elements are of the type [String].

Available from version 1.3 of the Server-to-Server API.

See the Variant tracking section.

  currency Currency code. See Currency codes.
  subtotal Subtotal amount. [Number]
  shipping Shipping cost. [Number]
  total Total amount of the checkout. [Number]

Checkout page tracking request example.

  "type"        : "checkout",
  "ip"          : "",
  "session"     : "123456789012|a1b2c3d4e5A6B7C8D9E0f1g2h3i4j5F1G2H3I4J5k1l",
  "cuid"        : "09876543210|Z0Y9X8W7V6z5y4x3w2v1U0T9S8R7Q6u5t4s3r2q1P0O",
  "site"        : "retailer",
  "clientToken" : "1234abcd5678",
  "channel"     : "web",
  "lang"        : "en-gb",
  "currentURI"  : "www.retailer.com/checkout.html",
  "previousURI" : "www.retailer.com/basket.html",
  "userAgent"   : "Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/56.0.2924.87 Safari/537.36",
  "checkout"    : {
                    "items"    : [
                                   { "refCode":  "RC123", "qty":  5,  "price":  50.5 },
                                   { "refCode":  "RC124", "qty":  8,  "price":  52.5 }
                    "currency" : "GBP",
                    "subtotal" : 103,  
                    "shipping" : 11.75,
                    "total"    : 114.75
Do you find this information helpful? Please log in to provide feedback.

Last updated: Nov 06, 2017

Recommendations [hide]