Shopify lets you offer several payment methods, but only one provider captures cards, and if that provider declines or goes down the sale is gone. Merchants who have lost a processor once tend to want two. This page explains what Shopify can and cannot do here, and how a cascade routes each attempt across several gateways.
What it does not allow: two card processors, routing by card BIN or region, or retrying a declined card on another provider. A decline is final at the checkout.
Two, three or four gateway accounts wired behind one checkout, each with health checks and its own credentials.
Hard declines such as stolen card stop. Soft declines, timeouts, throttles and 3DS failures that a second acquirer could clear move on.
The retry happens server-side inside about 400 milliseconds. The buyer sees one spinner and one confirmation. The order lands in Shopify tagged with the route that captured.
Because the checkout is on your own domain, the card is tokenised once and each route is tried with that token; the buyer does not re-enter anything. Idempotency keys guarantee that no cart is charged twice across routes. Deeper detail on the cascade.
Each paid order arrives with its line items, buyer, shipping address, discount code and shipping method, plus tags such as [cascade] and [cascade:route-2]. Refunds go back through the route that captured. Reports, fulfilment apps and email flows keep working because the order is a normal Shopify order. What changes is only where the card was captured.
checkout.your-brand.com, the routes, health checks and order write-back.Growth plans include up to four routes; adding or swapping a route later is a configuration change, not a rebuild. Plans.
Only one card gateway at a time in Shopify's own checkout, alongside wallets and alternative methods. Two card processors with failover require an external checkout that routes between them.
No. Each cart carries an idempotency key across every route, and a route is only tried after the previous one returned a decline or timed out.
Median rotation is under 400 milliseconds, server-side, so the buyer sees a single loading state.
Any gateway with an API: NMI, Nuvei, Airwallex, Checkout.com, PXP, Adyen, Whop, regional acquirers, crypto rails and custom HTTP endpoints.
Live in 24-48 hours. Founder-answered support on WhatsApp.
Payment gateway cascade → · Payment orchestration → · Processors to pair → · How it works →
CascadeCheckout is checkout software, not a payment service provider, bank or merchant-account seller. You contract with your own gateway or acquirer, disclose your real business category to them, and receive payouts from them. We never hold funds and we do not promise that any processor will approve you.