refund Event - Upstack Data

Fires when an order is refunded. This helps maintain accurate revenue reporting and adjusts conversion data for ad platforms that support refund events.

Shopify: Automatically tracked (server-side) when a refund is recorded in Shopify.

JavaScript

Full refund:

window._upstack('track', 'refund', {
  orderId: 'ORD_12345',
  value: 149.99,
  currency: 'USD'
});

Partial refund:

window._upstack('track', 'refund', {
  orderId: 'ORD_12345',
  value: 89.99,
  currency: 'USD',
  items: [
    { id: 'SKU_001', name: 'Blue Running Shoes', price: 89.99, quantity: 1 }
  ]
});

Properties

Property	Type	Required	Description
orderId	string	Yes	Original order identifier
value	number	Yes	Refund amount
currency	string	No	ISO 4217 currency code
items	array	No	Products refunded (for partial refunds)

When to Fire

Refund processed via Shopify admin
Customer service refund action

purchase — The original order event