---
updatedAt: 2026-01-22T11:09:33.000Z
---

# Submission

Reports that the user submitted an application.

> 👍 Required for financial institution sections.

### Parameters

* **name:** Human-readable name, not used to identify an event type
* **properties:** A container for the event properties as specified in the following table:

[block:parameters]
{
  "data": {
    "h-0": "Property",
    "h-1": "Description",
    "h-2": "Type",
    "0-0": "**dyType**",
    "0-1": "Must be \"purchase-v1\".",
    "0-2": "String",
    "1-0": "**value**",
    "1-1": "The total monetary value of the event (the total cart purchased, not just the item that triggered the event); in the actual payment currency.",
    "1-2": "Float (dollars.cents).  \n<br><span style=\"color:gray; font-size:0.8em;\">Numbers are rounded to the nearest 0.01. Numbers smaller than 0.005 are rounded down to 0.</span>",
    "2-0": "**currency  \n**<br><span style=\"color:gray; font-size:0.8em;\">Optional, but required for multi-currency sites</span>",
    "2-1": "The currency used for the value",
    "2-2": "String<br><span style=\"font-size:0.8em;\">[List of supported currencies](https://support.dynamicyield.com/hc/en-us/articles/360022558254#h_01F248KMJV1VWADRC2H7WYFWCZ)</span>",
    "3-0": "**uniqueTransactionId**<br><span style=\"color:gray; font-size:0.8em;\">Optional, but recommended</span>",
    "3-1": "When this value is passed, it ensures that only one purchase is recorded for the transaction ID, even if duplicate events are reported.",
    "3-2": "String<br><span style=\"color:gray; font-size:0.8em;\">Maximum of 64 characters</span>",
    "4-0": "**cart**",
    "4-1": "The cart's absolute current state. Products are ordered from the first added to the cart to the most recent.",
    "4-2": "Object  \n  \nSee the cart property table that follows for details."
  },
  "cols": 3,
  "rows": 5,
  "align": [
    "left",
    "left",
    "left"
  ]
}
[/block]

**Cart object properties:**

| Property      | Description                                   | Type                               |
| :------------ | :-------------------------------------------- | :--------------------------------- |
| **productId** | SKU exactly as it appears in the product feed | String                             |
| **quantity**  | Number of items                               | Number                             |
| **itemPrice** | The price of the item added                   | Float in the format: dollars.cents |

**Example: Implementation via script**

```javascript
DY.API("event", {
  name: "Submission", // Human-readable name, not used to identify an event type
  properties: {
    uniqueTransactionId: "123456", // Will remove redundant events. Must be a string. Max 64 characters.
    dyType: "purchase-v1", // Identifies this event as a purchase
    value: 90.55, // Total cart value in actual payment currency, as float (dollars dot cents)
    currency: "any supported currency code", // Optional non-default currency used
    cart: [
      // itemPrice is per quantity of one, and in the same format as the total "value":
      // float of dollars.cents in the payment currency (which is only defined once above)
      {
        productId: "item-34454", // SKU exactly as in the product feed!
        quantity: 1,
        itemPrice: 65.87,
      }, 
      {
        productId: "sku-4324-bg",
        quantity: 2,
        itemPrice: 12.34,
      }
    ]
  }
});
```

**Example: Implementation via Experience API (server-side)**

```json
"events":[{
  name: "Submission",
  properties: {
    dyType: "purchase-v1",
    value: 349.80,
    uniqueTransactionId: "exampleTransactionId",
    cart: [
      {
        productId: "p-tv78615a",
        quantity: 1,
        itemPrice: 249.90,
      }
     ]
  }
} ]
```

> 👍 Go to the [API reference for the Events endpoint](https://dy.dev/dy-dev/reference/track-events) to learn more.