Commerce Checkout Resume

Commerce Checkout Resume provides a /checkout-resume/{commerce_order_type} route that redirects users to the checkout of their most relevant cart of the requested order type. If no eligible cart is found, users are redirected to a configurable fallback page.

This makes it easy to let users resume a pending purchase through a link placed in a menu, button, or email.

The module redirects to the regular Commerce checkout for an existing cart. Access to that checkout is still controlled by Drupal Commerce.

Use cases

• A "Finish your purchase" banner shown to returning customers, linking to /checkout-resume/default so they land straight on the checkout of their pending cart.
• A "Complete your order" link in an email sent to customers who abandoned their cart.
• A menu item or button for a secondary order type, such as bookings, with its own cart alongside the main store.

Requirements

• Drupal 11.3 or later.
• Drupal Commerce 3.x, with the Cart (commerce_cart) and Checkout (commerce_checkout) modules enabled.

Installation

Install the module as you would any other contributed Drupal module, as described in the Drupal documentation.

composer require drupal/commerce_checkout_resume
drush pm:install commerce_checkout_resume

Configuration

Configuration is available at Commerce > Configuration > Orders > Resume checkout (/admin/commerce/config/checkout-resume). Access is restricted to users with the administer commerce_checkout_flow permission.

• Cart selection criterion: which cart is selected when the user has multiple carts of the requested order type. Most recently created (default) or Most recently updated.
• Fallback URL: the internal path users are redirected to when no eligible cart is found. Defaults to /cart. External and protocol-relative URLs are rejected.
• Fallback message: an optional status message displayed after redirecting to the fallback URL.

Usage

Link to /checkout-resume/{commerce_order_type}, where {commerce_order_type} is the machine name of an existing order type. For example, /checkout-resume/default redirects users to the checkout of their pending cart of the default order type. Access requires the access checkout permission.

Cart selection

A cart is only selected if it is a non-empty draft cart of the requested order type and Drupal Commerce allows the current user to access its checkout. When several carts qualify, the configured criterion decides which one is used.

Looking for Drupal support?

Premium support from the project maintainers

Get in touch with us