> For the complete documentation index, see [llms.txt](https://docs.chord.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chord.co/collect-data/tracking-plan/order-refunded.md).

# Order Refunded

User refunded the order.

**Suggested source:** server

**Properties**

| Name                          | Type       | Description                                                                                           | Required |
| ----------------------------- | ---------- | ----------------------------------------------------------------------------------------------------- | -------- |
| **affiliation**               | `string`   | <p>Store or affiliation from which this transaction occurred (for example, "Google Store")<br></p>    | no       |
| **campaign\_id**              | `integer`  | <p>Order metadata "campaign\_id"<br></p>                                                              | no       |
| **channel**                   | `string`   | <p>Channel where order was placed (for example, "chord")<br></p>                                      | no       |
| **checkout\_type**            | `string`   | <p>Checkout provider (for example, "stripe")<br></p>                                                  | no       |
| **coupon**                    | `string`   | <p>Transaction coupon redeemed with the transaction<br></p>                                           | no       |
| **currency**                  | `string`   | <p>Currency code of the transaction (for example, "USD")<br>Pattern: <code>^\[A-Z]{3}$</code><br></p> | no       |
| **discount**                  | `number`   | <p>Total discount associated with the transaction<br></p>                                             | no       |
| **email**                     | `string`   | <p>Email address associated with the order<br></p>                                                    | no       |
| **first\_name**               | `string`   | <p>First name in the shipping address for the order<br></p>                                           | no       |
| **has\_subscription**         | `boolean`  | <p>Order contains a subscription<br></p>                                                              | no       |
| **is\_recurring**             | `boolean`  | <p>Order contains a subscription<br></p>                                                              | no       |
| **last\_name**                | `string`   | <p>Last name in the shipping address for the order<br></p>                                            | no       |
| **metadata**                  | `object`   | <p>Metadata of the order<br></p>                                                                      | no       |
| **order\_date**               | `string`   | <p>Date and time order was placed<br></p>                                                             | no       |
| **order\_id**                 | `string`   | <p>Order/transaction ID<br></p>                                                                       | yes      |
| **phone**                     | `string`   | <p>Phone number associated with the order<br></p>                                                     | no       |
| **products**                  | `object[]` | <p>Products in the order<br></p>                                                                      | yes      |
| **purl\_link**                | `string`   | <p>URL for customer to share to receive referral credit<br></p>                                       | no       |
| **referral\_identifier\_id**  | `string`   | <p>ID for referral that customer used to place the order<br></p>                                      | no       |
| **revenue**                   | `number`   | <p>Revenue ($) associated with the transaction (excluding shipping and tax)<br></p>                   | no       |
| **shipping**                  | `number`   | <p>Shipping cost associated with the transaction<br></p>                                              | no       |
| **shipping\_city**            | `string`   | <p>City in the shipping address for the order<br></p>                                                 | no       |
| **shipping\_country**         | `string`   | <p>Country in the shipping address for the order<br></p>                                              | no       |
| **shipping\_method\_details** | `object`   |                                                                                                       | no       |
| **shipping\_state**           | `string`   | <p>State in the shipping address for the order<br></p>                                                | no       |
| **shipping\_zipcode**         | `string`   | <p>Zipcode in the shipping address for the order<br></p>                                              | no       |
| **tax**                       | `number`   | <p>Total tax associated with the transaction<br></p>                                                  | no       |
| **template\_id**              | `integer`  | <p>Order metadata "template\_id"<br></p>                                                              | no       |
| **total**                     | `number`   | <p>Revenue ($) with discounts and coupons added in.<br></p>                                           | yes      |
| **tracking\_ids**             | `object`   | <p>Tracking IDs for third party integrations<br></p>                                                  | no       |

**Example**

```json
{
    "affiliation": "My Plant Store",
    "campaign_id": 12345,
    "channel": "online",
    "checkout_type": "Shopify",
    "coupon": "SPRING",
    "currency": "USD",
    "discount": 10,
    "email": "customer@example.com",
    "first_name": "John",
    "has_subscription": false,
    "is_recurring": false,
    "last_name": "Doe",
    "metadata": {},
    "order_date": "2024-03-25T09:20:00Z",
    "order_id": "345678912",
    "phone": "123-456-7890",
    "products": [
        {
            "affiliation": "My Plant Store",
            "brand": "Green Thumb Nurseries",
            "bundle": false,
            "bundle_size": 0,
            "category": "Outdoor Plants",
            "coupon": "SPRING",
            "cross_sold_quantity": 0,
            "description": "A vibrant, easy-to-care-for garden plant perfect for adding a splash of color to any outdoor space.",
            "image_url": "https://example.com/images/petunia.jpg",
            "line_item_id": "234567891",
            "name": "Petunia",
            "option_values": [
                "Purple",
                "Red",
                "White"
            ],
            "position": 3,
            "price": 7.99,
            "product_id": "123456789",
            "quantity": 2,
            "sku": "PETUNIA-001",
            "slug": "petunia",
            "url": "https://example.com/plants/petunia",
            "variant": "Purple",
            "variant_metadata": {
                "size": "Small"
            }
        }
    ],
    "purl_link": "https://example.com/referral",
    "referral_identifier_id": "ref123",
    "revenue": 5.98,
    "shipping": 10,
    "shipping_city": "Springfield",
    "shipping_country": "US",
    "shipping_method_details": {
        "shipping_code": "standard_shipping",
        "shipping_method": "Standard Shipping"
    },
    "shipping_state": "IL",
    "shipping_zipcode": "62704",
    "tax": 5,
    "template_id": 67890,
    "total": 30.98,
    "tracking_ids": {}
}
```

## metadata object

Metadata of the order

**No properties.**

## products\[] array

Products in the order

The product

**Item Properties**

| Name                      | Type       | Description                                                                                                                      | Required |
| ------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------- | -------- |
| **affiliation**           | `string`   | <p>Product affiliation to designate a supplying company or brick and mortar store location (for example, "Google Store")<br></p> | no       |
| **brand**                 | `string`   | <p>Brand associated with the product<br></p>                                                                                     | no       |
| **bundle**                | `boolean`  | <p>Product belongs to a bundle<br></p>                                                                                           | no       |
| **category**              | `string`   | <p>Product category<br></p>                                                                                                      | no       |
| **coupon**                | `string`   | <p>Coupon code associated with a product (for example, "MAY\_DEALS\_3")<br></p>                                                  | no       |
| **description**           | `string`   | <p>Short description of the product<br></p>                                                                                      | no       |
| **image\_url**            | `string`   | <p>Image URL of the product<br></p>                                                                                              | no       |
| **name**                  | `string`   | <p>Name of the product<br></p>                                                                                                   | yes      |
| **option\_values**        | `string[]` | <p>Option values of the product variant<br></p>                                                                                  | no       |
| **position**              | `integer`  | <p>Position in the product list (for example, 3)<br></p>                                                                         | no       |
| **price**                 | `number`   | <p>Price ($) of the product<br></p>                                                                                              | yes      |
| **product\_id**           | `string`   | <p>Database ID of the product<br></p>                                                                                            | yes      |
| **quantity**              | `integer`  | <p>Quantity of the product<br></p>                                                                                               | yes      |
| **sku**                   | `string`   | <p>SKU of the product variant<br></p>                                                                                            | yes      |
| **slug**                  | `string`   | <p>Slug of the product, often used in URLs (for example, "product-red")<br></p>                                                  | no       |
| **url**                   | `string`   | <p>URL of the product page<br></p>                                                                                               | no       |
| **variant**               | `string`   | <p>Name of the product variant<br></p>                                                                                           | no       |
| **line\_item\_id**        | `string`   | <p>Database ID of the line item<br></p>                                                                                          | no       |
| **bundle\_size**          | `integer`  | <p>Number of SKUs in the bundle<br></p>                                                                                          | no       |
| **cross\_sold\_quantity** | `integer`  | <p>Quantity sold via cross-selling<br></p>                                                                                       | no       |
| **variant\_metadata**     | `object`   | <p>Metadata of the product variant<br></p>                                                                                       | no       |

**Example**

```json
[
    {
        "affiliation": "My Plant Store",
        "brand": "Green Thumb Nurseries",
        "bundle": false,
        "category": "Outdoor Plants",
        "description": "A vibrant, easy-to-care-for garden plant perfect for adding a splash of color to any outdoor space.",
        "image_url": "https://example.com/images/petunia.jpg",
        "name": "Petunia",
        "option_values": [
            "Purple",
            "Red",
            "White"
        ],
        "position": 3,
        "price": 7.99,
        "product_id": "123456789",
        "sku": "PETUNIA-001",
        "slug": "petunia",
        "url": "https://example.com/plants/petunia",
        "variant": "Purple",
        "coupon": "SPRING",
        "line_item_id": "234567891",
        "quantity": 2
    }
]
```

### products\[].option\_values\[] array

Option values of the product variant

Option value (for example, "red")

**Item Type:** `string`\
**Example**

```json
[
    "Purple"
]
```

### products\[].variant\_metadata object

Metadata of the product variant

**No properties.**

## shipping\_method\_details object

**Properties**

| Name                 | Type     | Description                                                                                 | Required |
| -------------------- | -------- | ------------------------------------------------------------------------------------------- | -------- |
| **shipping\_code**   | `string` | <p>Code of shipping method chosen for the order (for example, "standard\_shipping")<br></p> |          |
| **shipping\_method** | `string` | <p>Name of shipping method chosen for the order (for example, "Standard Shipping")<br></p>  |          |

## tracking\_ids object

Tracking IDs for third party integrations

**No properties.**


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.chord.co/collect-data/tracking-plan/order-refunded.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
