Fallback order flow

In cases where the payment gateway does not support upsells, or when errors occur while applying an upsell offer, you can enable the product upsell fallback flow.

This flow allows the creation of a new order when the selected payment method cannot accept updates to an existing order.

Frontend

When the fallback flow is triggered, the customer is redirected to the payment page for the new order, which includes the additional products and any applicable discounts.

On this page, the customer is presented with:

• A message explaining that the original order could not be updated due to limitations imposed by the payment provider. For example:
  “Due to limitations from the payment provider your order 0001 could not be updated. You can instead add the following products as a new order, that will be combined with order 0001“
• Information about the original order
• A list of the additional products
• The payment method used for the original order (this cannot be changed).
• A Pay for additional products button

After this, the customer completes the checkout flow in the same way as for any other order.

Backend

In the WooCommerce Orders overview, a new Upsell column is added. This column indicates whether an order is an upsell order or a parent order linked to an upsell:

• Upsell for order #0001
• Parent order to Upsell #0002

Additionally, an order note is added to both orders:

• Parent order – A upsell order was created for this order with the upsell ID: xxxx. The upsell order is: #0002.
• Upsell order – This order was created for order #0001 to upsell the order with the upsell ID: xxxx.