Get Ready for the Future! Download the State of Checkout 2025 White Paper Today
Platform

Product & Solutions

Learn more about the only open payments platform built for global commerce

Pricing

Solutions

Open Payments Connectivity
Payment Token Ownership & Portability
Intelligent Payment Optimization
Fraud Prevention & Authentication
Operational Agility & Simplicity
Centralized Management & Reporting

Platform Pillars

Connect

The unified orchestration layer for wallets and alternative payments

Vault

The secure repository for all your payment methods

Optimize

Workflow-driven payments intelligence for smarter routing and higher auth rates

Protect

A flexible fraud and authentication layer. Instantly add advanced fraud tools and 3DS

Agentic

One integration to sell inside ChatGPT, Gemini, and every agentic platform

Composer

Coming soon

View How Spreedly

Connects to your favorite payment methods
Optimizes your revenue
Protects your data
Reduces fraud
View the Demo
Resources

The Open Payments Library

Take a look at all of our resources and get the information you need to grow your business

View all Resources

Featured resources

The Payments Guide to Expansion into LATAM
Accelerate Your Growth by Expanding into Brazil
Security, Compliance, and AI: Inside Spreedly’s 2025 Foundation:

Spreedly Makes Agentic Commerce a Live Channel for Merchants

Read More
Company

Support Portal

Spreedly Support
Trust Center
Platform Status

Developer Portal

Developer Guides
Documentation
Parter Integrations

Partners & Integrations

Integrations Ecosystem
Our Partners

Latest Partner News

Paysafe Unveils Strategic Partnership with Spreedly

Featured Partner

PayPal
Product & Solutions

Product & Solutions

Learn more about the only open payments platform built for global commerce

Pricing

Solutions

Open Payments Connectivity
Payment Token Ownership & Portability
Intelligent Payment Optimization
Fraud Prevention & Authentication
Operational Agility & Simplicity
Centralized Management & Reporting

Platform Pillars

Connect

The unified orchestration layer for wallets and alternative payments

Vault

The secure repository for all your payment methods

Optimize

Workflow-driven payments intelligence for smarter routing and higher auth rates

Protect

A flexible fraud and authentication layer. Instantly add advanced fraud tools and 3DS

Agentic

One integration to sell inside ChatGPT, Gemini, and every agentic platform

Composer

Coming soon

View How Spreedly

Connects to your favorite payment methods
Optimizes your revenue
Protects your data
Reduces fraud
View the Demo
Pricing
Resources

The Open Payments Library

Take a look at all of our resources and get the information you need to grow your business

View all Resources

Featured resources

The Payments Guide to Expansion into LATAM
Accelerate Your Growth by Expanding into Brazil
Security, Compliance, and AI: Inside Spreedly’s 2025 Foundation:

Spreedly Makes Agentic Commerce a Live Channel for Merchants

Read More
Developers

Support Portal

Spreedly Support
Trust Center
Platform Status

Developer Portal

Developer Guides
Documentation
Integrations

Partners & Integrations

Integrations Ecosystem
Our Partners

Latest Partner News

Paysafe Unveils Strategic Partnership with Spreedly

Featured Partner

PayPal
Company

Company

About
Leadership
Careers
Contact Us
News
Pricing
Log In
See a Demo
Log In
See a Demo

Product & Solutions

Learn more about the only open payments platform built for global commerce

Pricing

Solutions

Open Payments Connectivity
Payment Token Ownership & Portability
Intelligent Payment Optimization
Fraud Prevention & Authentication
Operational Agility & Simplicity
Centralized Management & Reporting

Platform Pillars

Connect

The unified orchestration layer for wallets and alternative payments

Vault

The secure repository for all your payment methods

Optimize

Workflow-driven payments intelligence for smarter routing and higher auth rates

Protect

A flexible fraud and authentication layer. Instantly add advanced fraud tools and 3DS

Agentic

One integration to sell inside ChatGPT, Gemini, and every agentic platform

Composer

Coming soon

View How Spreedly

Connects to your favorite payment methods
Optimizes your revenue
Protects your data
Reduces fraud
View the Demo
Platform

Product & Solutions

Learn more about the only open payments platform built for global commerce

Pricing

Solutions

Open Payments Connectivity
Payment Token Ownership & Portability
Intelligent Payment Optimization
Fraud Prevention & Authentication
Operational Agility & Simplicity
Centralized Management & Reporting

Platform Pillars

Connect

The unified orchestration layer for wallets and alternative payments

Vault

The secure repository for all your payment methods

Optimize

Workflow-driven payments intelligence for smarter routing and higher auth rates

Protect

A flexible fraud and authentication layer. Instantly add advanced fraud tools and 3DS

Agentic

One integration to sell inside ChatGPT, Gemini, and every agentic platform

Composer

Coming soon

View How Spreedly

Connects to your favorite payment methods
Optimizes your revenue
Protects your data
Reduces fraud
View the Demo
Use Cases
Resources

The Open Payments Library

Take a look at all of our resources and get the information you need to grow your business

View all Resources

Featured resources

The Payments Guide to Expansion into LATAM
Accelerate Your Growth by Expanding into Brazil
Security, Compliance, and AI: Inside Spreedly’s 2025 Foundation:

Spreedly Makes Agentic Commerce a Live Channel for Merchants

