> 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/global-checkout/domain-masking.md).
# Domain Masking
## What is domain masking?
By using ESW’s Domain Masking feature, you can hide ESW-specific domain URLs and apply a specific domain-name URL of your choice at the checkout.
A checkout URL is generated in response via ESW Checkout API, once a request is sent. The shoppers are then redirected to this URL. This URL contains ESW domain in the following format: xxx.esw\.com. This is a negative user experience for the shoppers as they visibly see themselves being redirected to a third party. Hence, we mask this domain with a domain name of your choice. For example, we can mask it in the following format: pay.retailername.com.
## Process Flow
The following process outlines how a shopper is redirected to ESW checkout with a redirect URL:
1. Once a request is made to ESW ESW Checkout API, the API responds with a parameter `redirectUrl`.
2. This URL is used to redirect the shoppers to ESW Checkout.
3. Once the shoppers are redirected to the checkout, they enter the required information.
4. The shoppers then perform a payment transaction.
5. After the shoppers successfully perform a payment transaction, their order gets placed.
This `redirectUrl` is the URL that can be masked as per your requirement.
## Response Examples
### Before Domain Masking
The response of the Checkout API before masking the domain:
The `redirectUrl` contains xxx.eshopworld.com. ESW allows you to change the URL to an endpoint agreed by yourself. For example, you can change it to pay.gocasual.com.
GoCasual is ESW’s internal testing tenant.
### After Domain Masking
The response of the Checkout API after masking the domain:
Where xxx is your website's domain. For example, where gocasualis a domain.
The shoppers will be able to see this `redirectUrl` on their browser in the following way:
## Domain Masking Configuration
The following steps outline how you can mask your domain:
1. Agree with ESW on what subdomain you wish to use. For example, pay.gocasual.com.
2. Once agreed, ESW will initiate the setup and provide you with a CNAME.
3. You will create a new CNAME record for your chosen subdomain in your DNS.
4. Once this is propagated, ESW will finalize the setup.
You will then be ready with your masked domain.
{% hint style="info" %}
For any further information, get in touch with your point of contact at ESW.
{% 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/global-checkout/domain-masking.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.
