> 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/callback-api/callback-api/overview.md).

# Overview

Use the ESW Light Touch Integration Callback API to connect your storefront to ESW with fewer custom steps. It streamlines common flows such as pre-order, checkout, and order confirmation. This reduces integration effort and speeds up go-live.

<table data-view="cards"><thead><tr><th>Feature</th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden>Description</th><th data-hidden data-card-cover-dark data-type="image">Cover image (dark)</th></tr></thead><tbody><tr><td>Country Selector</td><td data-object-fit="cover"><a href="/files/BMmGE9FVwEzh8Ng190dz">/files/BMmGE9FVwEzh8Ng190dz</a></td><td>Lets shoppers choose their market and shopping context.</td><td data-object-fit="cover"><a href="/files/KBOJ9enfyz5rExOBBFKW">/files/KBOJ9enfyz5rExOBBFKW</a></td></tr><tr><td>Dynamic Pricing</td><td><a href="/files/GUHt2vmduc5hbhle75SD">/files/GUHt2vmduc5hbhle75SD</a></td><td>Shows localized pricing based on shopper context.</td><td><a href="/files/oTjPCSCqsXauHkLBvxnJ">/files/oTjPCSCqsXauHkLBvxnJ</a></td></tr><tr><td>Fixed Pricing</td><td><a href="/files/jYdZ5WfsaK6OGmeQr2dn">/files/jYdZ5WfsaK6OGmeQr2dn</a></td><td>Supports fixed price display where that model is required.</td><td><a href="/files/jP1qZwAkJ1yGV2N28whN">/files/jP1qZwAkJ1yGV2N28whN</a></td></tr><tr><td>Checkout</td><td><a href="/files/rVo90YmJY4k8sGQAN6u4">/files/rVo90YmJY4k8sGQAN6u4</a></td><td>Supports shopper data handoff and stored cards in checkout.</td><td><a href="/files/XHXxKUGlsBI9gZ8AV4pT">/files/XHXxKUGlsBI9gZ8AV4pT</a></td></tr><tr><td>Returns integration</td><td><a href="/files/tLkFxnugpy4qwrERsigC">/files/tLkFxnugpy4qwrERsigC</a></td><td>Connects post-purchase returns flows with ESW services.</td><td><a href="/files/WQNwLaWiwBRIKOzbcguL">/files/WQNwLaWiwBRIKOzbcguL</a></td></tr><tr><td>Order status synchronization</td><td><a href="/files/0NrC4UI5b63X3YuAxFiK">/files/0NrC4UI5b63X3YuAxFiK</a></td><td>Keeps order updates aligned across connected systems.</td><td><a href="/files/rciYDVMdxjM7zSha9Lh6">/files/rciYDVMdxjM7zSha9Lh6</a></td></tr></tbody></table>

{% tabs %}
{% tab title="Key concepts" %}

* **Script:** Code that adds behavior to a web page or application.
* **Storefront:** The retailer’s site where shoppers browse and buy products.
* **Pre-Order (Checkout Call):** The request sent to ESW when a shopper starts checkout. It includes cart, shopper, and configuration data.
* **Order Confirmation:** The payload sent after a successful payment to confirm the order in downstream systems.
  {% endtab %}

{% tab title="What shoppers get" %}

### What shoppers get

After setup, shoppers can see localized pricing, use ESW checkout, and complete orders with a smoother experience.

They can also use saved payment methods where supported and benefit from synced order and returns flows.
{% endtab %}
{% endtabs %}

### Setup overview

Complete these steps in order:

{% stepper %}
{% step %}

### Store the cart identifier in cookies

Set a cookie that stores the cart reference used by ESW callbacks.

See [Storing A Cart Identifier In Cookies](/callback-api/callback-api/storing-a-cart-identifier-in-cookies.md).
{% endstep %}

{% step %}

### Enable fixed pricing support

Enable fixed pricing only if your integration requires it.

See [Enabling Fixed Pricing In Callback API](/callback-api/callback-api/enabling-fixed-pricing-in-callback-api.md).
{% endstep %}

{% step %}

### Implement the Callback API endpoints

Create the endpoints ESW uses to retrieve carts, confirm orders, and sync updates.

See [Implementing Callback API Endpoints](/callback-api/callback-api/implementing-callback-api-endpoints.md).
{% endstep %}

{% step %}

### Share the Callback API credentials with ESW

Provide the authentication details ESW needs for secure access to your endpoints.

See [Providing Callback API Endpoint Credentials To ESW](/callback-api/callback-api/providing-callback-api-endpoint-credentials-to-esw.md).
{% endstep %}

{% step %}

### Add the ESW JavaScript URL to your page headers

Add the onboarding script so your storefront can load ESW client behavior.

See [Adding JavaScript To Page Headers](/callback-api/callback-api/adding-javascript-to-page-headers.md).
{% endstep %}
{% endstepper %}

{% hint style="info" %}
For additional terms, refer to [glossary](/getting-started/get-started-with-esw/glossary.md).
{% 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/callback-api/callback-api/overview.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.
