> 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/getting-started/get-started-with-esw/faqs.md).

# FAQs

Some frequently asked questions.

<details>

<summary>What is GoCasual?</summary>

GoCasual is ESW’s test tenant. Use it to test before your production tenant is ready.

</details>

<details>

<summary>When do GoCasual credentials expire, and how do I renew them?</summary>

GoCasual credentials expire annually.

To request new credentials, submit a request on the ESW integration form: <https://www.eshopworld.com/integration/>

</details>

<details>

<summary>Can I store the ESW Checkout redirect URL and reuse it if the shopper returns?</summary>

Do not store and reuse the redirect URL.

Create a new Checkout session when the cart changes. Each PreOrder request represents a snapshot of the cart at that time. If the cart changes, a previously generated redirect URL may not show the latest items.

</details>

<details>

<summary>How do you handle “orphan orders” when shoppers restart checkout?</summary>

Each time a shopper starts checkout, ESW creates a **PreOrder**.

A PreOrder becomes an **Order** only after payment succeeds. Unpaid PreOrders do not convert into Orders.

</details>

<details>

<summary>If there is a shipping discount, will there be a promo/voucher code in the request?</summary>

The promo/voucher field is optional.

Send a promo/voucher code only when the shopper enters one. Whether it displays at Checkout depends on your Checkout display configuration.

</details>

<details>

<summary>Can I use <code>customerID</code> as <code>registeredProfileID</code>?</summary>

Yes. If you do not have a separate registered profile identifier, you can reuse `customerID`.

</details>

<details>

<summary>Why do I receive “Unauthorized token for tenant code”?</summary>

This error often returns `403 Forbidden` or `401 Unauthorized`. It has two primary causes:

* **Missing claim:** The access token does not contain the `TenantCode` claim.
* **Mismatched claim:** The token’s `TenantCode` does not match the tenant code in the request path. For `/ACP/GOCAS/orders`, use `TenantCode: GOCAS`.

Set [`client_id`](/getting-started/get-started-with-esw/readme/publish-your-docs.md#scopes) to `{TENANT_CODE}.client`. Explicitly assign the `TenantCode` claim to the client in the STS configuration.

</details>


---

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developer.esw.com/getting-started/get-started-with-esw/faqs.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.