> 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/agentic-commerce/esw-agentic-checkout.md).

# ESW Agentic Checkout

Enable secure, agent-led checkout through ESW.

ESW Agentic Checkout enables AI shopping agents to complete checkout through ESW. ESW manages the checkout service, payment integration, and shopper recovery flows.

ESW uses the Universal Commerce Protocol (UCP) to advertise supported commerce actions. ESW creates and hosts the required UCP profile for your domain.

### What you provide

Provide the account details ESW requests during onboarding. ESW manages the UCP manifest and payment-handler configuration.

{% hint style="danger" icon="display-slash" %}
Do not create or modify a separate UCP profile or payment handler.
{% endhint %}

<table data-view="cards"><thead><tr><th></th><th>Description</th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-cover-dark data-type="image">Cover image (dark)</th></tr></thead><tbody><tr><td>UCP profile setup</td><td>Understand ESW-managed UCP configuration and onboarding requirements.</td><td><a href="/agentic-commerce/esw-agentic-checkout/ucp-profile-setup.md">UCP Profile Setup</a></td><td><a href="https://3613318399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoNiYzXq5W9lF4B0fAZ9e%2Fuploads%2FKTgHMi6Rgl6fEZY9e5bI%2FPictogram-09.svg?alt=media&amp;token=ec8f6592-2ea5-4420-bacf-e0aa2e6e4b3f">Pictogram-09.svg</a></td><td><a href="https://3613318399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoNiYzXq5W9lF4B0fAZ9e%2Fuploads%2FBhCAD26ngkwXBUfbZB6d%2FPictogram-10.svg?alt=media&amp;token=ae47d30d-e22e-4069-9018-6b185ca7fb27">Pictogram-10.svg</a></td></tr><tr><td>Checkout, testing, and errors</td><td>Review payment handling, validation, testing, and error recovery.</td><td><a href="/agentic-commerce/esw-agentic-checkout/checkout-testing-and-errors.md">Checkout, Testing, and Errors</a></td><td><a href="https://3613318399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoNiYzXq5W9lF4B0fAZ9e%2Fuploads%2FDL1CKdzL2KgaeqSP3Xlr%2FPictogram-11.svg?alt=media&amp;token=89de511a-fa87-4794-9148-50f7d6d5a48d">Pictogram-11.svg</a></td><td><a href="https://3613318399-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoNiYzXq5W9lF4B0fAZ9e%2Fuploads%2FSPJiOddpOvV2tmDMDr9q%2FPictogram-12.svg?alt=media&amp;token=23e03f5d-129c-4fb4-ab84-24dd5775aca3">Pictogram-12.svg</a></td></tr></tbody></table>

### How it works

{% stepper %}
{% step %}

#### ESW configures your UCP profile

During onboarding, ESW creates the UCP profile and connects it to the ESW checkout API. ESW also configures the Adyen payment handler.
{% endstep %}

{% step %}

#### The AI agent starts checkout

The AI agent uses the UCP checkout service to submit the shopper's order details. ESW validates the request and keeps the checkout session connected to the shopper conversation.
{% endstep %}

{% step %}

#### ESW processes payment

Payment handlers supply a secure payment token. ESW maps the token to the session, authorizes payment, and returns the checkout outcome.
{% endstep %}

{% step %}

#### ESW supports recovery

The AI agent prompts shoppers to correct recoverable details. ESW handles service, catalog, authentication, and infrastructure issues behind the scenes.
{% endstep %}

{% step %}

#### ESW manages the order lifecycle

After checkout, ESW sends the shopper an order-confirmation email. The order follows the standard ESW lifecycle. The shopper receives updates at each stage through delivery.
{% 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/agentic-commerce/esw-agentic-checkout.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.
