> ## Documentation Index
> Fetch the complete documentation index at: https://docs.subotiz.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Price

## Event List

| **Event Name** | **Event Type** | **Trigger Condition** | **Data Structure** |
| - | - | - | - |
| Price Created | v2.price.created | When a pricing plan is created | [Price](#event-object) |
| Price Updated | v2.price.updated | When a pricing plan's information or status is updated | [Price](#event-object) |
| Price Deleted | v2.price.deleted | When a pricing plan is deleted | [Price](#event-object) |

> [!NOTE]
>
> The notification only contains the pricing plan's identifiers and status. To get pricing details, call the [Get Price](https://docs.subotiz.com/en/api/v1-price-get-price.md) API with `price_id`.

## Event Object

| **Attribute** | **Type** | **Description** | **Example** |
| - | - | - | - |
| merchant\_id | string | Merchant ID | 100010 |
| price\_id | string | Subotiz pricing plan ID | 583564652533787501 |
| merchant\_price\_id | string | Merchant-side pricing plan ID | price\_basic\_monthly |
| price\_version\_id | string | Pricing plan version ID | 583564652533787502 |
| product\_id | string | ID of the product the pricing plan belongs to | 583564652533787306 |
| status | string | Pricing plan status: `draft` - Draft `active` - Active `frozen` - Frozen | active |
| source | string | Source of the operation | openapi |
| operated\_at | string | Operation time (RFC3339) | 2026-11-19T08:00:00Z |

> [!TIP]
>
> Webhooks may arrive out of order, for example due to retries. Use `operated_at` to determine the order of events so that an older event does not overwrite a newer state.

## Example

```json v2.price.created theme={null}
{
  "id": "583564652533787601",
  "type": "v2.price.created",
  "created": "2026-11-19T08:00:00Z",
  "data": {
    "merchant_id": "100010",
    "price_id": "583564652533787501",
    "merchant_price_id": "price_basic_monthly",
    "price_version_id": "583564652533787502",
    "product_id": "583564652533787306",
    "status": "draft",
    "source": "openapi",
    "operated_at": "2026-11-19T08:00:00Z"
  }
}
```

```json v2.price.updated theme={null}
{
  "id": "583564652533787602",
  "type": "v2.price.updated",
  "created": "2026-11-19T09:00:00Z",
  "data": {
    "merchant_id": "100010",
    "price_id": "583564652533787501",
    "merchant_price_id": "price_basic_monthly",
    "price_version_id": "583564652533787503",
    "product_id": "583564652533787306",
    "status": "active",
    "source": "openapi",
    "operated_at": "2026-11-19T09:00:00Z"
  }
}
```

```json v2.price.deleted theme={null}
{
  "id": "583564652533787603",
  "type": "v2.price.deleted",
  "created": "2026-11-19T10:00:00Z",
  "data": {
    "merchant_id": "100010",
    "price_id": "583564652533787501",
    "merchant_price_id": "price_basic_monthly",
    "price_version_id": "583564652533787503",
    "product_id": "583564652533787306",
    "status": "frozen",
    "source": "openapi",
    "operated_at": "2026-11-19T10:00:00Z"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.