Skip to main content
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 via the refunds/create webhook (server-side).

​
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

PropertyTypeRequiredDescription
orderIdstringYesOriginal order identifier
valuenumberYesRefund amount
currencystringNoISO 4217 currency code
itemsarrayNoProducts refunded (for partial refunds)

​
When to Fire

  • Refund processed via Shopify admin
  • refunds/create webhook (server-side)
  • Customer service refund action