Launchpad phase one: Gateway Failover
Protect subscription revenue from payment gateway outages. Learn how to configure automatic Gateway Failover in Recurly to seamlessly reroute live checkouts and queue recurring renewals using a backup payment gateway.
Launch · Launchpad Phase OneGateway Failover
Add a backup gateway so Recurly automatically reroutes payments if your primary provider goes down — no revenue lost to third-party outages.
Navigation Menu
Navigate Home
Gateway FailoverHow failover works
Gateway Failover automatically routes traffic to a backup gateway when your primary gateway experiences elevated communication errors. First-time signups are actively rerouted to the backup during an outage. Recurring renewals are paused and queued, then released to the primary once it recovers.
Gateway Failover is not available on Starter plans. If you're on a Starter plan, contact your CSM to discuss upgrading before completing this step.
Trail guide: Gateway Failover setup
~3 minConfigure Gateway Failover
Add a backup gateway
Confirm you have at least two gateways configured in Configuration → Payment Gateways. Both gateways should support the same currencies and card types. Recurly Docs: Multiple Gateway Configuration.
Enable failover monitoring
On the Payment Gateways page, locate the Gateway Failover panel in the right-hand sidebar. Click "Enable" to activate monitoring. Recurly Docs: Gateway Failover.
Set exclusions (optional)
If a gateway should never be used as a backup — for example, a currency-specific or specialty gateway — click Options → Edit Gateway and check "Exclude from Gateway Failover." Recurly Docs: Gateway Failover.
Gateway Failover checklist
Questions about Gateway Failover?
Our Customer Success team runs weekly Global Office Hours sessions where you can bring your real configuration questions — branding, plan structure, dunning setup, migration strategy, pricing model decisions. No agenda required.
Register for Office Hours →