> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Purchase

## Article: Purchase

## Article Link: https://dev.wix.com/docs/sdk/host-modules/site/events/wix-stores/purchase.md

## Article Content:

# Purchase

Triggered when the Thank You page loads.

### Properties

|Name|Type|Description|  
|---|---|---|  
|`origin`|text|Wix App name, such as Stores or Bookings.|
|`id`|text|Product ID.|
|`orderId`|text|Order ID.|
|`revenue`|text|Total purchase amount.|
|`currency`|currency|Purchase currency in ISO-4217 format.|
|`contents`|array|All purchased products.|
|`contents.id`|text|Product ID.|
|`contents.name`|text|Product name.|
|`contents.category`|text|Collection name.|
|`contents.price`|currency|Product price.|
|`contents.currency`|currency|Default site currency in ISO-4217 format.|
|`contents.quantity`|number|Quantity of product ordered.|
|`userId`|text|User ID.|  
<!-- |`isPremium`|boolean|Whether the Wix site is Premium.|  
|`metaSiteId`|text|Wix site ID.| -->

### Example
```JSON
{
  "id": "df19c1f7-07d8-a265-42f8-e8dfa824cc6e",
  "orderId": "d86d077c-c5d2-42c6-8b15-f5e26f276807",
  "origin": "Stores",
  "revenue": 93.6,
  "currency": "ILS",
  "contents": [{"..."}, {"..."}],
  "userId": "8aebf50f-b470-40b2-8376-58679347613b"
}
```

## Custom Events

### Shipping Details

Triggered when the user adds shipping details and clicks to advance to the next step in the checkout flow.

#### Properties

|Name|Type|Description|  
|---|---|---|  
|`eventCategory`|text|Wix category.|
|`eventAction`|text|Fixed 'Add Shipping Details' string.|
|`eventLabel`|text|Wix App name, such as Stores or Bookings.|
|`contents`|array|All purchased products.|
|`contents.id`|text|Product ID.|
|`contents.name`|text|Product name.|
|`userId`|text|User ID.|  
<!-- |`isPremium`|Boolean|Whether the Wix site is Premium.|  
|`metaSiteId`|text|Wix site ID.| -->

#### Example

```JSON
{
  "eventCategory": "Enhanced Ecommerce",
  "eventAction": "Add Shipping Details",
  "eventLabel": "Stores",
  "contents": [{
    "id": "T123", 
    "name": "Running shoes",
    "..."
  }],
  "userId": "79f246a8-46fd-4429-aac6-006d13cce9a6"
}
```

### Delivery Method

Triggered when the user adds personal information and clicks to advance to the next step in the checkout flow.

#### Properties

|Name|Type|Description|  
|---|---|---|  
|`eventCategory`|text|Wix category.|
|`eventAction`|text|Fixed 'Add Shipping Details' string.|
|`eventLabel`|text|Wix App name, such as Stores or Bookings.|
|`contents`|array|All purchased products.|
|`contents.Id`|text|Product ID.|
|`contents.name`|text|Product name.|
|`userId`|text|User ID.|  
<!-- |`isPremium`|Boolean|Whether the Wix site is Premium.|  
|`metaSiteId`|text|Wix site ID.| -->

#### Example
```JSON
trackEvent("CustomEvent", 
  {
    "eventCategory": "Enhanced Ecommerce - Stores",
    "eventAction": "Add Delivery Method",
    "eventLabel": "stores",
    "contents": [{
      "id": "T123", 
      "name": "Running shoes",
      "..."
    }]
  }
```

### Agree to Terms

Triggered when the user checks the Agree to terms & conditions checkbox.

#### Properties

|Name|Type|Description|  
|---|---|---|  
|`eventCategory`|text|Wix category.|
|`eventAction`|text|Fixed 'Add Shipping Details' string.|
|`eventLabel`|text|Wix App name, such as Stores or Bookings.|
|`contents`|array|All purchased products.|
|`contents.Id`|text|Product ID.|
|`contents.name`|text|Product name.|
|`userId`|text|User ID.|  
<!-- |`isPremium`|Boolean|Whether the Wix site is Premium.|  
|`metaSiteId`|text|Wix site ID.| -->

#### Example
```JSON
{
  "eventCategory": "Enhanced Ecommerce",
  "eventAction": "Agree To Terms",
  "eventLabel": "Stores",
  "contents":[{
    "id": "T123", 
    "name": "Running shoes",
    "..."
  }]
}
```

### Pickup Details

Triggered when the user enters pickup information and clicks to advance to the next step in the checkout flow.


#### Properties

|Name|Type|Description|  
|---|---|---|  
|`eventCategory`|text|Wix category.|
|`eventAction`|text|Fixed 'Add Shipping Details' string.|
|`eventLabel`|text|Wix App name, such as Stores or Bookings.|
|`contents`|array|All purchased products.|
|`contents.Id`|text|Product ID.|
|`contents.name`|text|Product name.|
|`userId`|text|User ID.|  
<!-- |`isPremium`|Boolean|Whether the Wix site is Premium.|  
|`metaSiteId`|text|Wix site ID.| -->

#### Example

```JSON
{
  "eventCategory": "Enhanced Ecommerce  - Stores",
  "eventAction": "Pickup Details",
  "eventLabel": "Stores",
  "contents": [{
    "id": "T123", 
    "name": "Running shoes",
    "..."
  }]
}
```