Fallback order flow
Last modified:
If the payment plugin doesn’t support upsells, or the customer has paid with a payment method that doesn’t allow the order to be updated, you can enable the product upsell fallback flow. The same applies if an error occurs when the upsell is added to the order.
With the fallback flow, a new order is created for the added products, which the customer then pays for separately.
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.