---
source_url: "https://docs.recurly.com/recurly-subscriptions/docs/gateway-configuration"
title: Multiple gateway configuration
mirrored_at: 2026-08-10T01:01:43.403Z
host: docs.recurly.com
cited_in_42a: true
mirror_canonical: "https://index.42a.ai/docs.recurly.com/recurly-subscriptions/docs/gateway-configuration"
---

> **Original source:** https://docs.recurly.com/recurly-subscriptions/docs/gateway-configuration

Configure multiple payment gateways in Recurly to support diverse currencies, card types, and payment methods — with gateway hierarchy, default settings, and failover.

Multiple gateway configuration lets you connect several payment gateways to your Recurly account to support different currencies, card types, and payment methods — with control over routing hierarchy, default gateways, and failover behavior.

Available on all Recurly plans

-   An active Recurly account.
-   Access to the gateway providers you want to connect.
-   An understanding of your business's transaction routing needs.

-   By default, transactions route to the first gateway added that supports the transaction's currency and card type — unless custom routing or default settings are configured.
-   The gateway hierarchy must be correctly understood and configured to ensure transactions process as intended.

Multiple gateway configuration lets Recurly merchants connect several payment gateways to accept diverse payment types, process transactions in multiple currencies, and maintain a backup gateway in case a primary gateway experiences downtime.

**Broad payment support** Support a wide range of payment methods and currencies across multiple gateway providers.

**Optimized transaction routing** Prioritize which gateway processes specific transactions based on card type, currency, or custom rules.

**Business continuity** Gateway Failover automatically reroutes payments to a secondary gateway if the primary becomes unavailable.

**Custom routing** Define gateway use based on your business logic using Custom Gateway Routing.

**Centralized management** View and manage all gateway configurations from a single dashboard.

Recurly supports multiple gateway configurations to cover a range of currencies, card types, and payment methods — including credit cards, external gateway tokens, Amazon Pay, PayPal, Apple Pay, ACH, and more.

When multiple gateways are configured, Recurly routes transactions to the first gateway on the list that supports the transaction's card type and currency. Beyond this default, Recurly applies the following routing hierarchy:

1.  Transactions with a gateway token (e.g., Vantiv tokens, Braintree tokens)
2.  Transactions referencing a `gateway_code` (Custom Gateway Routing)
3.  Non-credit card transactions (PayPal, Amazon Pay, Adyen HPP, etc.)
4.  The default gateway for credit card transactions
5.  The non-default credit card gateway, prioritizing the one added earliest

For precise control over which gateway handles a transaction, use Recurly's [Custom Gateway Routing](https://docs.recurly.com/docs/custom-gateway-routing-configuration).

You can set a default gateway for credit card transactions. The default gateway takes precedence when it's compatible with the transaction's card type and currency and no specific `gateway_code` has been assigned via Custom Gateway Routing.

[Gateway Failover](https://docs.recurly.com/docs/gateway-failover) automatically reroutes transactions to a secondary gateway if the primary becomes unavailable. When the primary gateway recovers, Recurly resumes routing new transactions to it.

1

In Recurly, go to **Configuration → Payment Gateways**.

2

Click **Payment Gateway Actions → Add Payment Gateway** and select your preferred provider from the table of brand icons.

3

Input the required credentials or API keys for the chosen provider, then confirm and save.

4

To add more gateways, repeat the process with different providers as needed.

1

In the **Payment Gateways** section, find **Default Gateways** in the sidebar.

2

Click **Edit Defaults**, assign a default gateway for each payment method in the window, then confirm and save.

1

In the **Payment Gateways** section, find **Gateway Failover** in the sidebar.

2

Toggle failover to **Enabled** or **Disabled** as needed. Note that setting specific Primary and Backup gateways via a dropdown is not available on this page.

**Tip** After configuration, run a few test transactions to confirm routing works as expected based on your hierarchy and default settings. Revisit and adjust settings at any time as your needs evolve.

  

Updated about 1 month ago

* * *

Did this page help you?

-   -   [Definition](#definition)
    -   [Key benefits](#key-benefits)
    -   [Key details](#key-details)
    -   -   [Gateway support](#gateway-support)
        -   [Gateway hierarchy](#gateway-hierarchy)
        -   [Custom gateway routing](#custom-gateway-routing)
        -   [Default gateway](#default-gateway)
        -   [Gateway failover](#gateway-failover)
    -   [Setting up multiple gateways](#setting-up-multiple-gateways)
    -   -   [Add a gateway](#add-a-gateway)
        -   [Set a default gateway](#set-a-default-gateway)
        -   [Enable gateway failover](#enable-gateway-failover)