---
title: Configuring steps of the checkout process
related:
  - https://docs.kentico.com/k9/developing-websites/loading-and-displaying-data-on-websites/displaying-data-advanced-scenarios/creating-wizards-on-websites.md
  - https://docs.kentico.com/k9/custom-development/developing-web-parts/advanced-web-part-development-scenarios/connecting-web-parts-with-the-page-wizard.md
  - https://docs.kentico.com/k9/e-commerce-features/managing-your-store/customers.md
  - https://docs.kentico.com/k9/e-commerce-features/managing-your-store/orders.md
  - https://docs.kentico.com/k9/on-line-marketing-features/marketing-automation/walkthrough-sending-an-automated-reminder-of-an-abandoned-shopping-cart.md
---

> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).

To allow your [customers](https://docs.kentico.com/k9/e-commerce-features/managing-your-store/customers.md) to purchase [products](https://docs.kentico.com/k9/e-commerce-features/managing-your-store/products.md) in your on-line store, you need to configure the [checkout process](https://docs.kentico.com/k9/e-commerce-features/configuring-your-store/checkout-process.md).

> **Info:** To create the checkout process, use only the [Portal engine](https://docs.kentico.com/k9/developing-websites/developing-websites-using-the-portal-engine.md). The [ASPX templates](https://docs.kentico.com/k9/developing-websites/developing-websites-using-aspx-templates.md) are not supported as well as if you use [Portal engine sections](https://docs.kentico.com/k9/developing-websites/developing-websites-using-aspx-templates/adding-portal-engine-functionality-to-aspx-page-templates.md) on pages based on the ASPX templates.

To configure the checkout process on your website:

1. [Set up the checkout wizard.](#setting-up-the-checkout-wizard)
2. [Add the checkout steps.](#adding-the-checkout-steps)
3. [Configure the payment page.](#configuring-the-payment-page)
4. [Configure the thank you page.](#configuring-the-thank-you-page)
5. [Configure the checkout process settings.](#configuring-the-checkout-process-settings)

> **Tip:** To configure navigation between steps, see Building step navigation on the [Creating wizards on websites](https://docs.kentico.com/k9/developing-websites/loading-and-displaying-data-on-websites/displaying-data-advanced-scenarios/creating-wizards-on-websites.md) page.
>
> ![Step navigation in the checkout process](https://docs.kentico.com/docsassets/k9/configuring-steps-of-the-checkout-process/checkout_process_navigation.png "Step navigation in the checkout process")

> **Tip:** See example checkout processes on [theE-commerce siteandDancing Goatsample sites](https://docs.kentico.com/k9/e-commerce-features/configuring-your-store/installing-the-e-commerce-sample-sites.md).

## Setting up the checkout wizard

> **Info:** If you create the checkout process, you can either use the predefined **Checkout wizard** and **Checkout step** [page types](https://docs.kentico.com/k9/developing-websites/defining-website-content-structure/page-types.md) from any of [the e-commerce sample sites](https://docs.kentico.com/k9/e-commerce-features/configuring-your-store/installing-the-e-commerce-sample-sites.md), or create your own **Checkout wizard** and **Checkout step** page types from scratch (see [Creating wizards on websites](https://docs.kentico.com/k9/developing-websites/loading-and-displaying-data-on-websites/displaying-data-advanced-scenarios/creating-wizards-on-websites.md)).
>
> To be able to use the predefined page types, add the page types to your site:
>
> 1. Open the **Page types** application.
> 2. Edit () the **Checkout wizard** page type.
> 3. Switch to the **Site** tab.
> 4. Click **Add sites**.
> 5. Select your desired sites and click **Select**.
> 6. Repeat the steps with the **Checkout step** page type.
>
> Both the **Checkout wizard** and **Checkout step** page types are now available for you to use.

To set up a checkout process wizard on your website:

1. Open the **Pages** application.
2. Select a page under which you want to place the wizard page in the content tree.
3. Add a new page based on the **Checkout wizard** page type.
4. Type the **wizard name**.
5. Click **Save**.

The system adds the checkout wizard page containing a basic set of the required functional components; for example the _Page wizard manager_ web part, the _Page place holder_ web part, and the _Page wizard navigation_ web part. The wizard page serves as the "parent" of the checkout wizard and provides a master page for the content of the checkout process steps.

> **Note:** Check the settings of the **Checkout wizard** page type.
>
> - Make sure the **Restrict step order** field of the **Page wizard manager** web part is selected, forcing the customers to progress through the checkout steps in the defined order. For example, you want to prevent the customers from visiting the _Shipping_ page prior to specifying the shipping address.
> - Specify the **Final step URL** property of the **Page wizard manager** web part to redirect the customers to a selected URL, for example, to the payment gateway page. After the customer clicks the final "next" button (also "Finish", "Order now"), the system creates an order in the system and redirects the customers to the final step URL. See [Configuring the payment page](#configuring-the-payment-page) below for more information.

## Adding the checkout steps

To add the checkout wizard steps, add child pages under the checkout wizard page. Build the content of the steps just like any other [portal engine pages](https://docs.kentico.com/k9/developing-websites/developing-websites-using-the-portal-engine.md).

1. Open the **Pages** application.
2. Select the checkout wizard page in the content tree.
3. Click **New** ().

   - You have used the **Checkout wizard** page type to create the checkout wizard page. That is why the system now offers the dedicated **Checkout step** page type for the checkout steps.

     > **Info:** If an error appeared that you cannot create any page in the checkout process, you need to create the **Checkout step** [page type](https://docs.kentico.com/k9/developing-websites/defining-website-content-structure/page-types.md) first.
     >
     > If you installed any of [the e-commerce sample sites](https://docs.kentico.com/k9/e-commerce-features/configuring-your-store/installing-the-e-commerce-sample-sites.md), you can use also the predefined **Checkout step** page type. See the [Setting up the checkout wizard](#setting-up-the-checkout-wizard) section.
4. Select the **Checkout step** page type.
5. Type the **step name** of the checkout step.
6. Click **Save** to add the step.
7. Edit the step and its web parts to achieve the desired appearance.

   > **Tip:** See all web parts that you can use when configuring the checkout process in [Reference - Checkout process web parts](https://docs.kentico.com/k9/e-commerce-features/configuring-your-store/checkout-process/reference-checkout-process-web-parts.md).

   > **Info:** If data of two or more web parts relate to each other, i.e. if the content of a web part changes according to the content of another web part, and such web parts are on the same step, it is essential for the system to process the data immediately after its input. Typically, such situation happens in the one-step checkout process.
   >
   > Ensure this behavior by selecting the **Propagate changes on postback** field for web parts where available. Also, select the **AJAX -> Use update panel** field for the web part zone wrapping up the content of the checkout step. Make sure this field is cleared for all contained web parts, same as for all nested web part zones. For example, if you select the shipping option and the shipping address on the same step and the list of shipping options depends on the shipping country. Failing that, you may experience interference with the display and behavior of the page.
   >
   > If only one web part is dependent on its own data, you can select the **AJAX -> Use update panel**field only for the web part. For example, in case you want to display a drop-down list for selecting a state only when a country with states is selected in a country drop-down list.

   > **Tip:** To prevent the customers from updating previously entered data (typically in the multi-step checkout process), select the **Read only mode** field for selected web parts (if available).

The system adds the checkout step in the specific configuration.

![Checkout steps in basic configuration](https://docs.kentico.com/docsassets/k9/configuring-steps-of-the-checkout-process/checkout_steps_basic_configuration.png "Checkout steps in basic configuration")

> **Tip:** You can change the order of the steps by simply drag-and-dropping the desired step or using the **Move up** () and **Move down** () buttons.
>
> ![Changing the order of wizard steps](https://docs.kentico.com/docsassets/k9/configuring-steps-of-the-checkout-process/changing_order_of_steps.png "Changing the order of wizard steps")

## Configuring the payment page

The payment page is a page where your customers can pay their orders or be redirected to a third party payment gateway. Technically, the payment page is not a part of the checkout process in Kentico because the order is created by the end of the checkout process and then you can pay for the order. However, you can customize the checkout process so that you can enable payment during the checkout process (you need to create the order object earlier, during the checkout process).

> **Tip:** You do not need to create the payment page if all your [payment methods are manual](https://docs.kentico.com/k9/e-commerce-features/configuring-your-store/configuring-payment-methods.md). In such case, you can skip creating the payment page and go directly to [configuring the thank you page](#configuring-the-thank-you-page).

To create the payment page:

1. Open the **Pages** application.
2. [Create a regular page](https://docs.kentico.com/k9/developing-websites/developing-websites-using-the-portal-engine.md) outside the checkout process.

   ![The payment page outside the checkout process](https://docs.kentico.com/docsassets/k9/configuring-steps-of-the-checkout-process/payment_page_outside_checkout_process.png "The payment page outside the checkout process")
3. Put the **Payment form** web part on the page.
   - The **Payment form** web part displays ID of the order, the selected payment method, the total price of the order and a button that either pays the order (e.g., subtracts the [customer credit](https://docs.kentico.com/k9/e-commerce-features/configuring-your-store/configuring-payment-methods/configuring-customer-credit.md)) or redirects the customer to a payment gateway (e.g., when using [PayPal](https://docs.kentico.com/k9/e-commerce-features/configuring-your-store/configuring-payment-methods/configuring-paypal.md) or [credit card](https://docs.kentico.com/k9/e-commerce-features/configuring-your-store/configuring-payment-methods/configuring-authorize-net.md) payment).
4. Switch to the root page of the checkout process.
5. On the **Design** tab, edit the **Page wizard manager** web part.
6. In the **Content filter -> Final step URL** field, type the address of the payment page.

   > **Tip:** You can use relative addresses, for example "_\~/Special-Pages/Payment-Page_".
7. Click **Save & Close**.

Customers are now able to pay for their orders on the created payment page.

## Configuring the thank you page

The thank you page is a page where your customers are redirected after they pay (if there is a payment page) or redirected after creating the order (if there is not any payment page). Technically, the thank you page is not a part of the checkout process but directly follows up the checkout process and [the payment page](#configuring-the-payment-page). The order is already created and you only indicate that the process was successful.

> **Info:** If you do not want to inform your customers that the order has been successfully created or paid, you do not need to create any thank you page and you can only set [the checkout wizard](#setting-up-the-checkout-wizard) to redirect the customers to a different page. However, your on-line store is more user-friendly to your customers with a thank you page.
>
> ![The thank you page example](https://docs.kentico.com/docsassets/k9/configuring-steps-of-the-checkout-process/thank_you_page.png "The thank you page example")

To create the thank you page:

1. Open the **Pages** application.
2. [Create a regular page](https://docs.kentico.com/k9/developing-websites/developing-websites-using-the-portal-engine.md) outside the checkout process.

   - The thank you page does not require any specific setting.
3. Set the checkout process to redirect customers to the thank you page.
   - **If you have a payment page:**
     1. Switch to the payment page.
     2. On the **Design** tab, edit the **Payment form** web part.
     3. In the **General -> Thank you page URL** field, type the address of the thank you page.

        > **Tip:** You can use relative addresses, for example "_\~/Special-Pages/Thank-You_".

        > **Info:** If you use PayPal, you need to set the thank you page also in [the PayPal settings](https://docs.kentico.com/k9/configuring-kentico/managing-sites/configuring-settings-for-sites/settings-e-commerce/settings-paypal.md) in the **Settings** application.
     4. Click **Save & Close**.
   - **If you do not have any payment page:**
     1. Switch to the root page of the checkout process.
     2. On the **Design** tab, edit the **Page wizard manager** web part.
     3. In the **Content filter -> Final step URL** field, type the address of the thank you page.

        > **Tip:** You can use relative addresses, for example "_\~/Special-Pages/Thank-You_".
     4. Click **Save & Close**.

After paying the order (if the checkout process ends with a payment page) or creating an order (if the checkout process does not end with a payment page), the customers are redirected to the created thank you page.

## Configuring the checkout process settings

Affect behavior of the checkout process by setting up its settings:

1. Open the **Store configuration** application (if you want to set up the settings on the current site) or open the **Multistore configuration** application (if you want to set up the checkout process globally).

   > **Tip:** If you are not sure what to choose, see [Choosing site or global e-commerce configuration](https://docs.kentico.com/k9/e-commerce-features/configuring-your-store/choosing-site-or-global-e-commerce-configuration.md). If you are not sure about specifics of configuring in these applications, see [Configuring e-commerce settings for a specific site or globally](https://docs.kentico.com/k9/e-commerce-features/configuring-your-store/choosing-site-or-global-e-commerce-configuration/configuring-e-commerce-settings-for-a-specific-site-or-globally.md).

2. On the **Store settings -> General** tab, configure [theShopping cart URLfield](https://docs.kentico.com/k9/configuring-kentico/managing-sites/configuring-settings-for-sites/settings-e-commerce.md):
   1. If you work in the **Store configuration** application, clear the _Inherit from global settings_ field.
   2. Type the URL of the shopping cart.

      > **Tip:** Use the tilde character (~~) in the URL to create a relative address. For example: \*~~/Store/Shopping-cart\*

      - You can then retrieve the URL with the _{% Settings.CMSShoppingCartURL %}_ macro method. Learn more about displaying shopping cart preview on pages, where this macro can be especially useful, in [Displaying the shopping cart preview on pages](https://docs.kentico.com/k9/e-commerce-features/configuring-your-store/checkout-process/displaying-the-shopping-cart-preview-on-pages.md).

3. Configure [theRedirect to shopping cartfield](https://docs.kentico.com/k9/configuring-kentico/managing-sites/configuring-settings-for-sites/settings-e-commerce.md):

4. If you work in the **Store configuration** application, clear the _Inherit from global settings_ field.

5. Select the check-box to set that the system redirects the customer to the shopping cart page when they click **Add to shopping cart**. Clear the check-box to set that the customer stays on the same page, and the product is added to the shopping cart in the background.

6. Click **Save**.

The system saves the configuration.