Building a Custom Upsell After Sequence
Normally when you execute the checkout handoff call you are handing off the browser into the tail end of the regular UltraCart checkout sequence. If you have any upsell afters configured inside of UltraCart then those will be displayed to the customer, then the in progress screen, and finally the receipt.
If for some reason you need to create custom upsell after pages on your own checkout it is easy to do. When the customer clicks your finalize order button then send them to your own upsell after page insead of doing a checkout handoff. When the upsell page loads, make sure to call the setFinalizeAfter method when the page loads. This will start the timer. If the customer accepts your upsell then add the new item to the cart and recalculate their shipping. You can chain together as many upsell after pages on your own site as you would like, but make sure that each time the page loads you call the setFinalizeAfter timer to reset it. We would recommend 45 minutes as your minute parameter on the method call. When you get to the end of your own custom upsells, then execute the checkoutHandoff call like you normally would.