Track Shopify Refunds in Google Analytics

When a refund gets created in your Shopify admin, this trigger captures all the refund details including the original order ID, refunded line items, quantities, and transaction amounts. The trigger runs automatically in the background - no configuration needed from you. All refund data gets passed to the next step so the workflow can retrieve the complete order information needed for Google Analytics tracking.

This step automatically fetches the full order record using the order ID from the refund trigger. It retrieves essential details like customer information, original line items, product IDs, pricing, and currency that Google Analytics requires for proper refund tracking. The retrieved order data gets combined with the refund information and passed to the calculation step. No configuration is needed since it uses the order ID from the previous trigger.

This custom JavaScript step loops through all refund transactions and calculates the total amount being refunded back to the customer. The script processes each transaction amount (which comes as negative values from Shopify) and converts them to the proper format for Google Analytics tracking. Here's the complete code that handles this calculation:

const Mesa = require('vendor/Mesa.js');

/**
 * A Mesa Script exports a class with a script() method.
 */
module.exports = new class {

  /**
   * Mesa Script
   *
   * @param {object} payload The payload data
   * @param {object} context Additional context about this task
   */
  script = (payload, context) => {
    const vars = context.steps;

    // Add your custom code here
    // Line items from a Shopify Order Created trigger would be available as something like `vars.shopify.line_items`
    // Loop through transactions on the refund, and total up the refund amount
    const refundPayload = context.steps['shopify'];
    let refundAmount = 0;
    refundPayload.transactions.forEach(transaction => {
      refundAmount -= transaction.amount;
    });
     
    // Add to payload
    payload.total_refund_amount = refundAmount;

    // We're done, call the next step!
    Mesa.output.next(payload);
  }
}

The calculated total gets stored and passed to Google Analytics for accurate refund event tracking.

You'll need to configure your Google Analytics connection by providing your Measurement ID (found in your GA4 property settings under "Data Streams"). The step automatically formats all the refund data including transaction ID, customer ID, currency, refund amount, and individual line item details into the proper GA4 refund event structure. Once connected, every refund will appear in your Google Analytics dashboard under Events > refund, allowing you to create custom reports and segments to analyze your return patterns. The workflow sends each refunded line item as a separate item in the refund event for detailed product-level tracking.