> 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/technical-details.md). # Technical Details This page covers the technical details for [Returns Integration](/light-touch-integration/features/returns-integration.md). ### Required page elements To use returns integration, add three placeholder elements to the page where shoppers start the returns flow. ESW configures LTI with the CSS selectors for those elements. You must also provide the redirect URL for countries that use your retailer-managed returns flow. ### Elements LTI replaces At runtime, LTI replaces the configured placeholders with the returns UI components. #### Leading text This is optional helper text shown before the selector. Use it to prompt the shopper to choose a country or region. For example, `Select country or region`. #### Country dropdown This dropdown lists the countries available for returns. It can include both: * ESW-managed countries that route to the ESW Returns Portal * Custom countries that route to your own returns page #### Continue button This button starts the returns flow for the selected country. The destination depends on whether the shopper selected an ESW country or a custom country. ### Routing behavior When the shopper selects an ESW-managed country, the button redirects to the ESW Returns Portal. When the shopper selects a custom country, the button redirects to the retailer-managed returns URL configured for that country. ### Configuration notes * Add stable placeholder elements so LTI can target them reliably. * Share the exact CSS selectors with ESW during setup. * Provide the redirect URL for each country that should use your native returns experience. * Keep your ESW countries and custom countries aligned with the main LTI configuration. ### Order status visibility Returns integration does not automatically synchronize order statuses back to your commerce platform. You can view return and order status details in ESW Customer Service Portal and the ESW Returns Portal. If you need status synchronization in your own platform, subscribe to the supported status change events and update your system from those events. {% hint style="info" %} Returns routing depends on the selected country and your LTI country configuration. If the country setup is incomplete or out of sync, shoppers may be sent to the wrong returns flow. {% endhint %} --- # 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/technical-details.md?ask=&goal= ``` `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.