Ability to set failed payment page

[marcorieser]

Right now, when a PreventCheckout exception is thrown, Cargo redirects to the checkout route.
https://github.com/duncanmcclean/statamic-cargo/blob/1.x/src/Http/Controllers/Payments/CheckoutController.php#L37-L39

In my case, I have a route for each checkout step, so redirecting to the start is a bad idea. I currently handle it in my routes, but it would be nice if there were a config value for a failed route endpoint.

My current solution:

Route::get('/checkout', function () {
    if (session('errors')?->any()) {
        return redirect()->temporarySignedRoute(
            route: 'checkout.failed',
            expiration: now()->addHour(),
            parameters: ['cart' => Cart::current()?->id()]
        );
    }

    return redirect()->route('checkout.information');
})->name('checkout');

[duncanmcclean]

The PreventCheckout exception is thrown for more than just payment failures — it's also thrown when no customer/address information is provided or one or more products in your cart is out-of-stock.

In those situations, I would have thought you'd want customers to go back to the checkout page, take some action, then try again. What's your use case? 🤔