---
title: "Configuring automatic shipping cost refunds"
slug: "configuring-automatic-shipping-cost-refunds"
tags: ["config api", "Easypost", "shipping", "delivery", "platform", "payment options", "refund", "routing", "api"]
updated: 2024-11-29T08:49:43Z
published: 2024-11-29T08:49:43Z
canonical: "docs.newstore.com/configuring-automatic-shipping-cost-refunds"
---

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

# Configuring automatic shipping cost refunds

When all items of an order are returned, the shipping cost for the order is automatically refunded to the customer. The refund is processed when the last item from the order is returned. Shipping options are not considered when calculating the shipping cost refunds for an order.

> [!TIP]
> Note
> 
> The shipping costs are refunded only when all items are returned. The refund is not processed if some items in the order are returned and the rest are canceled.

> [!NOTE]
> Important
> 
> When shipping costs are refunded, they are indicated in the NewStore platform as returned *line items* with the type specified as `shipping`. These *line items* cannot be mapped to the actual product items that were returned as part of the order.
> 
> A `shipping` *line item* with $0 cost is added to the `return.processed` [event-stream webhook](https://docs.newstore.net/api/webhooks/stream_webhook_sink_hook) for blind returns.
> 
> Before enabling automatic shipping cost refunds, ensure that your current integration can manage such refunds when enabled. Check your integration in a test environment after enabling the feature, before going live. For more information, see the [BPM documentation](/v1/docs/return-lifecycle-bpm#bpm-return-lifecycle) ` <>`.

If enabled, this feature applies globally for a retailer, and cannot be configured for a specific country or region.

You can configure templates in your business to display the shipping cost refunds in the return receipts and refund notes for the order. To verify if your template contains shipping cost refunds, see the [integration guide](/v1/docs/customizing-templates#templates) .

To enable refunds of shipping costs for the retailer:

1. Use the [Update item return config](https://docs.newstore.net/api/configuration/checkout/item_return_config#operation/updateConfig) or [Replace item return config](https://docs.newstore.net/api/configuration/checkout/item_return_config#operation/ReplaceConfiguration) method.
2. Specify `refund_shipping_cost` to `true`.

**Related topics**

- [Configuring payment providers](/v1/docs/configuring-payment-providers)
- [Configuring refund options](/v1/docs/configuring-refund-options)
- [About payments](/v1/docs/about-payments)
- [Using NewStore Associate App](/v1/docs/using-newstore-associate-app)

## Related

- [Configuring payment providers](/configuring-payment-providers.md)