Read More
Company

Support Portal

Spreedly Support
Trust Center
Platform Status

Developer Portal

Developer Guides
Documentation
Blog
Platform

Product & Solutions

Learn more about the only open payments platform built for global commerce

Pricing

Solutions

Open Payments Connectivity
Payment Token Ownership & Portability
Intelligent Payment Optimization
Fraud Prevention & Authentication
Operational Agility & Simplicity
Centralized Management & Reporting

Platform Pillars

Connect

The unified orchestration layer for wallets and alternative payments

Vault

The secure repository for all your payment methods

Optimize

Workflow-driven payments intelligence for smarter routing and higher auth rates

Protect

A flexible fraud and authentication layer. Instantly add advanced fraud tools and 3DS

Agentic

One integration to sell inside ChatGPT, Gemini, and every agentic platform

Composer

Coming soon

View How Spreedly

Connects to your favorite payment methods
Optimizes your revenue
Protects your data
Reduces fraud
View the Demo
Use Cases
Resources

The Open Payments Library

Take a look at all of our resources and get the information you need to grow your business

View all Resources

Featured resources

The Payments Guide to Expansion into LATAM
Accelerate Your Growth by Expanding into Brazil
Security, Compliance, and AI: Inside Spreedly’s 2025 Foundation:

Spreedly Makes Agentic Commerce a Live Channel for Merchants

Read More
Company

Support Portal

Spreedly Support
Trust Center
Platform Status

Developer Portal

Developer Guides
Documentation
Blog
Log In
See Demo

Product & Solutions

Learn more about the only open payments platform built for global commerce

Pricing

Solutions

Open Payments Connectivity
Payment Token Ownership & Portability
Intelligent Payment Optimization
Fraud Prevention & Authentication
Operational Agility & Simplicity
Centralized Management & Reporting

Platform Pillars

Connect

The unified orchestration layer for wallets and alternative payments

Vault

The secure repository for all your payment methods

Optimize

Workflow-driven payments intelligence for smarter routing and higher auth rates

Protect

A flexible fraud and authentication layer. Instantly add advanced fraud tools and 3DS

Agentic

One integration to sell inside ChatGPT, Gemini, and every agentic platform

Composer

Coming soon

View How Spreedly

Connects to your favorite payment methods
Optimizes your revenue
Protects your data
Reduces fraud
View the Demo
Glossary
October 16, 2026

Waterfall Routing

Waterfall routing is a sequential routing strategy in which a payment transaction is attempted on a series of gateways or processors in a predefined order, the "waterfall", until either an authorization succeeds or the sequence is exhausted. If the first gateway declines or fails, the transaction flows to the second; if the second fails, it flows to the third, and so on down the waterfall.

Waterfall routing is closely related to Decline Salvage / Cascading and is sometimes used synonymously. The conceptual distinction is one of design intent: a waterfall is a fully predefined sequence through which transactions flow regardless of performance data, while Dynamic Routing selects the optimal provider for each transaction in real time based on current performance. In practice, most sophisticated routing implementations combine elements of both, a dynamic primary selection followed by a waterfall of fallback options if the primary fails.

Waterfall routing is most commonly used in high-stakes payment contexts where authorization is critical and no transaction should be abandoned without exhausting available options: high-value B2B payments, large subscription renewals, or any scenario where the cost of a failed transaction significantly outweighs the cost of attempting multiple providers. Travel merchants, where a booking failure is immediately costly, are a common use case.

The primary risk of waterfall routing is over-retry. A waterfall that cascades Hard Declines through multiple providers generates unnecessary authorization attempts that may trigger fraud signals, waste processing fees, and produce no incremental authorization. Waterfall logic should be configured to bypass the cascade for hard decline codes and limit the sequence to genuine soft declines and processor-level failures.

Frequently Asked Questions

When should a merchant use waterfall routing versus dynamic routing?

Dynamic Routing is generally the more powerful approach for merchants with good performance data on their gateways, it selects the optimal provider proactively rather than reactively. Waterfall routing is most appropriate as a fallback mechanism within a dynamic routing strategy: dynamic logic selects the primary provider, and the waterfall handles failures if the primary does not succeed.

How many steps should a waterfall sequence have?

Two to three steps is the practical range for most merchants. A two-step waterfall (primary gateway and one fallback) covers the most common failure scenarios with minimal risk of over-retry. A three-step waterfall adds one additional recovery option for genuinely difficult-to-authorize transactions.

Is waterfall routing compatible with subscription billing?

Yes, and it is particularly valuable for subscription billing. Subscription payment failures from soft declines, temporary issuer-side issues, insufficient funds that may be resolved shortly, or processor routing problems, are precisely the type of failure that waterfall routing can address.

Related Terms

No items found.

Insights and updates you actually care about

Get practical, actionable insights written by experts from the world of digital payment solutions delivered to your Inbox.

By subscribing, you agree to our Privacy Policy and Terms.

Find Us On

Company
  • Pricing
  • About
  • Careers
  • Contact Us
  • Partners
Resources
  • Support
  • Blog
  • Guides
  • News
  • Webinars
  • Trust Center
Developers
  • Developer Guides
  • Documentation
  • See Demo
  • Status

Find Us On

Privacy SettingsTermsPrivacyStatus
© 2026 Spreedly, Inc. All rights reserved.