> For the complete documentation index, see [llms.txt](https://developer.esw.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.esw.com/light-touch-integration/features/returns-integration.md).

# Returns Integration

ESW Light Touch Integration (LTI) can connect your storefront to returns flows for both ESW countries and custom countries. This lets shoppers start the right returns journey from your site.

### Supported LTI platforms

<table data-view="cards"><thead><tr><th>Platform</th><th>Description</th></tr></thead><tbody><tr><td>BigCommerce</td><td>Supports returns integration through the standard LTI integration path.</td></tr><tr><td>WooCommerce</td><td>Supports returns integration through the standard LTI integration path.</td></tr><tr><td>Commerce Tools</td><td>Supports returns integration through the standard LTI integration path.</td></tr><tr><td>Web Platform</td><td>Supports returns integration through the LTI web integration path.</td></tr><tr><td>Callback API</td><td>Supports returns integration through the custom LTI integration path.</td></tr></tbody></table>

### How returns integration works

{% stepper %}
{% step %}

#### Add the returns selector

LTI adds a dropdown to the configured page on your website so shoppers can select the shipping country for the order they want to return.
{% endstep %}

{% step %}

#### Add the returns action

A button on that page starts the return flow after the shopper selects the country.
{% endstep %}

{% step %}

#### Route ESW countries to ESW Returns Portal

If the selected country is an ESW country, the button redirects the shopper to the ESW Returns Portal. There, the shopper can start a partial or full return using ESW returns functionality.
{% endstep %}

{% step %}

#### Route custom countries to your returns page

If the selected country is a custom country, the button redirects the shopper to the returns page you manage. ESW does not manage returns for those countries.
{% endstep %}
{% endstepper %}

ESW countries and custom countries can both appear in the selector. The selected country determines which returns experience the shopper sees.

### Returns prohibitions

Returns prohibitions let you mark specific products as non-returnable in your product catalog. This gives you more control over which items can enter the returns flow.

{% hint style="info" %}
This feature is available only on **Callback API** and only when **LTI checkout integration** is enabled. It does not apply when checkout is integrated directly through the API.
{% endhint %}

### How returns prohibitions work

{% stepper %}
{% step %}

#### Mark non-returnable products

Set the `IsReturnProhibited` attribute in your e-commerce product listings to indicate whether a product can be returned.
{% endstep %}

{% step %}

#### Pass the attribute to checkout

During checkout, LTI includes the `IsReturnProhibited` value for each product in the PreOrder data.
{% endstep %}

{% step %}

#### Enforce the rule

Checkout uses that attribute to prevent returns for products marked as non-returnable.
{% endstep %}

{% step %}

#### Apply the default behavior

If `IsReturnProhibited` is not set, the product is treated as returnable by default.
{% endstep %}
{% endstepper %}


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developer.esw.com/light-touch-integration/features/returns-integration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
