started checkout

Initiating a checkout process, similar to the added product to cart event, allows for the identification and targeting of customers who have begun the checkout process but have not completed their purchase.

Unlocked Features

Checkout abandonment workflow: Optimizes re-engagement strategies for customers who have abandoned their shopping carts without finalizing their purchases. See the Checkout abandonment guide for more information.
Contact segmentation: Enables targeted communication by categorizing contacts based on specific criteria.

Supported Endpoints

Endpoint	eventVersion	origin
`/v5/events` (Events API)	"" (empty)	api
`track` (JavaScript API)	"" (empty)	api

We recommend to send this event via JavaScript API

Note: The started checkout event will be captured only for identified contacts. Contact is identified if:

Customer clicked on a campaign email and landed on your website

Customer submitted Omnisend Form

Using the omnisend.identifyContact function

Example event

Below is an example event provided for testing. You can send this through the available endpoints to evaluate automation, segmentation, or any other custom functionalities.

JavaScript API:


omnisend.push([
  "track",
  "started checkout",
  {
  "origin": "api",
  "eventID": "f3f61bc6-07b8-4645-92d8-189d882dbcb1",
  "eventVersion": "",
  "eventTime": "2021-07-01T00:00:00Z",
  "properties": {
    "abandonedCheckoutURL": "https://example.com/checkout",
    "cartID": "a342-dsfv12",
    "currency": "EUR",
    "lineItems": [
      {
        "productCategories": [
          {
            "id": "123",
            "title": "Shoes"
          }
        ],
        "productDescription": "The best product with many various features",
        "productDiscount": 10.19,
        "productID": "1",
        "productImageURL": "https://example.com/product/232423-image.jpg",
        "productPrice": 19.99,
        "productQuantity": 2,
        "productSKU": 200,
        "productStrikeThroughPrice": 29.99,
        "productTitle": "The best product",
        "productURL": "https://example.com/product/232423",
        "productVariantID": "123",
        "productVariantImageURL": "https://example.com/product/232423-variant-image.jpg"
      }
    ],
    "value": 19.99
  },
  "contact": {
    "id": "67447b7d5c1cd54488ec24d9",
    "email": "[email protected]",
    "phone": "+443031237300",
    "firstName": "Vanessa",
    "lastName": "Kensington",
    "birthdate": "1997-05-28",
    "gender": "f",
    "address": "9709 Highland Rd.",
    "city": "New York",
    "state": "NY",
    "postalCode": "08723",
    "country": "United States",
    "customProperties": {
      "favoriteColors": [
        "red",
        "blue"
      ],
      "vipStatus": true,
      "vipStatusDate": "2023-06-27T10:48:36Z",
      "vipPoints": 100.59,
      "friendlyTitle": "Miss Vanessa"
    },
    "tags": [
      "vip",
      "form:a12546asdwq"
    ],
    "optIns": [
      {
        "channel": "email",
        "createdAt": "2023-06-27T10:48:36Z",
        "source": "form:omnisend-form:5d5cf027865hed74f4078q44:26"
      }
    ],
    "optOuts": [
      {
        "channel": "sms",
        "createdAt": "2023-06-27T10:48:36Z",
        "reason": "unsubscribed via email",
        "source": "email link"
      }
    ],
    "consents": [
      {
        "channel": "email",
        "createdAt": "2023-06-27T10:48:36Z",
        "ip": "73.240.147.113",
        "source": "form:omnisend-form:5d5cf027865hed74f4078q44:26",
        "userAgent": "Mozilla/5.0"
      }
    ]
  }
}
]);

eventName. Either "started checkout"
eventID. This is a unique identifier for the event (UUID v4). If you don't have a unique identifier, you can leave it empty.
origin. Use api
eventVersion. Currently, use "" (empty)
properties.
eventTime. Optional. If not provided current date is used
contact. Optional. The contact object allows you to send additional details about the contact identified using the omnisend.identifyContact JavaScript function. NOTE: When using contact, ensure you provide at least one of the following values: id, email and/or phone. All other contact information is OPTIONAL.

Events API:


POST /v5/events
Host: api.omnisend.com
Content-Type: application/json

{
  "eventName": "started checkout",
  "origin": "api",
  "eventID": "f3f61bc6-07b8-4645-92d8-189d882dbcb1",
  "eventVersion": "",
  "eventTime": "2021-07-01T00:00:00Z",
  "contact": {
    "email": "[email protected]"
  },
  "properties": {
    "abandonedCheckoutURL": "https://example.com/checkout",
    "cartID": "a342-dsfv12",
    "currency": "EUR",
    "lineItems": [
      {
        "productCategories": [
          {
            "id": "123",
            "title": "Shoes"
          }
        ],
        "productDescription": "The best product with many various features",
        "productDiscount": 10.19,
        "productID": "1",
        "productImageURL": "https://example.com/product/232423-image.jpg",
        "productPrice": 19.99,
        "productQuantity": 2,
        "productSKU": 200,
        "productStrikeThroughPrice": 29.99,
        "productTitle": "The best product",
        "productURL": "https://example.com/product/232423",
        "productVariantID": "123",
        "productVariantImageURL": "https://example.com/product/232423-variant-image.jpg"
      }
    ],
    "value": 19.99
  }
}

Property explanation & expected types

Value Path	Description	Example	Type
abandonedCheckoutURL	Store URL for abandoned checkout. When opened by the user it should show the same checkout that user left.	https://example.com/checkout	string
cartID	Store Cart ID	a342-dsfv12	string
currency	Currency code in ISO 4217 format	EUR	string
lineItems[]	All current items in cart. Should contain all cart items.	-	array of objects
lineItems[].productCategories	Product Categories	-	array of objects
lineItems[].productCategories.id	Id	123	string
lineItems[].productCategories.title	Title	Shoes	string
lineItems[].productDescription	Product Description	The best product with many various features	string
lineItems[].productDiscount	Absolute value of product discount. I.e if current price is 20 and old price is 30, then discount should be 10.	10.19	number
lineItems[].productID	Product ID	1	string
lineItems[].productImageURL	Direct link to product image	https://example.com/product/232423-image.jpg	string
lineItems[].productPrice	Current product price	19.99	number
lineItems[].productQuantity	Total added quantity	2	number
lineItems[].productSKU	Current stock units	200	string
lineItems[].productStrikeThroughPrice	Previous product price. This should be filled if product is discounted	29.99	number
lineItems[].productTitle	Full product title	The best product	string
lineItems[].productURL	URL to product page	https://example.com/product/232423	string
lineItems[].productVariantID	Product variant ID	123	string
lineItems[].productVariantImageURL	Direct link to a product variant image	https://example.com/product/232423-variant-image.jpg	string
value	Total sum of all cart items	19.99	number