Discover seamless financial transactions with Recurly's Stripe integration, allowing easy account setup and ensuring continuity with Gateway Failover for a streamlined payment process that adapts to your business needs.


Required plan

This payment gateway or setting is available to all customers on any Recurly subscription plan.


  • Access to Recurly Payment Gateway Configuration page.
  • An active Stripe account (existing or newly created).
  • Consistency in currency and card type support when utilizing Gateway Failover.


  • Updates in the billing information on Recurly do not reflect automatically on Stripe customers.
  • Necessitates manual search for the most recent Stripe customer while processing payments directly inside of Stripe.


The integration of Stripe with Recurly facilitates a smooth pathway for managing your financial transactions. Whether you are a new user applying for a Stripe account or already hold one, the process is designed to be straightforward and efficient. It is essential to note that changes in billing information in Recurly accounts do not transfer automatically to Stripe, requiring manual updates for direct Stripe payments.

Note: Visit our guide on testing your gateway configurations in Recurly to ensure your payment processes are set up correctly-

Key details

Services that work with RecurlyPayment processing, including Gateway Failover support
Supported operationsAuthorize & Capture, Purchase, Recurring Billing, Refund, Void
Supported payment typesCredit/Debit Cards, Apple Pay, Google Pay
Supported card brandsVisa, MasterCard, American, Express, Discover, JCB, Diners Club, Union Pay
Gateway Specific 3DS2 SupportedYes
Card on File SupportedYes
RegionsGlobal, some APMs are not supported
CurrenciesMust match in both Stripe and Recurly when using Gateway Failover. See all available.

Authorization and capture

This gateway supports Recurly's authorization and capture feature, facilitating pre-authorization of funds and their subsequent capture. This process confirms fund availability before transaction completion, optimizing payment processing on the Recurly platform. For a detailed understanding of how this feature can benefit your transactions, we encourage you to visit our dedicated page on authorization and capture.

Integration with Stripe

Stepping into a seamless financial operation is easy with Recurly's Stripe integration. Begin your journey by navigating to the Recurly Payment Gateway Configuration page. Here, you can either log in using your existing Stripe account or initiate the process for a new account.

Understanding Stripe customer updates

Any Billing / Account Information updates made in your Recurly account are not automatically updated in your Stripe gateway. To update Billing or Account information, perform a manual check and update in Stripe directly, especially when you opt to execute payments directly through the Stripe platform. Always ensure to locate and select the most recently created Stripe customer for up-to-date transactions.

Integrate Stripe with Recurly


Step 1: Your Stripe Account

Ensure that you have an active Stripe account. If you don't have one, use this list to check that your business can process on the Stripe gateway. If your business is listed as a restricted or otherwise prohibited business type, you will not be able to use the Stripe gateway.

Step 2: Access Recurly payment gateway configuration page

Navigate to the Recurly Payment Gateway Configuration page.

Step 3: Choose Stripe as your payment gateway

On the Recurly Payment Gateway Configuration page, you'll find an option to select your preferred payment gateway. Choose "Stripe" from the list of available gateways.

Step 4: Log in to or Create your Stripe account

You will be prompted to log in to your Stripe account or you can enter your email and follow the prompts to set up a new Stripe account. Follow the prompts to complete this step.

Step 5: Configure your settings

After logging in to your Stripe account, you'll be redirected back to the Recurly platform where you can configure your payment settings according to your preferences and business requirements. This includes:

  • Excluding this instance from Gateway Failover
  • Setting up Alternative Payment Methods (Apple Pay or Google Pay)
  • Setting up currency preferences

Step 6: Review gateway failover settings

If you plan to use the Gateway Failover feature, review and ensure that the settings in both Stripe and Recurly match in terms of supported currencies and card types to facilitate seamless failover processes.

Step 7: Test the integration

Before going live, test the integration to ensure that everything is working correctly. Recurly offers a development environment where you can conduct test transactions to verify the setup.

Step 8: Go live

Once you have tested and confirmed that the integration works as expected, switch from sandbox to production environment to start processing real transactions.

Ongoing maintenance

Regular customer information updates

After integration, it's essential to regularly update your customers' billing information in Stripe. Changes made in Recurly do not automatically sync, so manual updates are necessary for each customer to ensure direct payments are processed correctly in Stripe.

Monitoring and maintenance

Keep a close eye on the performance and conduct regular checks to ensure smooth operations. Also, ensure to maintain the parity of the currency and card support settings in both Stripe and Recurly to avoid any disruptions in the payment processes.