Configuring steps of the checkout process

To allow your customers to purchase products in your on-line store, you need to configure the checkout process.

To create the checkout process, use only the Portal Engine. ASPX templates are not supported.

To configure the checkout process on your website:

  1. Set up the checkout wizard.
  2. Add the checkout steps.
  3. Configure the payment page.
  4. Configure the thank you page.
  5. Configure the checkout process settings.

To configure navigation between steps, see Building step navigation on the Creating wizards on websites page.

Step navigation in the checkout process

See example checkout processes on theE-commerce siteandDancing Goatsample sites.

Setting up the checkout wizard

If you create the checkout process, you can either use the predefined Checkout wizard and Checkout step page types from any of the e-commerce sample sites, or create your own Checkout wizard and Checkout step page types from scratch (see Creating wizards on websites).

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.

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 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.

  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.

      If an error appeared that you cannot create any page in the checkout process, you need to create the Checkout step page type first.

      If you installed any of the e-commerce sample sites, you can use also the predefined Checkout step page type. See the 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.

    To learn about the web parts that you can use when configuring the checkout process, see:

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.

To prevent the customers from updating previously entered data (typically in multi-step checkout processes), 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

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

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).

You do not need to create the payment page if all your payment methods are manual. In such case, you can skip creating the payment page and go directly to configuring the thank you page.

To create the payment page:

  1. Open the Pages application.

  2. Create a regular page outside the checkout process.
    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) or redirects the customer to a payment gateway (e.g., when using PayPal or credit card 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.

    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. The order is already created and you only indicate that the process was successful.

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 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

To create the thank you page:

  1. Open the Pages application.

  2. Create a regular page 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.

        You can use relative addresses, for example “~/Special-Pages/Thank-You”.

        If you use PayPal, you need to set the thank you page also in the PayPal settings 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.

        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).

    If you are not sure what to choose, see Choosing site or global e-commerce configuration. If you are not sure about specifics of configuring in these applications, see Configuring e-commerce settings for a specific site or globally.

  2. On the Store settings -> General tab, configure theShopping cart URLfield:

    1. If you work in the Store configuration application, clear the Inherit from global settings field.

    2. Type the URL of the shopping cart.

      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.
  3. Configure theRedirect to shopping cartfield:

  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.