You are browsing the documentation for version 1.6 of OroCommerce, OroCRM and OroPlatform, which is no longer maintained. Read version 5.1 (the latest LTS version) of the Oro documentation to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Single Page Checkout Workflow


In your Oro application, you can control the way the checkout is displayed to customers in the storefront. By default, each checkout step is displayed on a new page. However, by activating the Single Page Checkout workflow in the back-office, you can make all steps fit one page. This will make the checkout process easier and quicker for customers, since they will be able to see how far along in the checkout they are, and how many fields are left to complete it.


To reach the Single Page Checkout workflow:

  1. Navigate to System > Workflows in the main menu.

  2. Click Single Page Checkout to open the flow.


Within the list of workflows, you can perform the following actions for the Single Page Checkout workflow:

  • View the workflow:

  • Activate the workflow:



If the workflow is active, you will be able to deactivate it from the list page by clicking .

On the the Single Page Checkout workflow page, you can perform the following actions:

  • Activate — Click Activate on the top right of the page to activate the workflow.

  • Deactivate (if the workflow is active) – click Deactivate on the top right of the page to deactivate the workflow.


For more information on how to manage workflows, see the Workflow Management topic.

Steps and Transitions

The Single Page Checkout workflow consists of the following steps and transitions:

  1. Steps:
    • Start
    • Checkout
    • Order Created
  2. Transitions:
    • For Start: Start Checkout (System), Start Checkout From Shopping List, Start Checkout from Quick Order Form.
    • For Checkout: Save State, Submit Order, Finish Checkout, Payment Error.

Sample Flow

As an illustration let us go through the sample flow to see the Single Page Checkout workflow in action:

  1. A customer adds an item to the shopping list in the storefront, and clicks Create Order to proceed to the checkout.

  2. The following sections (steps) are displayed on one page:

    • Billing Information
    • Shipping Information
    • Order Summary
  3. In the Billing Information section, the customer provides his address and selects a payment method.

  4. In the Shopping Information section, the customer:

    • Provides shipping and billing addresses.
    • Selects a shipping method.
    • Sets the Do Not Ship Later Than date.
  5. In the Order Summary section, the customer:

    • Reviews the order by checking items, SKUs, item quantity, price and the subtotal amount.
    • Checks order options.
    • Selects whether the shopping list should be deleted after submitting the order, or saved.
  6. The customer submits the order by clicking Submit Order on the top left of the page.

  7. The customer receives an email confirmation with order details.